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


17.4.9 Accedere ai parametri e aggiornarli

Due funzioni consentono di accedere agli argomenti (parametri) passati all’estensione. Esse sono:

awk_bool_t get_argument(size_t count,
                        awk_valtype_t wanted,
                        awk_value_t *risultato);

Riempie la struttura awk_value_t puntata da risultato con l’argomento numero count. Restituisce true se il tipo dell’argomento corrisponde a quello specificato in wanted, e false in caso contrario. In quest’ultimo caso, risultato->val_type indica il tipo effettivo dell’argomento (vedi Tabella 17.2). La numerazione degli argomenti parte da zero: il primo argomento è il numero zero, il secondo è il numero uno, e così via. wanted indica il tipo di valore atteso.

awk_bool_t set_argument(size_t count, awk_array_t array);

Converte un parametro di tipo indefinito in un vettore; ciò permette la chiamata per riferimento per i vettori. Restituisce false se count è troppo elevato, o se il tipo di argomento è diverso da undefined. Vedi la sezione Manipolazione di vettori per ulteriori informazioni riguardo alla creazione di vettori.