本节将描述每个应用函数及其格式、用法、参数,并将提供一个简单的示例。
使用法
使用 dtw_malloc() 从 Net.Data 的运行时间堆阵释放已经分配的存储器。 缓冲区指向要释放的已分配存储器。
格式
void dtw_free(void *buffer)
参数
buffer | 一个指向要释放的已分配存储器的指针。 |
例
char *myBuf; long nbytes = 8192; myBuf = (char *)dtw_malloc(nbytes); dtw_free((void *)myBuf);
使用法
从 Net.Data 初始化文件中检索 var_name 指定的配置变量的值。Net.Data 拥 有 dtw_getvar() 所返回的内存;不作修改也不释放。
格式
char *dtw_getvar(char *var_name)
参数
var_name | 要检索的配置变量的名称。 |
例
char *myBindFile; myBindFile = dtw_getvar("BIND_FILE");
使用法
返回一个指向使用 dtw_malloc() 从 Net.Data 的运行时间堆阵分配的存储器的指针。存储器 有 n 个字节长。如果 Net.Data 无法返回请求的存储器,则将返回一个空指针。
格式
void *dtw_malloc(long nbytes)
参数
nbytes | 要分配的字节数。 |
例
char *myBuf; long nbytes = 8192; myBuf = (char *)dtw_malloc(nbytes);
使用法
指定行宽并为列标题分配存储器。您可以对每一行使用 一次 dtw_row_SetCols() 应用函数。
格式
int dtw_row_SetCols(void *row, int cols)
参数
row | 一个指向新创建的行的指针,这一行中尚未分配任何列。 |
cols | 要在新行中分配的初始列数。 |
例
void *myRow; rc = dtw_row_SetCols(myRow, 5);
使用法
指定一个表格值。dtw_row_SetV() 应用函数的调用程序保留 src 所 指向的内存的所有权。要删除当前的表格值,可将这个值指定为 NULL。
格式
int dtw_row_SetV(void *row, char *src, int col)
参数
row | 一个指向要修改的行的指针。 |
src | 包含要设置的新值的字符串。 |
col | 要设置值的列号。 |
例
void *myTable; char *myFieldValue = "newValue"; rc = dtw_row_SetV(myRow, myFieldValue, 3);
使用法
使用 dtw_malloc() 从 Net.Data 的运行时间堆阵中分配存储器,并将 string 指定的 字符串复制到已分配的存储器中。如果 Net.Data 无法返回请求的存储器,则将返回一个空指针。
格式
char *dtw_strdup(char *string)
参数
string | 一个指向要复制到分配的存储器中去的字符串值的指针。 |
例
char *myString = "This string will be duplicated."; char *myDupString; myDupString = dtw_strdup(myString);
使用法
在表格结尾添加一行或多行。向表格中追加行之后,使用 dtw_table_SetV() 实用程序 来指定新行的值。
格式
int dtw_table_AppendRow(void *table, int rows)
参数
table | 一个指向要追加行的表格的指针。 |
rows | 要追加的行数。 |
例
void *myTable; rc = dtw_table_AppendRow(myTable, 10);
使用法
返回表格中当前的列数。
格式
int dtw_table_Cols(void *table)
参数
table | 一个指向返回当前列数的表格的指针。 |
例
void *myTable; int currentColumns; currentColumns = dtw_table_Cols(myTable);
使用法
删除所有的列标题、表格值以及表格对象。
格式
int dtw_table_Delete(void *table)
参数
table | 一个指向要删除的表格的指针。 |
例
void *myTable; rc = dtw_table_Delete(myTable);
使用法
删除一个或多个以 start_col 中指定的列开头的列。要删除一个表格中所有 的行与列,可用应用函数 dtw_table_Cols() 来替换 cols 参数。
dtw_table_DeleteCol(table, 1, dtw_table_Cols());
格式
int dtw_table_DeleteCol(void *table, int start_col, int cols)
参数
table | 一个指向要修改的表格的指针。 |
start_col | 要删除的第一列的列号。 |
rows | 要删除的列数。 |
例
void *myTable; rc = dtw_table_DeleteCol(myTable, 1, 10);
使用法
删除一个或多个以 start_row 中指定的行开头的行。
格式
int dtw_table_DeleteRow(void *table, int start_row, int rows)
参数
table | 一个指向要修改的表格的指针。 |
start_row | 要删除的第一行的行号。 |
rows | 要删除的行数。 |
例
void *myTable; rc = dtw_table_DeleteRow(myTable, 3, 10);
使用法
检索列标题。Net.Data 拥有 dest 所指向的内存;不作修改也不释放。
格式
int dtw_table_GetN(void *table, char **dest, int col)
参数
table | 一个指向从中检索到列标题的表格的指针。 |
dest | 一个指向要包含列标题的字符串的指针。 |
col | 列标题的列号。 |
例
void *myTable; char *myColumnHeading; rc = dtw_table_GetN(myTable, &myColumnHeading, 5);
使用法
从表格中检索值。Net.Data 拥有 dest 所指向的内存;不作修改也不释放。
格式
int dtw_table_GetV(void *table, char **dest, int row, int col)
参数
table | 一个指向从中检索到值的表格的指针。 |
dest | 一个指向要包含该值的字符串的指针。 |
row | 要检索的值的行号。 |
col | 要检索的值的列号。 |
例
void *myTable; char *myTableValue; rc = dtw_table_GetV(myTable, &myTableValue, 3, 5);
使用法
在指定的列后插入一列或多列。
格式
int dtw_table_InsertCol(void *table, int after_col, int cols)
参数
table | 一个指向要修改的表格的指针。 |
after_col | 新列插入之后的列号。要在表格的开头插入列,请指定 0。 |
cols | 要插入的列数。 |
例
void *myTable; rc = dtw_table_InsertCol(myTable, 3, 10);
使用法
在指定的行后插入一行或多行。
格式
int dtw_table_InsertRow(void *table, int after_row, int rows)
参数
table | 一个指向要修改的表格的指针。 |
after_row | 新行插入之后的行号。要在表格的开头插入行,请指定 0。 |
rows | 要插入的行数。 |
例
void *myTable; rc = dtw_table_InsertRow(myTable, 3, 10);
使用法
返回 Net.Data 表格所允许的最大行数,如同 dtw_table_New() 应用函数的 参数 row_lim 所定义的那样。
格式
int dtw_table_MaxRows(void *table)
参数
table | 一个指向返回最大行数的表格的指针。 |
例
void *myTable; int maximumRows; maximumRows = dtw_table_MaxRows(myTable);
使用法
创建一个 Net.Data 表格对象并将所有的列标题和字段值初始化为 NULL。调用程序指定行、 列的初始数目以及最大行数。如果行、列的初始数目为 0,则必须在任何表格函数调用之前 使用 dtw_table_SetCols() 函数来指定一行中的字段数目。
格式
int dtw_table_New(void **table, int rows, int cols, int row_lim)
参数
table | 新表格的名称。 |
rows | 要在新表格中分配的初始行数。 |
cols | 要在新表格中分配的初始列数。 |
row_lim | 此表能够包含的最大行数。 |
例
void *myTable; rc = dtw_table_New(&myTable, 20, 5, 100);
使用法
返回与列标题相关联的列号。
格式
int dtw_table_QueryColnoNj(void *table, char *name)
参数
table | 一个指向要查询的表格的指针。 |
name | 一个指定列标题的字符串(对于这个列标题返回了列号)。如果表格中不存在列标题,则返回 0。 |
例
void *myTable; int columnNumber; columnNumber = dtw_table_QueryColnoNj(myTable, "column 1");
使用法
返回表格中当前的行数。
格式
int dtw_table_Rows(void *table)
参数
table | 一个指向返回当前行数的表格的指针。 |
例
void *myTable; int currentRows; currentRows = dtw_table_Rows(myTable);
使用法
设置表格的列数并为列标题分配存储器。请在创建表格时指定列标题;否则, 就必须在使用任何其它表格函数之前调用这个应用函数来指定列标题。对于每个表格, 您只能使用 dtw_table_SetCols() 应用函数一次。之后,可以使用 dtw_table_DeleteCol() 或 dtw_table_InsertCol() 应用函数。
格式
int dtw_table_SetCols(void *table, int cols)
参数
table | 一个指向没有分配列或行的新表的指针。 |
cols | 要在新表格中分配的初始列数。 |
例
void *myTable; rc = dtw_table_SetCols(myTable, 5);
使用法
给列标题指定一个名称。dtw_table_SetN() 应用函数的调用程序保留 src 参数所 指向的内存的所有权。要删除列标题,可将列标题指定为 NULL。
格式
int dtw_table_SetN(void *table, char *src, int col)
参数
table | 一个指向已指定了列标题的表格的指针。 |
src | 一个要分配给新的列标题的字符串。 |
col | 列号。 |
例
void *myTable; char *myColumnHeading = "newColumnHeading"; rc = dtw_table_SetN(myTable, myColumnHeading, 5);
使用法
在表格中指定一个值。dtw_table_SetV() 应用函数的调用程序保留 src 参数所 指向的内存的所有权。要删除表格值,可将该值指定为 NULL。
格式
int dtw_table_SetV(void *table, char *src, int row, int col)
参数
table | 一个指向要为其分配值的表格的指针。 |
src | 一个指定给新值的字符串。 |
row | 新值的行号。 |
col | 新值的列号。 |
例
void *myTable; char *myTableValue = "newValue"; rc = dtw_table_SetV(myTable, myTableValue, 3, 5);