Head File

Head file (.h) é um arquivo de texto com códigos C que será processado de forma diferente do arquivo .c e que possibilita a melhor estruturação de um programa, sendo possível estruturar o código de uma forma mais organizada, possibilitando a criação de bibliotecas (nada parecido com python), deixando o programa mais estruturado.

Para isso funcionar direito o head file deve possuir um recurso que iniba a inclusão redundante (mais de uma vez) no processo de compilação, evitando a redefinição de defines, tipos ou funções. Além desse recurso, não podemos ter no arquivo .h códigos que gerem instruções (ou seja, não podemos implementar uma função no head)!

Exemplo

O exemplo a seguir demonstra um uso errado do arquivo .h:

// main.h
int var; 

int bar(int b) {
    if (b > 2) 
        return 0;
    return 1;
}

// main.c
#include "main.h"

int main(void){
    int a = bar(12);
}

O código anterior viola a regra 2.0 e a regra 2.1 gerando o seguinte erro:

Forma correta

Para desenvolvermos bons códigos em C devemos usar a seguinte estrutura de arquivos .c e .h:

• .c: É onde efetivamente implementamos nossos códigos que geram instruções.
• .h: Arquivo de cabećalho que auxilia na organizacão do código.

O diagrama a seguir ilustra como devemos tratar os diferentes tipos de arquivos:

Estes arquivos quando compilados devem gerar arquivos .o¹, reparem que o arquivo foo.c virou um objeto foo.o, isso otimiza todo o processo de compilação, o gcc não precisa recompilar o foo.c se não ouve mudancas nele.

Mas para isso funcionar corretamente temos que implementar algo chamado de include guard nos arquivos .h, o include guard limita a inclusão do head apenas uma vez no processo de compilação. O código correta fica assim:

// main.c
#include "bar.h"

void main(){...}

// bar.h
#ifndef BAR_H
#define BAR_H

int bar(int b);

#endif

// bar.c
#include "bar.h"

int bar(int b){
...
}

void led(coid){
    pio_set(...); 
    pio_clear(...);
}

#ifndef PISCA_H
#define PISCA_H

#include "pisca.h"

#endif        

#ifndef PISCA_H
#define PISCA_H

#include "pisca.h"

#endif

#include "pisca.h"

void led(coid){
    pio_set(...); 
    pio_clear(...);
}

#ifndef PISCA_H
#define PISCA_H

#include "pisca.h"

void led(coid);

#endif

#include "pisca.h"

void led(coid){
    pio_set(...); 
    pio_clear(...); 
}

Praticando

Vamos praticar um pouco e corrigir as regras básicas de qualidade de código e boas práticas em sistemas embarcados, para isso crie um repositório pelo github classroom e então modifique os arquivos conforme indicado.