Escrevendo a saída e códigos de saída
Relate os resultados e sinalize o status.
Escrevendo a saída e códigos de saída é uma aula grátis de Zig Academy no CoddyKit. Esta é a aula 3 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.
As ferramentas respondem
Ler a entrada é metade do trabalho. Uma CLI concluída também escreve a saída e sinaliza sucesso ou falha para o que a executou. 📤
Dois fluxos de saída
Os programas têm dois canais: saída padrão para resultados normais e saída de erro para mensagens e erros. Mantê-los separados permite que os usuários redirecionem os resultados com facilidade.
Obtenha o writer da saída padrão
Use std.io.getStdOut e solicite um writer. Esse writer é o seu meio de enviar a saída normal para o terminal.
const out = std.io.getStdOut().writer();Imprima com print
O método print de um writer formata e escreve em uma única chamada, usando a mesma string de formato e a tupla de argumentos que você já conhece.
try out.print("Result: {d}\n", .{total});Escrever pode falhar
A saída vai para um fluxo real que pode estar fechado, então as escritas retornam um erro. É por isso que try aparece antes de cada print.
Os erros vão para a saída de erro
Envie avisos e falhas para std.io.getStdErr para que não contaminem os resultados redirecionados. Os usuários podem ler os erros enquanto os dados continuam fluindo.
const err = std.io.getStdErr().writer();Saída rápida para depuração
Para registros rudimentares, std.debug.print escreve diretamente na saída de erro sem precisar de try. É útil durante o desenvolvimento, não para a saída real.
std.debug.print("loaded {d} items\n", .{count});A convenção do código de saída
Quando o programa termina, ele retorna um número. Zero significa sucesso; qualquer valor diferente de zero informa ao shell que algo deu errado.
main pode retornar erros
Dê a main o tipo de retorno !void. Se um erro escapar, Zig imprimirá um rastreamento e encerrará o programa com um código diferente de zero.
pub fn main() !void {}Escolha seu próprio código
Precisa de um status específico? Chame std.process.exit com um u8. Isso encerra o programa imediatamente com exatamente esse código de saída.
std.process.exit(2);Descarregue o buffer antes de sair
Se você usou um buffered writer, chame flush() antes de sair. Caso contrário, o texto armazenado no buffer talvez nunca chegue ao terminal.
try bw.flush();Verificação rápida
Lembre-se do que um código de saída informa ao shell que iniciou sua ferramenta.
Recapitulação
Você escreveu os resultados na saída padrão, os erros na saída de erro, usou try em cada escrita e terminou com um código de saída claro. Sua ferramenta comunica-se corretamente. 🎯
Aprenda Zig com um tutor de IA — grátis
Escreva e execute código real no seu navegador, obtenha ajuda instantânea de um tutor de IA 24/7 e continue de onde parou na web ou no app.
- Cursos
- 30
- Aulas
- 120
Perguntas Frequentes
A aula “Escrevendo a saída e códigos de saída” é grátis?
Sim — o texto completo de “Escrevendo a saída e códigos de saída” é 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 “Escrevendo a saída e códigos de saída”?
Relate os resultados e sinalize o status. 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 3 de 4.
Quanto tempo leva a aula “Escrevendo a saída e códigos de saída”?
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
- Lendo argumentos da linha de comando
- Lendo arquivos e stdin
- Escrevendo a saída e códigos de saída
- Empacotando e lançando o binário