ExpertiDict

C · Essencial · Português · Técnico

código de saída

/ˈkɔ.dʒi.gu dʒi saˈi.dɐ/substantivo

Número inteiro devolvido por main ao sistema operacional quando o programa termina. Zero indica sucesso, e qualquer outro valor indica erro.

Onde usar

Scripts e pipelines de CI decidem se um passo falhou olhando esse código. Use EXIT_SUCCESS e EXIT_FAILURE, de stdlib.h, para ficar portável.

Em código

#include <stdio.h>
#include <stdlib.h>
int main(void) {
  FILE *f = fopen("x.txt", "r");
  if (!f) return EXIT_FAILURE;
  fclose(f);
  return EXIT_SUCCESS;
}

Exemplos

O pipeline falhou porque o programa devolveu código de saída 1.

Retorne um código de saída diferente de zero quando o arquivo não abrir.

Cuidado

Usar códigos grandes: em sistemas Unix só os 8 bits menores chegam ao processo pai, então acima de 255 o valor é truncado.

Sinônimos

exit status, status de saída

Veja também

Todos os termos de C