Projetos em C com múltiplos arquivos

Exemplo de header + source

// declarations only
#ifndef MATHUTIL_H
#define MATHUTIL_H

int add(int a, int b);
int mul(int a, int b);
int factorial(int n);

#endif

#include "mathutil.h"

int add(int a, int b) {
    return a + b;
}

int mul(int a, int b) {
    return a * b;
}

int factorial(int n) {
    if (n <= 1) return 1;
    return n * factorial(n - 1);
}

#include <stdio.h>
#include "mathutil.h"

int main(void) {
    printf("2+3 = %d\n", add(2, 3));
    printf("4*5 = %d\n", mul(4, 5));
    printf("5! = %d\n", factorial(5));
    return 0;
}

Fluxo de build e opções do gcc

Construa os três de uma vez

Separando os estágios (a base do build incremental)

Flags comuns do gcc

include guards e extern

Por que você precisa de um include guard

// top and bottom of mathutil.h
#ifndef MATHUTIL_H
#define MATHUTIL_H

/* header contents */

#endif

Compartilhando uma variável global com extern

#ifndef CONFIG_H
#define CONFIG_H

extern int g_verbose;   // declaration only

#endif

#include "config.h"

int g_verbose = 0;      // the one and only definition

Noções básicas de Makefile

Makefile mínimo

# Makefile — filename must start with capital M
# IMPORTANT: lines under a target must start with a TAB character

app: main.o mathutil.o
	gcc main.o mathutil.o -o app

main.o: main.c mathutil.h
	gcc -c main.c

mathutil.o: mathutil.c mathutil.h
	gcc -c mathutil.c

clean:
	rm -f *.o app

Usando variáveis e regras implícitas

CC      = gcc
CFLAGS  = -Wall -Wextra -O2 -g
OBJS    = main.o mathutil.o
TARGET  = app

$(TARGET): $(OBJS)
	$(CC) $(OBJS) -o $(TARGET)

# implicit rule handles .c → .o automatically
main.o: main.c mathutil.h
mathutil.o: mathutil.c mathutil.h

clean:
	rm -f $(OBJS) $(TARGET)

.PHONY: clean

Dependências geradas automaticamente (avançado)

CFLAGS += -MMD
-include $(OBJS:.o=.d)

Desafios