語言環境介面參考手冊

公用程式函數語法參考手冊

本段說明每一個公用程式函數、其格式、用法和參數，並且也提供簡單的範例。

dtw_free()

使用

釋放用 dtw_malloc() 配置自 Net.Data 執行堆集而配置的儲存體。緩衝區會指向將釋放的已配置儲存體。

格式

void dtw_free(void *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 執行堆集配置的儲存體。儲存體的度為 nbytes。如果 Net.Data 無法傳回所要求的儲存體，則會傳回 NULL 指標。

格式

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

使用

配置來自 Net.Data 的執行堆集的儲存體，並將 string 所指定的字串複製到以 dtw_malloc() 所配置的儲存體。如果 Net.Data 無法傳回所要求的儲存體，則會傳回 NULL 指標。

格式

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

[ 頁面頂端 | 前一頁 | 下一頁 | 目錄 | 索引 ]

`row`	指向尚未配置任何直欄之剛建立橫列的指標。
`cols`	將在新的橫列中配置的起始直欄數目。

`row`	將修改的橫列的指標。
`src`	含有將設定之新值的字串。
`col`	將設定的值的直欄號碼。

`table`	指向將被附加橫列的表格的指標。
`rows`	將附加的橫列數目。

`table`	指向將修改的表格的指標。
`start_col`	將刪除的第一個欄的直欄號碼。
`rows`	將刪除的列數。

`table`	指向將修改的表格的指標。
`start_row`	將刪除的第一列的橫列號碼。
`rows`	將刪除的橫列數目。

`table`	指向將從其中取回直欄標題的表格的指標。
`dest`	指向含有直欄標題的字串的指標。
`col`	直欄標題的直欄號碼。

`table`	指向將從其中取回一個值的表格的指標。
`dest`	指向將會包含該數值之字串的指標。
`row`	將取回的值的橫列號碼。
`col`	將取回的值的直欄號碼。

`table`	指向將修改的表格的指標。
`after_col`	將在其後插入新直欄的直欄數目。欲在表格起始處插入直欄，請指定 0。
`cols`	將插入的直欄數目。

`table`	指向將修改的表格的指標。
`after_row`	將在其後插入新橫列的橫列的號碼。欲在表格起始處插入橫列，請指定 0。
`rows`	將插入的橫列數目。

`table`	新表格的名稱。
`rows`	將在新表格中配置的起始橫列數目。
`cols`	將在新表格中配置的起始直欄數目。
`row_lim`	此表格所能包含的最大列數。

`table`	指向將查詢的表格的指標。
`name`	指定將傳回其直欄號碼的直欄標題的字串。如果表格中沒有直欄標題，將傳回 0。

`table`	指向沒有配置任何直欄或橫列的新表格的指標。
`cols`	將在新表格中配置的起始直欄數目。

`table`	指向已指定欄位標題之表格的指標。
`src`	指定給新直欄位標題的字串。
`col`	直欄個數。

`table`	指向將要指定數值之表格的指標。
`src`	指定給新數值的字串。
`row`	新值的橫列號碼。
`col`	新值的直欄號碼。