17.4.15 Modifiche dalla versione 1 dell’API

La versione API corrente non è compatibile a livello binario con la versione 1 dell’API. Le funzioni di estensione vanno ricompilate per poterle usare con la versione corrente di gawk.

Fortunatamente, fatti salvi alcuni possibili avvertimenti a livello di compilazione, l’API rimane compatibile a livello di codice sorgente con la precedente versione API. Le differenze più rilevanti sono gli ulteriori campi nella struttura awk_ext_func_t, e l’aggiunta del terzo argomento nella funzione di implementazione in linguaggio C. (vedi la sezione Registrare funzioni di estensione).

Quella che segue è una lista di singole funzionalità che sono state modificate nella versione 2 rispetto alla versione 1 dell’API:

• I valori numerici possono ora essere anche di tipo MPFR/MPZ (vedi la sezione I tipi di dati di impiego generale).
• Ci sono nuovi tipi di stringa: AWK_REGEX e AWK_STRNUM (vedi la sezione I tipi di dati di impiego generale).
• È disponibile la nuova macro ezalloc() (vedi la sezione Funzioni per allocare memoria e macro di servizio).
• La struttura awk_ext_func_t è stata modificata. Invece del parametro num_expected_args, ha ora i due parametri max_expected e min_required (vedi la sezione Registrare funzioni di estensione).
• In get_record(), un analizzatore di input può ora specificare l’ampiezza dei campi (vedi la sezione Analizzatori di input personalizzati).
• Le estensioni possono ora inviare messaggi di errore non fatali (vedi la sezione Stampare messaggi dalle estensioni).
• Quando di appiattisce un vettore, si può ora specificare il tipo dell’indice e quello dei valori (vedi la sezione Funzioni per lavorare coi vettori).
• C’è una nuova API, get_file() (vedi la sezione Accedere alle ridirezioni e modificarle).