Modulo2


Functions

int CloseDatabaseFile (int handle)
 Chiude un DBF.
int GetDBFInfo (int handle, DBF_INFO_t *DBFInfo)
 Legge informazioni di un DBF aperto.
int GetFieldInfo (int handle, int NumFields, FIELD_DATA_t *FieldData)
 Legge informazioni di uno o piu' campi di un DBF aperto.
int IsDBFHandle (int handle)
 Verifica se un handle è corretto.
int IsDBFOpen (int handle)
 Verifica se un DBF e' aperto.
int OpenDatabaseFile (char *Name, int Mode)
 Apre un DBF.
int SetCurrentRec (int handle)
 Setta un record corrente.

Function Documentation

int CloseDatabaseFile int  handle  ) 
 

Chiude un DBF.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile().

Parameters:
handle L'handle del database aperto.
Returns:
LPC_OK Database chiuso

LPC_BAD_ARG handle non valido

LPC_FILE_ACCESS Errore di chiusura file

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int GetDBFInfo int  handle,
DBF_INFO_t DBFInfo
 

Legge informazioni di un DBF aperto.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile(). Riempie la struttura DBFInfo con tutte le informazioni del DBF. In particolare il record corrente (CurrentRec) e' sempre > 0, anche se non ci sono record (in quel caso vale 1). Indica infatti il punto di inizio di lettura del prossimo record. Per sapere se ci sono record, bisogna basarsi su NumRecs.

Parameters:
handle L'handle del database aperto.
DBFInfo Struttura che riceve le informazioni
Returns:
LPC_OK Informazioni ottenute

LPC_BAD_ARG handle non valido o puntatore NULL

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int GetFieldInfo int  handle,
int  NumFields,
FIELD_DATA_t FieldData
 

Legge informazioni di uno o piu' campi di un DBF aperto.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile(). Riempie il vettore di strutture FieldData con le informazioni sui campi di un database precedentemente aperto con OpenDatabaseFile. La struttura in input deve contenere i nomi dei campi di cui si vogliono le informazioni, e NumFields deve essere settato al numero di elementi riempiti di FieldData. Se NumFields vale 0, vengono ritornate tutte le informazioni sui campi e FieldData deve essere allocato opportunamente.

Parameters:
handle L'handle del database aperto
NumFields Numero di elementi del vettore FieldData oppure 0
FieldData Vettore di strutture con i nomi dei campi oppure vuoto (ma allocato, se NumFields e' 0)
Returns:
LPC_OK Informazioni ottenute

LPC_BAD_ARG handle non valido o puntatore NULL

LPC_BAD_FIELD campo non valido

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int IsDBFHandle int  handle  ) 
 

Verifica se un handle è corretto.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile(). Ritorna LPC_OK se l'handle e' valido.

Parameters:
handle L'handle del database aperto.
Returns:
LPC_OK handle valido

LPC_BAD_ARG handle non valido

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int IsDBFOpen int  handle  ) 
 

Verifica se un DBF e' aperto.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile().

Parameters:
handle L'handle del database aperto.
Returns:
LPC_BAD_ARG handle non valido

SHARED se il DBF e' aperto in modo shared

EXCLUSIVE se il DBF e' aperto in modo exclusive

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int OpenDatabaseFile char *  Name,
int  Mode
 

Apre un DBF.

Name è una stringa NULL terminated e rappresenta il nome del file da aprire. Il nome deve rappresntare un database precedentemente creato. La lunghezza totale del nome viene troncata a DBF_NAME_LENGTH caratteri e viene aggiunta l'estensione ".dbf".

Il database deve essere stato precedentemente creato con la CreateDatabaseFile Una volta aperto il file può essere usato e poi chiuso con la CloseDatabaseFile().

Il flag Mode può valere SHARED o EXCLUSIVE. Nel secondo caso può essere aperto solo da un processo. Quando il file viene aperto, viene creato un file con lo stesso nome che inizia con DBF_OPEN_SHARE o con DBF_OPEN_EXCL e con estensione DBF_OPEN_EXT. Se il file è già creato, nel secondo caso viene ritornato errore LPC_ERR_EXCLUSIVE.

Il record corrente viene settato a 1, anche se non ci sono record nel DBF.

Parameters:
Name Nome del database file, stringa alfanumerica + '_' NULL terminated.
Mode Modalità di apertura: SHARED o EXCLUSIVE
Returns:
LPC_OK Database creato

LPC_BAD_ARG Nome DB nullo o non valido

LPC_FILE_ACCESS Errore di lettura file

LPC_NO_SPACE Massimo numero di DBF aperti

LPC_NO_MEMORY Errore di allocazione memoria

LPC_ERR_EXCLUSIVE Database gia' aperto in modo esclusivo

See also:
CreateDatabaseFile(), CloseDatabaseFile().
Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0

int SetCurrentRec int  handle  ) 
 

Setta un record corrente.

handle deve essere un handle valido ricavato da una precedente chiamata alla OpenDatabaseFile(). La funzione calcola la posizione del file pointer e in base ai dati del file setta il valore del record corrente. Il record corrente (CurrentRec) e' sempre > 0, anche se non ci sono record (in quel caso vale 1). Indica infatti il punto di inizio di lettura del prossimo record.

Parameters:
handle L'handle del database aperto.
Returns:
>0 Nuovo record corrente

LPC_BAD_ARG handle non valido

LPC_FILE_SEEK Errore di spostamento su file

Author:
Gianni Campanile

Stefano Guerrini

Andrea Sterbini

Date:
Gennaio 2006
Version:
1.0


Generated on Thu Jan 26 12:56:39 2006 for LPC-Completo by  doxygen 1.4.6-NO