readTable 函数

语法

• string[] readStringTable(filePath)
• float[] readFloatTable(filePath)

参数

1. filePath—string
   要读取的表文件的名称。 有关搜索位置的信息，请参阅资产搜索。 支持的扩展名为 .csv。

返回

采用 2D 数字形式的 filePath 的内容。

描述

readTable 函数用于将 CSV 文件 filePath 读取为 2D 数组。 系统会自动检测分隔符；通用分隔符（包括逗号、分号、制表符和空格）均适用。 支持的编码包括 ASCII、UTF-8 和 UTF-16。 无法打印的控制字符将替换为 '?'。 浮点型 readFloatTable 相当于 floatArray(readStringTable(....))，但会缓存转换表。

相关内容

• 数组类型运算符
• readTextFile 函数

示例

CGA 代码

file = "/general/assets/text/floorData.csv"
const table      = readStringTable(file)
const floatTable = readFloatTable(file)

CGARef-->
	print("Table (strings)")
	print(table)
	print("element at row 1, col 4: " + table[1, 4])
	print("Table (float)")
	print(floatTable)
	print("element at row 1, col 4: " + floatTable[1, 4])

结果

Table (strings)
(6x5)
   Floor   Height     Color      Usage   Setback
       0       10   #00FF00       Pomp       0.5
       1        7   #0000FF   Helpdesk      0.75
       2        5   #AAAAAA      Party      0.75
       3        5   #AAAAAA      Party      0.75
       4        7   #FF0000     Living       0.1
element at row 1, col 4: 0.75
Table (float)
(6x5)
   nan   nan   nan   nan    nan
     0    10   nan   nan    0.5
     1     7   nan   nan   0.75
     2     5   nan   nan   0.75
     3     5   nan   nan   0.75
     4     7   nan   nan    0.1
element at row 1, col 4: 0.75