0Pricing
Zig Academy · Aula

extern struct e layout ABI

Reproduza o layout de memória de uma struct C.

extern struct e layout ABI é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 4 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.

Conversar com C

Quando Zig chama código C, os dois lados precisam concordar sobre o layout da memória. Esse contrato compartilhado é a ABI.

Structs Comuns Não São Garantidas

Uma estrutura comum permite que Zig escolha livremente a ordem dos campos e o preenchimento, portanto o layout pode não corresponder ao que uma biblioteca C espera.

Conheça a estrutura externa

Marque um tipo como estrutura externa e Zig organizará seus campos usando o ABI de C, correspondendo campo a campo a uma estrutura C.

const Point = extern struct {
    x: i32,
    y: i32,
};

Os campos permanecem na ordem

Uma estrutura externa mantém sua ordem de declaração, assim como C, portanto o primeiro campo sempre vem primeiro na memória.

Preenchimento como em C

Ao contrário de uma estrutura compactada, a estrutura externa ainda adiciona preenchimento para alinhamento, exatamente como faria um compilador C.

Compactada versus externa

Use compactada para um layout exato em nível de bits e externa para corresponder ao layout de bytes de C. Elas resolvem problemas de layout diferentes.

Passe estruturas para C

Uma estrutura externa pode ser passada diretamente para uma função C, pois seu layout corresponde ao cabeçalho com o qual a função foi compilada.

extern fn use_point(p: Point) void;

Verifique o tamanho

Confirme se uma estrutura externa corresponde a C usando @sizeOf, que informa o total de bytes, incluindo qualquer preenchimento de alinhamento.

const n = @sizeOf(Point); // 8

Inspecione os deslocamentos dos campos

Use @offsetOf para ver exatamente onde cada campo começa; isso é ótimo para verificar se uma estrutura está alinhada com C.

const off = @offsetOf(Point, "y"); // 4

Somente tipos compatíveis com C

Os campos de uma estrutura externa devem ser tipos compatíveis com C, portanto estruturas exclusivas de Zig, como fatias, não são permitidas nela.

A ponte para C

Juntos, a estrutura externa e o ABI de C permitem que Zig e C compartilhem dados de forma segura, sem cópia nem suposições sobre o layout. 🔗

Verificação rápida

Relembre com o que a estrutura externa foi projetada para corresponder.

Recapitulação

Você aprendeu que a estrutura externa corresponde ao ABI de C: campos ordenados com preenchimento no estilo de C, passáveis para C e verificáveis com @sizeOf e @offsetOf. 🎉

Perguntas Frequentes

A aula “extern struct e layout ABI” é grátis?

Sim — o texto completo de “extern struct e layout ABI” é 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 “extern struct e layout ABI”?

Reproduza o layout de memória de uma struct C. 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 4 de 4.

Quanto tempo leva a aula “extern struct e layout ABI”?

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. struct empacotada para layout exato
  2. Inteiros de largura arbitrária, como u3
  3. Campos de bits e sinalizadores
  4. extern struct e layout ABI
← Voltar para Zig Academy