Specifiche Interfaccia
[Modulo1]

Functions
int	CreateDatabaseFile (char *Name, int NumFields, FIELD_DATA_t *FieldData)
	Crea un file di database con nome Name.
int	DeleteDatabaseFile (char *Name)
	Cancella un file di database con nome Name.

---

Function Documentation

int CreateDatabaseFile (  char *  Name, int  NumFields, FIELD_DATA_t *  FieldData )

Crea un file di database con nome Name. Name è una stringa non nulla e NULL terminated e rappresenta il nome del file da creare. Il nome del file deve contenere solo caratteri alfanumerici + il carattere '_' e deve iniziare con un carattere alfabetico. La lunghezza totale del nome viene troncata a DBF_NAME_LENGTH caratteri e viene aggiunta l'estensione DBF_EXTENSION. NumFields è il numero dei campi del DBF che sono definiti nel vettore di strutture FieldData. Deve essere 0 < NumFields <= DBF_MAX_FIELDS Per ogni campo deve essere definito: Name Nome del campo. Deve contenere solo caratteri alfanumerici + il carattere '_' e deve iniziare con un carattere alfabetico. Ogni campo deve avere un nome differente nell'ambito dello stesso DBF FieldType Tipo del campo. Puo' valere solo CHARACTER, NUMERIC, DATE, LOGICAL. FieldLen Lunghezza totale del campo. Valido solo per campi di tipo CHARACTER . CHARACTER: 1 <= FieldLen <= FIELD_CHAR_LEN NUMERIC: lunghezza fissa a FIELD_NUM_LEN DATE: lunghezza fissa a FIELD_DATE_LEN LOGICAL: lunghezza fissa a FIELD_LOGI_LEN Una volta creato, il database file viene chiuso, e per essere utilizzato deve essere chiamata la funzione OpenDatabaseFile(). Parameters: [in]  Name  Nome del database file, stringa alfanumerica + '_' NULL terminated. [in]  NumFields  numero di campi del database. [in]  *FieldData  Vettore di strutture di dimensione numfields. Returns: LPC_OK Database creato LPC_BAD_ARG Nome DB nullo o non valido o NumFields <= 0 LPC_BAD_FIELD Valore di uno dei campi non valido: nome, tipo, lunghezza o duplicato. LPC_NO_MEMORY Errore in allocazione memoria. LPC_FILE_EXISTS File DBF gia' esistente. LPC_ERR_WRITE Errore in scrittura su file. See also: DeleteDatabaseFile(). Author: Gianni Campanile Stefano Guerrini Andrea Sterbini Date: Gennaio 2006 Version: 1.0

int DeleteDatabaseFile (  char *  Name  )

Cancella un file di database con nome Name. Name è una stringa non nulla e NULL terminated e rappresenta il nome del file da creare. Il nome deve essere quello di un DBF precedentemente creato con la funzione CreateDatabaseFile(). La lunghezza totale del nome viene troncata a DBF_NAME_LENGTH caratteri e viene aggiunta l'estensione DBF_EXTENSION. Il database deve essere chiuso, cioe' non deve esistere un file con lo stesso nome e estensione DBF_OPEN_EXT. Parameters: [in]  Name  Nome del database file, stringa alfanumerica + '_' NULL terminated. Returns: LPC_OK Database cancellato LPC_BAD_ARG Nome DB nullo o non valido LPC_DBF_OPEN Il database è aperto. LPC_FILE_ACCESS Il file non esiste o non può essere cancellato. See also: CreateDatabaseFile(). Author: Gianni Campanile Stefano Guerrini Andrea Sterbini Date: Gennaio 2006 Version: 1.0

---