Funzione che restituisce il valore di un determinato campo dell'archivio.

Parametro d'input:

$field - Nome del campo dell'archivio. Fare riferimento all'appendice A.
$type - Tipo di visualizzazione. Quelli supportati sono:

'qua' - per campo quantità. Aggiunge la virgola e i decimali
'val' - per campo lire.
'eur' - per campo euro. Aggiunge la virgola e i decimali
'str' - non apporta nessuna variazione al campo

Ritorno:

valore - Il valore del campo sia numerico che stringa

Esempio:

$cod = sar_field('codice'); // ritorna il codice

sar_html($str)

Funzione che restituisce una stringa composta dal codice html ed il valore dei campi richiesti. I campi posti all'interno di $str devono essere racchiusi da { e }.

Parametro d'input:

$str - Stringa contenente il codice html ed i campi racchiusi tra { e}.

Ritorno:

string - Una stringa html con i campi convertiti in valori

Esempio:

sar_html('<a href="scm.php?cod={codice}">codice</a>'); // ritorna la stringa '<a href="scm.php?cod=20">codice</a>

sar_list()

Funzione che esegue un'interrogazione sulla tabella del database ed inizializza l'archivio per essere visualizzato in una tabella html.

Parametro d'input:

$sar_where - Parametro where della query SQL (leggere manuale SQL)
$sar_order - Parametro order della query SQL (leggere manuale SQL)

Ritorno:

$bof_sar - Se il database è vuoto viene impostato a 1
$eof_sar - Se il database è vuoto viene impostato a 1

Esempio:

sar_list();              // effettua l'interrogazione dell'archivio

sar_options($default = '')

La funzione riempie un'option box di un form html con tutti i records. Per preselezionare un valore specifico, impostate il parametro $default.

Parametro d'input:

$default - Contiene il valore di un "value" dell'option box da selezionare
$sar_where - Parametro where della query SQL (leggere manuale SQL)
$sar_order - Parametro order della query SQL (leggere manuale SQL)

Ritorno:

Nessuno ritorno. viene generata un'option box in un form html.

Esempio:

<select size="1" name="sar_cod">
    <option selected value="">Qualsiasi</option>
    <script language="php">sar_options('20');</script>
</select>
// aggiunge le altre <option> selezionando quella con valore = '20'

sar_pagpre($link, $yestext, $notext)

Funzione che prepara un link html per procedere alla pagina precedente di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando sar_list()

Parametro d'input:

$link - Nome della pagina html che viene caricata dopo il click sul link.
$yestext - Testo visualizzato per link se esistono altri records.
$notext - Testo visualizzato per link se non esistono altri records.

Ritorno:

Nessuno. Crea il link html per la pagina precedente di una lista

Esempio:

$sar_pagpre('sarlist.php', '<< pagina precedente', '&nbsp;')';   // prepara un link alla pagina precedente visualizzando il testo $yestext se esistono dei records altrimenti il testo contenuto in $notext

sar_pagsuc($link, $yestext, $notext)

Funzione che prepara un link html per procedere alla pagina successiva di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando sar_list()

Parametro d'input:

$link - Nome della pagina html che viene caricata dopo il click sul link.
$yestext - Testo visualizzato per link se esistono altri records.
$notext - Testo visualizzato per link se non esistono altri records.

Ritorno:

Nessuno. Crea il link html per la pagina successiva di una lista

Esempio:

$sar_pagsuc('sarlist.php', 'pagina successiva >>', '&nbsp;')';   // prepara un link alla pagina successiva visualizzando il testo $yestext se esistono dei records altrimenti il testo contenuto in $notext

sar_read()

Funzione che legge un determinato record dal database.

Parametro d'input:

$sar_cod - Contiene il codice della chiave da leggere

Ritorno:

$bof_sar - Se la lettura non va a buon fine viene impostato a 1
$eof_sar - Se la lettura non va a buon fine viene impostato a 1

Esempio:

$sar_cod = '20';         // impostazione parametro d'input
sar_read();              // effettua la lettura

sar_readnext()

Funzione che legge il record successivo di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando sar_list()

Parametro d'input:

Ritorno:

$eof_sar - Se la lettura va oltre la fine dell'archivio viene impostato a 1

Esempio:

$sar_readnext()';   // legge il record successivo

sar_show($field, $type = 'str')

La funzione serve per visualizzare il contenuto di un campo del database. Contiene dei parametri d'input che aiutano la formattazione del campi numerici.

Parametro d'input:

$field - Nome del campo da visualizzare (fare riferimento all'appendice A)
$type - Tipo di visualizzazione. Quelli supportati sono:

'qua' - per campo quantità. Aggiunge la virgola e i decimali
'val' - per campo lire.
'eur' - per campo euro. Aggiunge la virgola e i decimali
'str' - non apporta nessuna variazione al campo

Ritorno:

Nessuno ritorno. Il campo viene visualizzato.

Esempio:

sar_show('codice');           // visualizza il codice