IBM Books

Net.Data 语言环境参考


应用函数语法参考

本节将描述每个应用函数及其格式、用法、参数,并将提供一个简单的示例。

dtw_free()

使用法

使用 dtw_malloc() 从 Net.Data 的运行时间堆阵释放已经分配的存储器。 缓冲区指向要释放的已分配存储器。

格式

void dtw_free(void *buffer)

参数
buffer 一个指向要释放的已分配存储器的指针。

char *myBuf;
long  nbytes = 8192;
 
myBuf = (char *)dtw_malloc(nbytes);
 
dtw_free((void *)myBuf);

dtw_getvar()

使用法

从 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()

使用法

返回一个指向使用 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()

使用法

指定行宽并为列标题分配存储器。您可以对每一行使用 一次 dtw_row_SetCols() 应用函数。

格式

int dtw_row_SetCols(void *row, int cols)

参数
row 一个指向新创建的行的指针,这一行中尚未分配任何列。
cols 要在新行中分配的初始列数。

void *myRow;
 
rc = dtw_row_SetCols(myRow, 5);

dtw_row_SetV()

使用法

指定一个表格值。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_strdup()

使用法

使用 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_AppendRow()

使用法

在表格结尾添加一行或多行。向表格中追加行之后,使用 dtw_table_SetV() 实用程序 来指定新行的值。

格式

int dtw_table_AppendRow(void *table, int rows)

参数
table 一个指向要追加行的表格的指针。
rows 要追加的行数。

void *myTable;
 
rc = dtw_table_AppendRow(myTable, 10);

dtw_table_Cols()

使用法

返回表格中当前的列数。

格式

int dtw_table_Cols(void *table)

参数
table 一个指向返回当前列数的表格的指针。

void *myTable;
int currentColumns;
 
currentColumns = dtw_table_Cols(myTable);

dtw_table_Delete()

使用法

删除所有的列标题、表格值以及表格对象。

格式

int dtw_table_Delete(void *table)

参数
table 一个指向要删除的表格的指针。

void *myTable;
 
rc = dtw_table_Delete(myTable);

dtw_table_DeleteCol()

使用法

删除一个或多个以 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);

dtw_table_DeleteRow()

使用法

删除一个或多个以 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);

dtw_table_GetN()

使用法

检索列标题。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);

dtw_table_GetV()

使用法

从表格中检索值。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);

dtw_table_InsertCol()

使用法

在指定的列后插入一列或多列。

格式

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);

dtw_table_InsertRow()

使用法

在指定的行后插入一行或多行。

格式

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);

dtw_table_MaxRows()

使用法

返回 Net.Data 表格所允许的最大行数,如同 dtw_table_New() 应用函数的 参数 row_lim 所定义的那样。

格式

int dtw_table_MaxRows(void *table)

参数
table 一个指向返回最大行数的表格的指针。

void *myTable;
int maximumRows;
 
maximumRows = dtw_table_MaxRows(myTable);
 

dtw_table_New()

使用法

创建一个 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);

dtw_table_QueryColnoNj()

使用法

返回与列标题相关联的列号。

格式

int dtw_table_QueryColnoNj(void *table, char *name)

参数
table 一个指向要查询的表格的指针。
name 一个指定列标题的字符串(对于这个列标题返回了列号)。如果表格中不存在列标题,则返回 0。

void *myTable;
int columnNumber;
 
columnNumber = dtw_table_QueryColnoNj(myTable, "column 1");

dtw_table_Rows()

使用法

返回表格中当前的行数。

格式

int dtw_table_Rows(void *table)

参数
table 一个指向返回当前行数的表格的指针。

void *myTable;
     int currentRows;
 
     currentRows = dtw_table_Rows(myTable);

dtw_table_SetCols()

使用法

设置表格的列数并为列标题分配存储器。请在创建表格时指定列标题;否则, 就必须在使用任何其它表格函数之前调用这个应用函数来指定列标题。对于每个表格, 您只能使用 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()

使用法

给列标题指定一个名称。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()

使用法

在表格中指定一个值。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);


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]