0Pricing
Zig Academy · Aula

Importando cabeçalhos C com @cImport

Use declarações C a partir de Zig.

Importando cabeçalhos C com @cImport é uma aula grátis de Zig 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 Zig Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Zig Academy inclui 4 aulas no total.

Zig conversa com C

Zig pode usar bibliotecas C diretamente, sem uma camada separada de vinculação. A ponte começa com o @cImport integrado.

O que @cImport faz

@cImport executa o compilador C de Zig em um pequeno arquivo C que você descreve e então expõe cada declaração encontrada como um espaço de nomes normal de Zig.

Inclua um cabeçalho

Dentro da chamada, liste os cabeçalhos com @cInclude. Cada um nomeia um cabeçalho C, assim como uma linha #include de C faria.

const c = @cImport({
    @cInclude("stdio.h");
});

Um espaço de nomes de C

O resultado é uma const comum de Zig. Você acessa os nomes de C por meio dela usando a sintaxe de ponto, exatamente como em qualquer outro espaço de nomes de estrutura de Zig.

c.printf("hi\n");

Chame no nível superior

Coloque o @cImport no escopo do arquivo para que o módulo inteiro possa usá-lo. Ele é avaliado uma vez no tempo de compilação, não em tempo de execução.

Vários cabeçalhos

Um @cImport pode trazer vários cabeçalhos. Adicione mais linhas @cInclude, e todas compartilharão um único espaço de nomes combinado.

const c = @cImport({
    @cInclude("stdio.h");
    @cInclude("stdlib.h");
});

Defina macros primeiro

Use @cDefine antes de uma inclusão para definir uma macro C, assim como você passaria uma opção -D para um compilador C.

const c = @cImport({
    @cDefine("_GNU_SOURCE", "");
    @cInclude("stdio.h");
});

Remova a definição se necessário

O @cUndef correspondente remove uma macro antes que os cabeçalhos sejam analisados, caso um valor padrão pudesse atrapalhar.

Isso ocorre no tempo de compilação

Tudo dentro de @cImport acontece no tempo de compilação. Zig analisa o C, faz sua tradução e fornece declarações de Zig prontas para uso.

As constantes são trazidas

Macros C que se expandem para valores simples tornam-se constantes utilizáveis em Zig, portanto itens como EXIT_SUCCESS ficam disponíveis no espaço de nomes.

return c.EXIT_SUCCESS;

Uma ponte, C de verdade

Com um único @cImport, você obtém as funções, os tipos e as constantes de uma biblioteca C inteira, todos chamáveis a partir de um código Zig idiomático.

Verificação rápida

Relembre qual elemento integrado traz declarações C para Zig.

Recapitulação

Você viu que @cImport com @cInclude transforma cabeçalhos C em um espaço de nomes de Zig no tempo de compilação, fornecendo diretamente funções e constantes de C. 🎯

Perguntas Frequentes

A aula “Importando cabeçalhos C com @cImport” é grátis?

Sim — o texto completo de “Importando cabeçalhos C com @cImport” é 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 Zig Academy, atualize para CoddyKit PRO. O curso de Zig Academy inclui 4 aulas no total.

O que vou aprender em “Importando cabeçalhos C com @cImport”?

Use declarações C a partir de Zig. Você pratica Zig 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 Zig Academy?

Nenhuma experiência prévia é necessária. Zig 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 “Importando cabeçalhos C com @cImport”?

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 Zig Academy?

Sim. Cada aula de Zig 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

  1. Importando cabeçalhos C com @cImport
  2. Chamando funções C e vinculando bibliotecas
  3. Ponteiros, strings e tipos C
  4. zig translate-c para ler C como Zig
← Voltar para Zig Academy