Vamos começar pela diretiva include, depois prosseguiremos com o nosso exemplo (durante todo o artigo iremos abordar um só exemplo). Para programas escritos em C, antes da compilação propriamente dita, há um processo que chamamos de pré-compilação.

O papel das diretivas é instruir o pré-processador (parte do compilador responsável pelo pré-processamento) a realizar determinadas tarefas.

A diretiva define, por exemplo, instrui o pré-processador a substituir um texto por outro texto no código-fonte do programa.

A diretiva include instrui o pré-processador a incluir num arquivo-fonte o conteúdo de um outro arquivo, geralmente chamado de header file (arquivo de cabeçalho). Estes arquivos de cabeçalho tem extensão .h, como em stdio.h.

Nosso exemplo constará de 3 arquivos:

• main.c;
• metodos.h;
• e metodos.c.

Convencionalmente, arquivos terminados com extensão .c são arquivos-fonte escritos em C. E, como dito antes, arquivos com extensão .h são arquivos de cabeçalho. Os arquivos de cabeçalhos geralmente contém declarações de funções e variáveis definidas em outros arquivos com extensão .c. Isso é necessário e importante, pois centraliza todas as declarações de um ou mais arquivos fontes em um ou mais arquivos de cabeçalho.

Se quisermos usar os métodos definidos em metodos.c em main.c, devemos colocar uma declaração include no arquivo main.c "apontando" para o arquivo metodos.h. Vamos começar o nosso exemplo. Na sua pasta pessoal crie outra pasta com o nome "projetoC". Agora crie os seguintes arquivos dentro da pasta projetoC:

Arquivo metodos.c:

Arquivo metodos.h:

Arquivo main.c:

Explicando um pouco:

O arquivo main.c contém duas diretivas include. Observe que há duas formas diferentes de incluir um arquivo: usando aspas e usando os símbolos < e >.

O uso de aspas indica ao pré-processador a buscar o arquivo inicialmente dentro do diretório onde main.c está e só depois procurar em outros diretórios .

O uso dos símbolos < e > instrui o pré-processador a buscar o arquivo incluído no diretório include padrão do compilador ou do sistema. No caso do Linux esse diretório pode ser /usr/include. No entanto, o padrão ANSI/C deixa a coisa um pouco solta, permitindo assim flexibilidade para os compiladores adaptarem a idéia de acordo com a plataforma onde os programas compilados serão executados.

Na próxima página irei abordar como criar um Makefile para o exemplo dado. A partir do arquivo Makefile apresentado, você terá a base para compreender outros mais complexos.