C: Declare vs Define в C и C++

Объявление (declaration) и определение (definition) в C и C++ имеют небольшое, но очень важное различие. Если не понимать его – то вас ожидают странные ошибки линкера (LD в GCC – /usr/bin/ld), вроде “undefined symbol foo“, “undefined reference to ‘foo’” или даже “undefined reference to vtable for foo” (в C++).

Что такое Объявление в C и C++

Когда вы объявляете переменную, функцию или класс, то все, что вы делаете – это просто говорите, что “вот есть что-то с таким-то именем и таким-то типом”. Далее компилятор (/usr/bin/gcc или /usr/bin/cc) может обработать все (но не все) случаи использования этого имени без необходимости полного описания этого имени. Объявление – без описания – позволяет писать понятный компилятору код, который он может понять без необходимости собирать все детали. Это особенно удобно когда вы работаете с кодом, который разбит на много файлов с исходным кодом и вам необходимо использовать функцию во многих из них. Вам не требуется писать все тело функции в каждом файле – но вам потребуется внести объявление об этой функции.

Итак, что такое Объявление?  Например:

int func();

Это – объявление функции. В нем нет тела функции, но компилятор будет знать что он может использовать это имя для доступа к этой функции, ожидая что она уже описана где-то в другом месте.

Что такое Описание в C и C++

Описание (или определение – defining) чего-то означает предоставление всей необходимой информации для создания этого чего-то. Описание функции означает предоставление тела функции. Описание класса – код всех его методов и атрибутов. Как только что-то описано – оно может считаться так же и объявленным. Вы часто можете встретить и объявление и описание функции, класса или переменной одновременно.

Например – только описания функции будет вполне достаточно для компилятора. Вы можете написать такой код:

#include <stdio.h>

int func();

int main()
{
    int x = func();
    printf("X == %dn", x);
}

int func()
{
    return 2;
}

Так как компилятор знает значение, возвращаемое функцией func() и количество аргументов функции из ее объявления – он может скомпилировать вызов к этой функции, даже при том, что у него еще нет ее описания. На деле – описание функции func() может находиться вообще в другом файле.

Вы так же можете объявить класс без его описания:

class MyClass;

Однако код, которому потребуются детали класса MyCalss не будет работать. Т.е. – вы не можете сделать что-то вроде такого:

class MyClass;

MyClass an_object;

class MyClass
{
    int _a_field;
};

Так как компилятору требуется знать размер переменной an_object – но он не может сделать, исходя только из объявления класса MyClass().

Объявление и Описание с использованием Extern

Как правило, когда вы объявляете переменную – то вы так же предоставляете и ее описание. Что такое “объявление” на самом деле?

Это значит, что вы указываете компилятору на необходимость создания хранилища в памяти для этой переменной. Например:

int x;
int main()
{
    x = 3;
}

Строка int x; выполняет и объявление и описание переменной. Фактически она говорит: “Создать переменную с именем x и типом integer. Кроме того – это будет глобальная переменная, описанная в объектом файле, связанном с файлом исходного кода“.

Это значит, что кто-то может написать еще один файл с таким кодом:

extern int x;

int func()
{
    x = 3;
}

Использование extern тут – это объявление переменной, но не ее описание. Тут говорится, что хранилищем для переменной находится где-то в другом месте. Технически, вы даже можете использовать такой код:

extern int x;
int func()
{
    x = 3;
}

int x;

Теперь у вас есть объявление переменной x в начале программы, и ее определение – внизу. Но как правило – extern используется тогда, когда вам требуется получить доступ к переменной, которая объявлена в другом файле, а затем, после компиляции – слинковать два объектных файла вместе.

Использование extern для объявления глобальной переменной весьма схоже с объявлением функций в заголовочных файлах (по факту – вам намного чаще придется использовать extern в заголовочных файлах, чем в исходном коде).

Кроме того – если вы разместите переменную в заголовочном файле и не будете использовать extern – вы столкнетесь с проблемой “неопределенного символа” (undefined symbol): у вас будет символ с несколькими определениями, что приведет к ошибке вида “redefinition of ‘foo’“, когда линкер начнет выполнять связывание нескльких объектных файлов.

Объявление (declaration) vs определение (definition): итог

Объявление предоставляет базовые атрибуты символа – его тип и имя. Определение включает в себя все остальные детали этого символа: если это функция – то описание ее действий, если класс – то его методы и атрибуты, если переменная – то место ее размещения. Зачастую компилятору требуется только объявление чего-либо для компиляции файла в объектный файл. В таких случаях компилятор ожидает, что линкер сможет сам найти определение в другом файле. Если не один файл не содержит описания символа, но в коде есть его объявление – вы получите сообщение об ошибке “undefined symbol” во время линковки.

Примеры использования

Если вы хотите использовать функцию в нескольких файлах исходного кода – вы должны объявить эту функцию в одном заголовочном файле (.h) а затем добавить ее описание в файле исходного кода (.c или .cpp). Весь код, который использует эту функцию должен включать в себе этот заголовочный файл.

Если вы хотите использовать некий класс в нескольких файлах – вам необходимо добавить его определение в заголовочный файл а его методы – определить в соответствующем файле исходного кода.

Если вы хотите использовать переменную в нескольких файлах – объявите ее с помощью ключевого слова extern в заголовочном файле, а затем подключите этот заголовочный файл в файлы исходного кода. Затем вам необходимо добавить определение этой переменной в файле исходного кода.

Оригинал и больше докментации – тут>>>.