Librerie di intestazione e errori di definizione multipli

Question

Desidero scrivere una libreria da utilizzare, è necessario includere solo un file di intestazione. Tuttavia, se hai più file sorgente e includi l'intestazione in entrambi, otterrai più errori di definizione, poiché la libreria è dichiarata e definita nell'intestazione. Ho visto le librerie di sola intestazione, in Boost, penso. Come hanno fatto?

Answer 1

dichiarare le funzioni inline, e metterli in uno spazio dei nomi in modo che non si scontrano:

namespace fancy_schmancy 
{ 
    inline void my_fn() 
    { 
    // magic happens 
    } 
}; 

Answer 2

Boost utilizza solo intestazioni librerie molto perché come lo STL, è per lo più costruito utilizzando i modelli con classe e funzionalità , che sono quasi sempre solo header.

Se non si scrivono i modelli, eviterò di includere il codice nei file di intestazione: è più un problema che non ne vale la pena. Rendi questa una semplice libreria statica.

Answer 3

Ci sono molte librerie Boost solo per intestazione, ma tendono ad essere molto semplici (e/o solo modelli). Le librerie più grandi ottengono lo stesso effetto attraverso alcuni trucchi: hanno "link automatico" (vedrai questo termine usato here). Essenzialmente hanno un gruppo di direttive per il preprocessore nelle intestazioni che individuano il file lib appropriato per la piattaforma e usano un #pragma per indicare al linker di collegarlo. Quindi non è necessario collegarlo esplicitamente, ma è ancora in corso linked.

Answer 4

Il motivo principale per cui Boost è in gran parte solo di intestazione è perché è fortemente orientato ai modelli. I modelli generalmente ottengono un passaggio dalla regola di una definizione. Infatti, per utilizzare efficacemente i modelli, è necessario che la definizione sia visibile in qualsiasi unità di traduzione che utilizza il modello.

Un altro modo per aggirare l'unica regola di definizione (ODR) è utilizzare le funzioni inline. In realtà, ottenere un free-pass dall'ODR è ciò che fa davvero lo inline - il fatto che potrebbe inline la funzione è davvero più un effetto collaterale opzionale.

Un'ultima opzione (ma probabilmente non altrettanto valida) è rendere statiche le tue funzioni. Questo può portare a un codice gonfio se il linker non è in grado di capire che tutte quelle istanze di funzione sono davvero le stesse. Ma lo cito per completezza. Si noti che i compilatori spesso integrano le funzioni static anche se non sono contrassegnati come inline.