范围方法getValues（）返回和setValues（）接受什么？

Question

我想从我的工作表中获得范围。如

const ss = Spreadsheet.getActive(),
  sh = ss.getSheetByName("Sheet1"),
  rg = sh.getRange("A1:C1"),//has 1,2,3
  values = rg.getValues();
console.log(values);

日志显示

[[1,2,3]]

，您可以看到我收到了所有三个元素。但是，当我记录数组的长度（ array.length ）时，它只是1（而不是3）。当我使用 .indexof 或 .concludes 测试元素的存在时，它说-1或 false 。

const values = /*same as logged above*/[[1,2,3]];
console.log(values.indexOf(2));//got -1 expected 1
console.log(values.includes(1));//got false expected true

为什么？

我对 setValues（）也有同样的问题。

rg.setValues([1,2,3]);//throws error

错误是

“参数（number []）不匹配电子表格app.range.setValues的方法签名。”

我的具体问题是： getValues（）返回到底是什么？这是一种特殊的数组吗？

Answer 1

文档摘录：

从官方文档 ）返回

二维值

始终返回a 两个尺寸值阵列

一维数组是

[1,2,3]

二维数组的数组中

[[1,2,3]]
//or
[[1], [2], [3]]

有/是数组中的数组。

由行索引，然后是列。

首先，它由行索引：IE，外部阵列的行作为内数阵列。然后每个内部阵列都有列元素。考虑以下简单电子表格：

	A	B	C
1＆GT;	1	2	3
2＆gt;	2	3	4
3＆gt;	3	4	5

a1：a3 包含3行，每行包含1列元素。这表示为 [[1]，[2]，[3]] 。同样，以下范围代表以下数组。尝试根据a1表示法猜测数组结构：

a1 列表	编号 列的行	号	array数组 结构	阵列数组 .length	Array [0] .length
A1 ：a3	3	1	[[1]，[2]，[3]，[3]	3	1
a1：c1	1	3	[[1,2,3]]	1	3
A1 ：b2	2	2	[[1,2]，[2,3]]	2	2
b1：c3	3	2	[[2,3]，[3,4]，[4，[4，[4，] 5]]	3	2
a2：c3	2	3	[[2,3,4]，[3,4,5]]	2 3	3

请注意二维如何提供方向。
请参阅下面的实时可视化：

/*<ignore>*/console.config({maximize:true,timeStamps:false,autoScroll:false});/*</ignore>*/
const test = {
  'A1:A3': [[1], [2], [3]],
  'A1:C1': [[1, 2, 3]],
  'A1:B2': [
    [1, 2],
    [2, 3],
  ],
  'B1:C3': [
    [2, 3],
    [3, 4],
    [4, 5],
  ],
  'A2:C3': [
    [2, 3, 4],
    [3, 4, 5],
  ],
};

Object.entries(test).forEach(([key, value]) => {
  console.log(`The range is ${key}`);
  console.table(value);
  console.info(`The above table's JavaScript array notation is ${JSON.stringify(value)}`)
  console.log(`=================================`);
});

<!-- https://meta.stackoverflow.com/a/375985/ -->    <script src="https://gh-canon.github.io/stack-snippet-console/console.min.js"></script>

根据单元格的值。

在上面的示例中，我们具有转换为JavaScript号码类型的电子表格编号类型元素。您可以使用 type（type（） ）。对应的JavaScript类型参考是在这里

空单元用数组中的一个空字符串表示。

检查使用

console.log(values[0][0]==="")//logs true if A1 is empty    

请记住，范围索引从1、1开始，而JavaScript数组则从[0] [0]。

索引。

给定二维数组结构，要访问一个值，需要两个格式 array [row] [column] 的索引。在上表中，如果检索 a2：c3 ，则访问 c3 ，请使用 values [1] [2] 。 [1] 是范围A2：C3的第二行。请注意，范围本身从第二行开始。因此，在中，第二行给定范围是行 3 [2] 是第三列 c 。

注意：

• 警告：

从一个范围内检索的值始终二维，无论范围高或宽度如何（即使仅1）。 getRange（“ a1”）。getValues（）将表示 [[1]

• setValues（）将接受与对应于该阵列相对应的相同数组结构范围设置。如果尝试使用一维数组，则错误

参数（number []/string []）不匹配电子表格Appapp.range.setValues的方法签名。

被扔了。

• 如果数组不完全对应于所设置的范围，即，如果内部数组的长度中的每个阵列都不对应于范围内的列数或外部阵列的长度与该范围内的行数不符被设置为类似以下错误的错误：

数据中的列数与范围内的列数不匹配。数据有5个，但范围为6。

• 与上述错误相关的答案：

  • https://stackoverflow.com/a/63770270

  < +列的+数字+列+in+the+range“>相关搜索

• /包括使用严格的类型检查。当您将原语与数组对象进行比较时，它们将无法使用。您可以使用

    const values = [[1,2,3]。
  console.log（values.indexof（2））; //预期1
  console.log（values.ixludes（1））; //预期true  

参考：

• 基本阅读
• MDN数组指南

Answer 2

如果您要填充将写入电子表格范围的数组，则可以将其初始化为2个昏暗数组，因此：

var dataTable = [[]] ;    // Data that will be written to sheet

Answer 3

我遇到了类似的问题，并且偶然发现了 flat（）方法，用于使[[1,2,3]]数组变平[1,2,3]。果然，不仅 flat（）以> getValues（）返回的对象的2个DIM数组，而且还将对象重新构成正确的数字和字符串！ huzzah！

表格数据的屏幕截图

这是我的测试脚本：

function listOflists (){
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Load data from the spreadsheet.
// display data array
var DeckID = spreadsheet.getRange("B2:B50").getValues();
Logger.log(DeckID); // [[2D array]]

// First attempt to filter out desired elements
var values = DeckID
var filteredValues = values.filter(isString);

  function isString(value) {
  Logger.log(value + " is an " + typeof value); // Everything is an object !
  return typeof value === "string"; // which renders this comparison useless
  }

Logger.log(filteredValues); // null result

// Revised attempt to filter out desired elements
// by first using the flat method on the 2D array
var values = DeckID.flat(); 
Logger.log(values); // [1D array]


var filteredValues = values.filter(isString);

  function isString(value) {
  Logger.log(value + " is an " + typeof value);
  return (typeof value === "string" && value !=""); // had to also check for empty array values, which are also strings
  }

Logger.log(filteredValues); // [only the string values from the worksheet]
}