Successivo: Accedere ai parametri, Precedente: Aggiornare ERRNO, Su: Descrizione dell'estensione API [Contenuti][Indice]
Tutte le funzioni che restituiscono valori da gawk
funzionano allo stesso modo. Si fornisce un campo awk_valtype_t
per indicare il tipo di valore che ci si aspetta. Se il valore disponibile
corrisponde a quello richiesto, la funzione restituisce true e riempie
il campo del risultato awk_value_t.
Altrimenti, la funzione restituisce false, e il campo val_type
indica il tipo di valore disponibile.
A quel punto si può, a seconda di quel che richiede la situazione,
stampare un messaggio di errore oppure ripetere la
richiesta specificando il tipo di valore che risulta disponibile. Questo
comportamento è riassunto nella
Tabella 17.2.
| Tipo di valore reale |
|---|
| Stringa | Strnum | Numero | Regexp | Vettore | Indefinito | ||
|---|---|---|---|---|---|---|---|
| Stringa | Stringa | Stringa | Stringa | Stringa | false | false | |
| Strnum | false | Strnum | Strnum | false | false | false | |
| Numero | Numero | Numero | Numero | false | false | false | |
| Tipo | Regexp | false | false | false | Regexp | false | false |
| Richiesto | Vettore | false | false | false | false | Vettore | false |
| Scalar | Scalar | Scalar | Scalar | Scalar | false | false | |
| Indefinito | Stringa | Strnum | Numero | Regexp | Vettore | Indefinito | |
| Value cookie | false | false | false | false | false | false |
Tabella 17.2: Tipi di valori restituiti dall’API