Include guard: differenze tra le versioni

Versione delle 16:07, 24 mar 2008

Versione attuale delle 13:07, 27 gen 2024

(30 versioni intermedie di 22 utenti non mostrate)

Riga 1:

{{F|linguaggi di programmazione|febbraio 2013}}

Nei linguaggi [[C (linguaggio)|C]] e [[C++]], le #'''include guard''' sono delle particolari direttive (o [[Macro (informatica)|macro]]) che vengono usate nei file header per evitare problemi di averedoppia spiacevoli erroridefinizione in fase di linking. In alcuni casi è proprio impossibile farne a meno, specialmente se il progetto inizia ad avere molti file sorgenti.

== Esempio ==

Vediamo ora un esempio di utilizzo delle #include guard. Supponiamo di avere 3 file sorgenti:

Supponiamo di avere 3 file sorgenti senza #include guard:

File=== '''<kbd>persona.h'''</kbd> ===

<sourcesyntaxhighlight lang="Cpp">

class persona

{

// definizionedichiarazione

};

</syntaxhighlight>

</source>

File=== '''<kbd>impiegato.h'''</kbd> ===

<sourcesyntaxhighlight lang="Cpp">

#include "persona.h"

class impiegato : public persona

{

// definizionedichiarazione

};

</syntaxhighlight>

</source>

File=== '''<kbd>main.cpp'''</kbd> ===

<sourcesyntaxhighlight lang="Cpp">

#include "persona.h"

#include "impiegato.h"

Riga 34 ⟶ 36:

impiegato i;

}

</syntaxhighlight>

</source>

== Compilazione ==

In fase di compilazione, verranno creati 3 file oggetto:

In fase di compilazione, verrà creato un file oggetto: main.o Gli header files vengono inclusi nel file sorgente main.cpp ovvero il loro contenuto viene copiato dal [[preprocessore]] all'inizio del file main.cpp prima della compilazione.

# persona.o che contiene la dichiarazione e definizione di una persona;

# impiegato.o che contiene la dichiarazione e definizione di un impiegato e ''la dichiarazione di una persona'';

# main.o che contiene tutto ciò che serve al main.

Senza interessarci delle implementazioni di persona e impiegato, il nostro obiettivo sarà quello di usare indistintamente una persona o un impiegato (ed i relativi metodi). Quando il linker andrà a creare l'eseguibile definitivo, avrà però una doppia dichiarazione di persona e rilascieràrilascerà un errore di linkaggio. Infatti la classe persona sarà definita sia nel file <kbd>persona.o</kbd> che nel file <kbd>impiegato.o</kbd>. In quest'ultimo caso, quello del file <kbd>impiegato.o</kbd>, è necessario inserire la dichiarazione di persona per via della direttiva #include specificata.

Per non avere questo tipo di problema basta utilizzare le #include guard in questa maniera:

File=== '''<kbd>persona.h'''</kbd> ===

<sourcesyntaxhighlight lang="Cpp">

#ifndef H_PERSONAPERSONA_H

#define H_PERSONAPERSONA_H

// tutto il resto

#endif // PERSONA_H

</syntaxhighlight>

</source>

Con questo ''trucchetto''accorgimento, la prima volta che viene incluso <kbd>persona.h</kbd>, il simbolo H_PERSONA'''PERSONA_H''' non è ancora stato definito, e di conseguenza viene creato. Le successive volte che viene incluso <kbd>persona.h</kbd>, il simbolo H_PERSONA'''PERSONA_H''' è definito, perciò la parte relativa alla definizione della classe persona non viene tenuta in considerazione.

Di buona norma le #include guard devono essere inserite in tutti i file <kbd>.h</kbd> in modo da assicurare una maggiore trasparenza al programmatore evitando di incorrere in questo tipo di errore.

==#pragma once==

[[en:Include guard]]

[[zh:Include防範]]

La seguente è un'alternativa equivalente agli include guard ma più breve e più semplice e a volte incrementa la velocità di compilazione.

=== <kbd>persona.h</kbd> ===

<syntaxhighlight lang="Cpp">

#pragma once

//tutto il resto

</syntaxhighlight>

Indica che il file deve essere incluso una sola volta nella compilazione.

===Portabilità===

Nonostante questa direttiva non sia definita negli standard del C/C++, è definita in quasi tutti i compilatori.

{| class="wikitable sortable"

|-

! Compiler

! #pragma once

|-

| [[Clang]] || Supportato

|-

| [[Comeau C/C++]] || Supportato

|-

| [[C++Builder XE3]] || Supportato

|-

| [[Digital Mars C++]] || Supportato

|-

| [[GNU Compiler Collection|GCC]] || Supportato

|-

| [[HP aC++|HP C/aC++]] || Supportato

|-

| [[IBM XL C++|IBM XL C/C++]] || Supportato

|-

| [[Intel C++ Compiler]] || Supportato

|-

| [[Microsoft Visual C++]] || Supportato

|-

| [[Pelles C]] || Supportato

|-

| [[ARM DS-5]] || Supportato

|-

| [[IAR C/C++]] || Supportato

|-

| [[Oracle Solaris Studio|Solaris Studio C/C++]] || Non supportato

|}

{{C++}}

{{portale|informatica}}

[[Categoria:C]]

[[Categoria:C++]]