C - Include e Makefile
Este artigo tem o objetivo de explicar e orientar o uso da diretiva include e do uso de Makefile em seus projetos. Suponho que você tenha um pouco (não precisa ser muito) de conhecimento em C e saiba usar o compilador gcc sobre o GNU/Linux.
A diretiva include
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:
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:
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:
#include <stdio.h>
static int global;
void IniciaGlobal()
{
global = 0;
}
int GetGlobal()
{
return global;
}
void Metodo1()
{
printf("metod 1");
global++;
}
void Metodo2()
{
printf("metodo 2");
global++;
}
static int global;
void IniciaGlobal()
{
global = 0;
}
int GetGlobal()
{
return global;
}
void Metodo1()
{
printf("metod 1");
global++;
}
void Metodo2()
{
printf("metodo 2");
global++;
}
Arquivo metodos.h:
#ifndef METODOS_H
#define METODOS_H
void IniciaGlobal();
int GetGlobal();
void Metodo1();
void Metodo2();
#endif
#define METODOS_H
void IniciaGlobal();
int GetGlobal();
void Metodo1();
void Metodo2();
#endif
Arquivo main.c:
include "metodos.h"
include <stdio.h>
main()
{
IniciaGlobal();
Metodo1();
printf("\n");
Metodo2();
printf("\n Número de acessos aos metodos do arquivo metodos.c = %d",GetGlobal());
return 0;
}
include <stdio.h>
main()
{
IniciaGlobal();
Metodo1();
printf("\n");
Metodo2();
printf("\n Número de acessos aos metodos do arquivo metodos.c = %d",GetGlobal());
return 0;
}
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.