Questa sezione descrive ogni programma di utilità, il formato, l'uso e i parametri e fornisce facili esempi.
Uso
Libera memoria assegnata dal gruppo run-time di Net.Data utilizzando dtw_malloc(). Il buffer indica la memoria assegnata da liberare.
Formato
void dtw_free(void *buffer)
Parametri
buffer | Un indicatore della memoria assegnata da liberare. |
Esempi
char *myBuf; long nbytes = 8192; myBuf = (char *)dtw_malloc(nbytes); dtw_free((void *)myBuf);
Uso
Richiama il valore di una variabile di configurazione specificata tramite nome_var dal file di inizializzazione di Net.Data. Net.Data dispone della memoria restituita da dtw_getvar(); non modificarla o liberarla.
Formato
char *dtw_getvar(char *nome_var)
Parametri
nome_var | Il nome della variabile di configurazione da richiamare. |
Esempi
char *myBindFile; myBindFile = dtw_getvar("BIND_FILE");
Uso
Restituisce un indicatore della memoria assegnata dal gruppo run-time di Net.Data utilizzando dtw_malloc(). La memoria misura nbyte. Se Net.Data non riesce a restituire la memoria richiesta, viene riportato un valore NULL.
Formato
void *dtw_malloc(long nbyte)
Parametri
nbyte | Numero di byte da assegnare. |
Esempi
char *myBuf; long nbytes = 8192; myBuf = (char *)dtw_malloc(nbyte);
Uso
Assegna l'ampiezza della riga e la memoria per le intestazioni della colonna. E' possibile utilizzare il programma di utilità dtw_row_SetCols() una volta per riga.
Formato
int dtw_row_SetCols(void *riga, int col)
Parametri
riga | Un indicatore per una riga appena creata che non ha ancora assegnato colonne. |
col | Il numero iniziale di colonne da assegnare nella nuova riga. |
Esempi
void *myRow; rc = dtw_row_SetCols(myRow, 5);
Uso
Assegna un valore di tabella. L'utente che ha richiamato il programma di utilità dtw_row_SetV() ottiene la proprietà della memoria indicata tramite src. Per cancellare il valore di tabella corrente, impostare il valore su NULL.
Formato
int dtw_row_SetV(void *riga, char *src, int col)
Parametri
riga | Indica la riga da modificare. |
src | Una stringa di carattere contenente il nuovo valore da impostare. |
col | Il numero di colonna del valore da impostare. |
Esempi
void *myTable; char *myFieldValue = "newValue"; rc = dtw_row_SetV(myRow, myFieldValue, 3);
Uso
Assegna memoria dal gruppo run-time di Net.Data e copia la stringa specificata tramite string nella memoria assegnata utilizzando dtw_malloc(). Se Net.Data non riesce a restituire la memoria richiesta, viene riportato un valore NULL.
Formato
char *dtw_strdup(char *stringa)
Parametri
stringa | Un indicatore del valore della stringa da copiare nella memoria assegnata. |
Esempi
char *myString = "This string will be duplicated."; char *myDupString; myDupString = dtw_strdup(myString);
Uso
Aggiunge una o più righe alla fine della tabella. Assegnare i valori della tabella delle nuove righe con il programma di utilità dtw_table_SetV() dopo che le righe sono state accodate alla tabella.
Formato
int dtw_table_AppendRow(void *tabella, int righe)
Parametri
tabella | Un indicatore della tabella a cui accodare le righe. |
righe | Il numero di righe da accodare. |
Esempi
void *myTable; rc = dtw_table_AppendRow(myTable, 10);
Uso
Restituisce il numero corrente di colonne in una tabella.
Formato
int dtw_table_Cols(void *tabella)
Parametri
tabella | L'indicatore della tabella il cui numero corrente di colonne viene restituito. |
Esempi
void *myTable; int currentColumns; currentColumns = dtw_table_Cols(myTable);
Uso
Elimina tutte le intestazioni di colonna, i valori della tabella e l'oggetto tabella.
Formato
int dtw_table_Delete(void *tabella)
Parametri
tabella | Un indicatore della tabella da cancellare. |
Esempi
void *myTable; rc = dtw_table_Delete(myTable);
Uso
Elimina una o più colonne iniziando dalla colonna specificata in start_col. Per eliminare tutte le righe e le colonne di una tabella, sostituire il programma di utilità dtw_table_Cols() al parametro cols.
dtw_table_DeleteCol(tabella, 1, dtw_table_Cols());
Formato
int dtw_table_DeleteCol(void *tabella, int start_col, int col)
Parametri
tabella | Un indicatore della tabella da modificare. |
start_col | Il numero colonna della prima colonna da cancellare. |
righe | Il numero di colonne da cancellare. |
Esempi
void *myTable; rc = dtw_table_DeleteCol(myTable, 1, 10);
Uso
Elimina una o più righe iniziando dalla riga specificata in start_riga.
Formato
int dtw_table_DeleteRow(void *tabella, int start_riga, int righe)
Parametri
tabella | Un indicatore della tabella da modificare. |
start_riga | Il numero riga della prima riga da cancellare. |
righe | Il numero di righe da eliminare. |
Esempi
void *myTable; rc = dtw_table_DeleteRow(myTable, 3, 10);
Uso
Richiama un'intestazione colonna. Net.Data dispone della memoria indicata da dest; non modificarla o liberarla.
Formato
int dtw_table_GetN(void *tabella, char **dest, int col)
Parametri
tabella | L'indicatore della tabella da cui viene richiamata un'intestazione della colonna. |
dest | Indica la stringa di carattere che deve contenere l'intestazione della colonna. |
col | Il numero di colonna dell'intestazione colonna. |
Esempi
void *myTable; char *myColumnHeading; rc = dtw_table_GetN(myTable, &myColumnHeading, 5);
Uso
Richiama un valore da una tabella. Net.Data dispone della memoria indicata da dest; non modificarla o liberarla.
Formato
int dtw_table_GetV(void *tabella, char **dest, int riga, int col)
Parametri
tabella | L'indicatore della tabella da cui viene richiamato un valore. |
dest | Indica la stringa di carattere che deve contenere il valore. |
riga | Il numero riga della prima riga da richiamare. |
col | Il numero di colonna del valore da richiamare. |
Esempi
void *myTable; char *myTableValue; rc = dtw_table_GetV(myTable, &myTableValue, 3, 5);
Uso
Inserisce una o più colonne dopo quella specificata.
Formato
int dtw_table_InsertCol(void *tabella, int after_col, int col)
Parametri
tabella | Un indicatore della tabella da modificare. |
after_col | Il numero della colonna dopo di cui inserire le nuove colonne. Per inserire le colonne all'inizio della tabella, specificare 0. |
col | Il numero di colonne da inserire. |
Esempi
void *myTable; rc = dtw_table_InsertCol(myTable, 3, 10);
Uso
Inserisce una o più righe dopo quella specificata.
Formato
int dtw_table_InsertRow(void *tabella, int after_riga, int righe)
Parametri
tabella | Un indicatore della tabella da modificare. |
after_riga | Il numero della riga dopo di cui inserire le nuove righe. Per inserire le righe all'inizio della tabella, specificare 0. |
righe | Il numero di righe da inserire. |
Esempi
void *myTable; rc = dtw_table_InsertRow(myTable, 3, 10);
Uso
Restituisce il numero massimo di righe consentite per la tabella di Net.Data definito nel programma di utilità dtw_table_New() nel parametro row_lim.
Formato
int dtw_table_MaxRows(void *tabella)
Parametri
tabella | L'indicatore della tabella da cui viene richiamato il numero massimo di righe. |
Esempi
void *myTable; int maximumRows; maximumRows = dtw_table_MaxRows(myTable);
Uso
Crea un oggetto tabella di Net.Data e inizializza tutte le intestazioni della colonna e i valori di campi su NULL. L'utente che richiama deve specificare il numero iniziale di righe e di colonne e il numero massimo di righe. Se il numero massimo di righe e di colonne è 0, è necessario utilizzare la funzione dtw_table_SetCols() per specificare il numero di campi contenuti in una riga prima di richiamare una qualsiasi funzione di tabella.
Formato
int dtw_table_New(void **tabella, int righe, int col, int lim_righe)
Parametri
tabella | Il nome della nuova tabella. |
righe | Il numero iniziale di righe da assegnare nella nuova tabella. |
col | Il numero iniziale di colonne da assegnare nella nuova tabella. |
lim_righe | Il numero massimo di righe che la tabella può contenere. |
Esempi
void *myTable; rc = dtw_table_New(&myTable, 20, 5, 100);
Uso
Restituisce il numero colonna associato all'intestazione colonna.
Formato
int dtw_table_QueryColnoNj(void *tabella, char *nome)
Parametri
tabella | Un indicatore della tabella da interrogare. |
nome | Una stringa di caratteri che specifica l'intestazione colonna per la quale viene restituito il numero colonna. Se l'intestazione della colonna non esiste nella tabella, viene restituito 0. |
Esempi
void *myTable; int columnNumber; columnNumber = dtw_table_QueryColnoNj(myTable, "column 1");
Uso
Restituisce il numero corrente di righe nella tabella.
Formato
int dtw_table_Rows(void *tabella)
Parametri
tabella | L'indicatore della tabella da cui viene richiamato il numero di righe. |
Esempi
void *myTable; int currentRows; currentRows = dtw_table_Rows(myTable);
Uso
Imposta il numero di colonne della tabella e assegna la memoria per le intestazioni della colonna. Specificare le intestazioni della colonna quando viene creata la tabella; o specificarle richiamando questo programma di utilità prima di utilizzare tutte le altre funzioni della tabella. E' possibile utilizzare il programma di utilità dtw_table_SetCols() una volta per tabella. Successivamente, utilizzare i programmi di utilità dtw_table_DeleteCol() o dtw_table_InsertCol().
Formato
int dtw_table_SetCols(void *tabella, int col)
Parametri
tabella | Un indicatore per una nuova tabella a cui non sono state assegnate colonne o righe. |
col | Il numero iniziale di colonne da assegnare nella nuova tabella. |
Esempi
void *myTable; rc = dtw_table_SetCols(myTable, 5);
Uso
Assegna un nome all'intestazione colonna. L'utente che ha richiamato il programma di utilità dtw_table_SetN() ottiene la proprietà della memoria indicata tramite il parametro src. Per eliminare l'intestazione della colonna, impostare il valore dell'impostazione colonna su NULL.
Formato
int dtw_table_SetN(void *tabella, char *src, int col)
Parametri
tabella | Un indicatore della tabella di cui viene assegnata l'intestazione. |
src | Una stringa di caratteri assegnata alla nuova intestazione colonna. |
col | Il numero della colonna. |
Esempi
void *myTable; char *myColumnHeading = "newColumnHeading"; rc = dtw_table_SetN(myTable, myColumnHeading, 5);
Uso
Assegna un valore in una tabella. L'utente che ha richiamato il programma di utilità dtw_table_SetV() ottiene la proprietà della memoria indicata tramite il parametro src. Per cancellare il valore di tabella, impostare il valore su NULL.
Formato
int dtw_table_SetV(void *tabella, char *src, int riga, int col)
Parametri
tabella | Un indicatore della tabella di cui viene assegnato il valore. |
src | Una stringa di caratteri assegnata al nuovo valore. |
riga | Il numero riga della nuova riga. |
col | Il numero colonna del nuovo valore. |
Esempi
void *myTable; char *myTableValue = "newValue"; rc = dtw_table_SetV(myTable, myTableValue, 3, 5);