Assert.h
# Assert.h

* Libreria standard del C++
* Libreria standard del C
* <assert.h>
* <ctype.h>
* <errno.h>
* <float.h>
* <iso646.h>
* <limits.h>
* <math.h>
* <stddef.h>
* <stdio.h>
* <stdlib.h>
* <string.h>
* <time.h>
* V · D · M

assert.h è l'header file della libreria standard del C che definisce la macro assert. Questa macro implementa un sistema di controllo delle asserzioni, che può essere utilizzato per verificare e controllare l'eventuale verificarsi di casi "impossibili" nel programma.

| Nome | Descrizione |
| - | - |
| assert | Quando questa macro viene eseguita, essa computa il risultato dell'espressione fornìtale: se essa risulta essere falsa (in altre parole, se il valore finale risulta essere 0), assert scrive alcune informazioni di debug su stderr e, successivamente, richiama la funzione abort. Le informazioni riportate su stderr includono: il testo dell'espressione che ha fornito il risultato 0 il nome del file sorgente (la macro predefinita __FILE__) il numero della linea in cui si è fallita l'asserzione (la macro predefinita __LINE__) |

L'utilità della macro assert risiede nella semplicità con la quale si può verificare un'affermazione che si ritiene, in un dato contesto, banalmente ovvia: ad esempio, ricontrollare il valore di una variabile sulla quale si sono già effettuate delle verifiche. Nel codice che segue, la macro assert viene utilizzata per controllare che il valore della variabile "scelta" sia effettivamente compreso nel range valido, nonostante l'uscita dal ciclo while implicitamente affermi la veridicità di questa condizione.

Utilizzando assert, il programmatore si accerta nuovamente che la condizione che aveva provocato l'uscita dal ciclo while sia ancora vera: in questo caso, ad esempio, verifica di non aver accidentalmente modificato il valore della variabile scelta all'interno del primo blocco di operazioni. L'utilizzo di assert dovrebbe essere limitato alla sola fase di sviluppo di un programma: per la brutalità del metodo di chiusura dell'eseguibile e per la scarsezza di informazioni sull'errore fornite a video, risulterebbe abbastanza frustrante per l'utente finale se utilizzato nella versione definitiva di un applicativo. Buona programmazione vorrebbe, infatti, che venga spiegato all'utente quale causa abbia scatenato il problema e, nel caso non fosse possibile proseguirne l'esecuzione, almeno permettere un salvataggio parziale dello stato del programma. Per questo, un codice simile a:

non rappresenta un uso ottimale di assert, perché, anche se raramente, è possibile che un'allocazione dinamica di memoria fallisca.

Quando il programmatore non ha più bisogno delle asserzioni, invece di eliminarle tutte manualmente può definire la costante NDEBUG prima di includere nel file sorgente l'header assert.h: in questo modo, la macro assert viene espansa semplicemente in:

eliminando quindi tutte le possibili interazioni con il programma. Bisogna quindi far notare che, in questo caso, l'espressione passata ad assert non viene valutata. Come espressioni inserite all'interno di assert vanno quindi assolutamente evitate quelle con effetti collaterali, come ad esempio

che finirebbero per modificare la logica del programma a seconda della definizione o meno della costante NDEBUG. In questo esempio, infatti, al termine della verifica dell'asserzione, il valore del puntatore i risulterebbe incrementato di una unità nel caso NDEBUG non sia definito, mentre resterebbe inalterato nel caso opposto.

