Guida di riferimento per l'interfaccia per l'ambiente di linguaggio


Riferimenti di sintassi per i programmi di utilità

Questa sezione descrive ogni programma di utilità, il formato, l'uso e i parametri e fornisce facili esempi.

dtw_free()

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

dtw_getvar()

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

dtw_malloc()

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

dtw_row_SetCols()

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

dtw_row_SetV()

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

dtw_strdup()

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

dtw_table_AppendRow()

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

dtw_table_Cols()

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

dtw_table_Delete()

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

dtw_table_DeleteCol()

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

dtw_table_DeleteRow()

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

dtw_table_GetN()

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

dtw_table_GetV()

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

dtw_table_InsertCol()

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

dtw_table_InsertRow()

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

dtw_table_MaxRows()

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

dtw_table_New()

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

dtw_table_QueryColnoNj()

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

dtw_table_Rows()

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

dtw_table_SetCols()

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

dtw_table_SetN()

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

dtw_table_SetV()

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


[ Inizio pagina | Pagina precedente | Pagina successiva | Indice | Indice analitico ]