Oma_Ot_Table_Partial_Copy()
摘要
复制 OT 表格的指定行。
语法
Oma_Ot_Table_Partial_Copy (ot_table_ptr, first_row, partial_row_count, stub_missing_rows)
| 参数 | 类型 | 说明 |
|---|---|---|
ot_table_ptr |
OmaT_Ot_Table * |
目标 OT 表格。 |
first_row |
int |
要包含在副本中的首行索引。 |
partial_row_count |
int |
要复制的行数。 |
stub_missing_rows |
PrgT_Boolean |
是否在副本中包含占位(stub)行(参见 stub_missing_rows)。 |
返回类型
OmaT_Ot_Table *
指定 OT 表格的部分副本;若无法创建副本则返回 PRGC_NIL。
头文件
oma_ot.h
详情
该函数创建并返回指定表格的私有部分副本。源表格可以是读取表格,也可以是写入表格(前提是写入文件格式支持随机访问,即“write-many”)。无论哪种情况,返回的表格实际上都是一个读取表格,因为它不再与文件或文件的数据绑定。
调用方在不再需要返回的表格时,应使用 Oma_Ot_Table_Destroy() 将其销毁。
stub_missing_rows
当表格只包含可用数据的一部分切片时,其余行会被置为占位行,以便将数据切片放在上下文中。如果 stub_missing_rows 为 PRGC_TRUE,这些占位行(如有)会被包含在副本中。如果为 PRGC_FALSE,返回表格的第一行(索引 = 0)将包含源表格中第一个指定行(索引 = first_row)的数据;并且返回表格将恰好包含 partial_row_count 行。