Arquivos de cabeçalho e de código-fonte
Separe declarações e código.
Arquivos de cabeçalho e de código-fonte é uma aula grátis de C Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de C Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de C Academy inclui 4 aulas no total.
Por que dividir o código em arquivos?
À medida que os programas em C crescem, manter tudo em um único arquivo .c fica difícil de ler e torna a compilação mais lenta.
C permite dividir um projeto em vários arquivos: cada um cuida de uma responsabilidade. Isso melhora a organização, permite reutilizar o código e faz com que alterar uma parte não obrigue você a recompilar tudo.
Dois tipos de arquivos
Um projeto modular em C usa dois tipos de arquivo.
Arquivos-fonte (.c) contêm a implementação propriamente dita: corpos e definições de funções.
Arquivos de cabeçalho (.h) contêm declarações: protótipos de funções, definições de tipos e macros que outros arquivos precisam conhecer.
Um arquivo de cabeçalho
Um cabeçalho declara o que existe sem dizer como funciona.
Aqui, math_utils.h declara uma função add. Qualquer arquivo que inclua esse cabeçalho conhece a assinatura da função e pode chamá-la.
/* math_utils.h */
int add(int a, int b);O arquivo-fonte correspondente
O arquivo-fonte fornece a implementação. Ele inclui seu próprio cabeçalho para que o compilador possa verificar se a definição corresponde à declaração.
Observe que o cabeçalho é incluído entre aspas, forma usada para os arquivos do seu próprio projeto.
/* math_utils.c */
#include "math_utils.h"
int add(int a, int b) {
return a + b;
}Usando o módulo
Agora, main.c inclui o cabeçalho e chama add. Ele nunca vê o corpo da função, apenas o protótipo.
O compilador confia na declaração; depois, o vinculador conecta a chamada à implementação real em math_utils.c.
/* main.c */
#include <stdio.h>
#include "math_utils.h"
int main(void) {
printf("%d\n", add(2, 3));
return 0;
}Aspas e colchetes angulares
A diretiva #include tem duas formas.
#include <stdio.h> usa colchetes angulares para cabeçalhos do sistema e da biblioteca padrão. O compilador procura nos caminhos de inclusão padrão.
#include "math_utils.h" usa aspas para os seus próprios cabeçalhos, que são procurados primeiro no diretório atual.
#include <stdio.h> /* standard library */
#include "math_utils.h" /* your project */O que deve estar em um cabeçalho
Coloque declarações nos cabeçalhos, não definições.
Conteúdos adequados para um cabeçalho: protótipos de funções, declarações de struct e typedef, macros #define e declarações de variáveis extern.
Evite colocar corpos de funções ou definições de variáveis ali, pois isso pode causar erros de símbolos duplicados.
/* shapes.h */
typedef struct {
double width;
double height;
} Rect;
double rect_area(Rect r);O que deve estar em um arquivo-fonte
O arquivo-fonte contém o trabalho real: definições de funções e as funções auxiliares privadas do arquivo.
Ele inclui o cabeçalho correspondente para que o compilador verifique se as assinaturas coincidem. Isso detecta incompatibilidades antecipadamente, em vez de no momento da vinculação.
/* shapes.c */
#include "shapes.h"
double rect_area(Rect r) {
return r.width * r.height;
}Declaração versus definição
Essa distinção é fundamental para C modular.
Uma declaração informa ao compilador o tipo e a assinatura de um nome para que ele possa ser usado: int add(int, int);
Uma definição cria a entidade real, alocando armazenamento ou fornecendo o corpo. Os cabeçalhos declaram; os arquivos-fonte definem.
int add(int a, int b); /* declaration */
int add(int a, int b) { /* definition */
return a + b;
}Convenções de nomenclatura
Um padrão comum associa cada módulo pelo nome: logger.h com logger.c, parser.h com parser.c.
Isso torna evidente onde está a implementação. Reúna funções relacionadas em um único módulo para que cada arquivo tenha uma responsabilidade clara e única.
/* logger.h */
void log_info(const char *msg);
void log_error(const char *msg);Visão geral da compilação
Cada arquivo .c é compilado independentemente em um arquivo-objeto; depois, todos os objetos são vinculados em um único programa.
Os cabeçalhos não são compilados por conta própria; eles são inseridos textualmente nos arquivos-fonte que os incluem. Exploraremos todo o fluxo de compilação em uma lição posterior.
gcc -c main.c /* -> main.o */
gcc -c math_utils.c /* -> math_utils.o */
gcc main.o math_utils.o -o appVerificação rápida
Teste sua compreensão das funções dos cabeçalhos e dos arquivos-fonte.
Recapitulação
Você aprendeu a dividir um projeto em C em cabeçalhos .h e arquivos-fonte .c.
Os cabeçalhos declaram o que existe; os arquivos-fonte definem como funciona. Use aspas para os seus próprios cabeçalhos e colchetes angulares para os cabeçalhos padrão.
Em seguida, evitaremos problemas causados pela inclusão de um cabeçalho mais de uma vez.
Perguntas Frequentes
A aula “Arquivos de cabeçalho e de código-fonte” é grátis?
Sim — o texto completo de “Arquivos de cabeçalho e de código-fonte” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de C Academy, atualize para CoddyKit PRO. O curso de C Academy inclui 4 aulas no total.
O que vou aprender em “Arquivos de cabeçalho e de código-fonte”?
Separe declarações e código. Você pratica C Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar C Academy?
Nenhuma experiência prévia é necessária. C Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Arquivos de cabeçalho e de código-fonte”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de C Academy?
Sim. Cada aula de C Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Arquivos de cabeçalho e de código-fonte
- Guardas de inclusão
- extern e ligação
- Compilando vários arquivos