#ifndef

Sintaxis

#ifndef <identificador>

          ...

          <instruções>

          ...

[ #else ]

          ...

          <instruções>

          ...

[ #endif ]

Propósito

La directiva #ifndef compila una sección del código fuente solamente si no se definió un determinado identificador.

Argumentos

<identificador>

Define el nombre del identificador que se pondrá a prueba para comprobar su inexistencia.

Utilización

La directiva #ifndef ... #endif permite realizar las compilaciones condicionales. La compilación condicional permite que un determinado trecho de código fuente se compile o no, dependiendo de la inexistencia o no de un identificador. Un identificador se puede definir por medio de la directiva #define.

Si se especifica la cláusula #else y el identificador no existe, se compilará el trecho de código entre el #ifndef y el #else. Si el identificador existe, lo que se compilará es el trecho de código entre el #else y el #endif.

Si la cláusula #else no se especifica y el identificador no existe, se compilará el trecho del código entre el #ifndef y el #endif. Si el identificador existe, este trecho de código no se compilará.

Sugerencias

La compilación condicional es útil principalmente cuando es necesario hacer el mantenimiento de diferentes versiones del mismo programa. Para cada versión se compilará un determinado trecho de código diferente, de acuerdo con los identificadores que se especifiquen.

La directiva #ifndef ... #endif es el inverso de la directiva #ifdef ... #endif.