Successivo: , Precedente: , Su: Descrizione dell'estensione API   [Contenuti][Indice]


17.4.8 Richiedere valori

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
StringaStrnumNumeroRegexpVettoreIndefinito
StringaStringaStringaStringaStringafalsefalse
StrnumfalseStrnumStrnumfalsefalsefalse
NumeroNumeroNumeroNumerofalsefalsefalse
TipoRegexpfalsefalsefalseRegexpfalsefalse
RichiestoVettorefalsefalsefalsefalseVettorefalse
ScalarScalarScalarScalarScalarfalsefalse
IndefinitoStringaStrnumNumeroRegexpVettoreIndefinito
Value cookiefalsefalsefalsefalsefalsefalse

Tabella 17.2: Tipi di valori restituiti dall’API