fatal_esperado
Gerada por tools/gerar_documentacao.py. Definição: tests/run_biblioteca.sh:66.
Verifica que um modo do binário unitário termina com status 1 e diagnóstico esperado.
Tipo: função Shell · Visibilidade: pública · Arquivo: tests/run_biblioteca.sh.
Assinatura e expansão
fatal_esperado()
Como funciona
Executa o binário com o modo, captura stdout/stderr e exige rc 1 mais trecho literal em stderr.
Implementação
fatal_esperado() {
local modo="$1" trecho="$2" rc
"$TESTE" "$modo" > "$TMP/fatal.out" 2> "$TMP/fatal.err"
rc=$?
if [ "$rc" -eq 1 ] && grep -qF -- "$trecho" "$TMP/fatal.err"; then
printf ' ok erro esperado: %s\n' "$modo"
OK=$((OK + 1))
else
falha "erro esperado: $modo" "rc=$rc; $(head -2 "$TMP/fatal.err" | tr '\n' ' ')"
fi
}
Como este símbolo aparece nos testes
17 ocorrência(s) em 1 arquivo(s) de teste. Os links apontam para linhas exatas; os trechos mostram o contexto local. Uma menção não prova que todos os ramos foi executado.
tests/run_biblioteca.sh
Contexto: run_biblioteca.sh. Linhas: 93, 94, 95, 97, 98, 99, 100, 101, 102, 103, 104, 107, 109, 110, 111, 112, 113. Tipo de evidência: código; via fatal_esperado.
Linhas 91–115 · abrir contexto
}
fatal_esperado erro 'teste.c:37: erro: falha esperada'
fatal_esperado passo 'teste.c:38: erro: PARA_PASSO: passo zero'
fatal_esperado divide-zero 'teste.c:39: erro: divisao por zero'
representabilidade_esperada divide-estouro 'estouro em divisao inteira (INT_MIN / -1)' 'divisao por -1'
fatal_esperado divide-zero-l 'teste.c:43: erro: divisao por zero'
fatal_esperado divide-zero-ll 'teste.c:44: erro: divisao por zero'
fatal_esperado divide-zero-u 'teste.c:45: erro: divisao por zero'
fatal_esperado divide-zero-ul 'teste.c:46: erro: divisao por zero'
fatal_esperado divide-zero-ull 'teste.c:47: erro: divisao por zero'
fatal_esperado divide-zero-f 'teste.c:48: erro: divisao por zero (real)'
fatal_esperado divide-zero-d 'teste.c:49: erro: divisao por zero (real)'
fatal_esperado divide-zero-ld 'teste.c:50: erro: divisao por zero (real)'
representabilidade_esperada divide-estouro-l 'estouro em divisao inteira (LONG_MIN / -1)' 'divisao por -1'
representabilidade_esperada divide-estouro-ll 'estouro em divisao inteira (LLONG_MIN / -1)' 'divisao por -1'
fatal_esperado resto-zero 'teste.c:41: erro: resto por zero'
representabilidade_esperada resto-estouro 'estouro em resto inteiro (INT_MIN % -1)' 'resto por -1'
fatal_esperado resto-zero-l 'teste.c:51: erro: resto por zero'
fatal_esperado resto-zero-ll 'teste.c:52: erro: resto por zero'
fatal_esperado resto-zero-u 'teste.c:53: erro: resto por zero'
fatal_esperado resto-zero-ul 'teste.c:54: erro: resto por zero'
fatal_esperado resto-zero-ull 'teste.c:55: erro: resto por zero'
representabilidade_esperada resto-estouro-l 'estouro em resto inteiro (LONG_MIN % -1)' 'resto por -1'
representabilidade_esperada resto-estouro-ll 'estouro em resto inteiro (LLONG_MIN % -1)' 'resto por -1'
Compiladores, padrão C e sistema operacional
Nenhum ramo condicional externo foi detectado para este símbolo. A implementação é compartilhada no fonte; isso não certifica compiladores ou sistemas não executados.
- Runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2. Não é um script CMD/PowerShell.
A matriz histórica distingue executado, compilado, avaliado e não testado. Consulte a matriz, os compiladores e os logs atuais dos workflows antes de chamar um alvo de suportado.
Perguntas frequentes
Perguntas reunidas a partir da definição, do contrato editorial e dos testes de fatal_esperado. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que fatal_esperado faz?
Verifica que um modo do binário unitário termina com status 1 e diagnóstico esperado.
Qual é a assinatura e o tipo de retorno de fatal_esperado?
Assinatura extraída de tests/run_biblioteca.sh; visibilidade pública.
fatal_esperado()
Como fatal_esperado aparece em código real deste repositório?
Uso extraído de tests/run_biblioteca.sh:91, com as linhas vizinhas preservadas:
}
fatal_esperado erro 'teste.c:37: erro: falha esperada'
fatal_esperado passo 'teste.c:38: erro: PARA_PASSO: passo zero'
fatal_esperado divide-zero 'teste.c:39: erro: divisao por zero'
Onde fatal_esperado é exercitado nos testes?
Há 17 ocorrência(s) em 1 arquivo(s): tests/run_biblioteca.sh. Os links da seção de evidência apontam para a linha exata; uma menção não prova que todos os ramos foram executados.
fatal_esperado depende de compilador, padrão C ou sistema operacional?
fatal_esperado é uma função de runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2, não CMD/PowerShell.
O que acontece em caso de falha ou uso inválido?
Não há ressalva editorial específica para este nome. O comportamento em falha é o do corpo/expansão mostrado acima; não invente validação que o fonte não faz.