resultado_confere
Gerada por tools/gerar_documentacao.py. Definição: tests/lib.sh:148.
Compara o resultado de um caso com o contrato principal ou alternativo.
Tipo: função Shell · Visibilidade: pública · Arquivo: tests/lib.sh.
Assinatura e expansão
resultado_confere()
Como funciona
Confere status e stdout; stderr esperado é procurado como trecho literal. A alternativa só é tentada quando existe e pode exigir stderr vazio.
- Saída alternativa não é aprovação genérica: precisa corresponder ao conjunto declarado para aquele caso.
Comentário do fonte
Compara com o resultado principal ou, para casos dependentes de C11/plataforma, com o conjunto opcional alternativo (alternativo.txt, alternativo_rc.txt, etc.).
Implementação
resultado_confere() {
local dir="$1" rc="$2" saida="$3" erros="$4"
local rc_esperado="0" alt_rc="0"
[ -f "$dir/esperado_rc.txt" ] && rc_esperado="$(cat "$dir/esperado_rc.txt")"
if [ "$rc" = "$rc_esperado" ] && ! difere "$dir/esperado.txt" "$saida"; then
if [ ! -f "$dir/esperado_stderr.txt" ] \
|| grep -qF -- "$(cat "$dir/esperado_stderr.txt")" "$erros"; then
return 0
fi
fi
[ -f "$dir/alternativo.txt" ] || return 1
[ -f "$dir/alternativo_rc.txt" ] && alt_rc="$(cat "$dir/alternativo_rc.txt")"
[ "$rc" = "$alt_rc" ] || return 1
difere "$dir/alternativo.txt" "$saida" && return 1
if [ -f "$dir/alternativo_stderr.txt" ]; then
grep -qF -- "$(cat "$dir/alternativo_stderr.txt")" "$erros" || return 1
elif [ -s "$erros" ]; then
return 1
fi
return 0
}
Nomes internos referenciados: difere.
Como este símbolo aparece nos testes
2 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/lib.sh
Contexto: caso_execucao. Linhas: 208, 230. Tipo de evidência: código; via resultado_confere.
Linhas 206–210 · abrir contexto
fi
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out0" "$T_TMP/err0")
if resultado_confere "$dir" "$rc" "$T_TMP/out0" "$T_TMP/err0"; then
t_ok "$nome (M0)"
else
Linhas 228–232 · abrir contexto
fi
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out1" "$T_TMP/err1")
if resultado_confere "$dir" "$rc" "$T_TMP/out1" "$T_TMP/err1"; then
t_ok "$nome (M1)"
else
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 resultado_confere. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que resultado_confere faz?
Compara o resultado de um caso com o contrato principal ou alternativo.
Qual é a assinatura e o tipo de retorno de resultado_confere?
Assinatura extraída de tests/lib.sh; visibilidade pública.
resultado_confere()
Como resultado_confere aparece em código real deste repositório?
Uso extraído de tests/lib.sh:206, com as linhas vizinhas preservadas:
fi
rc=$(roda "$bin" "${entrada:--}" "$T_TMP/out0" "$T_TMP/err0")
if resultado_confere "$dir" "$rc" "$T_TMP/out0" "$T_TMP/err0"; then
t_ok "$nome (M0)"
else
Onde resultado_confere é exercitado nos testes?
Há 2 ocorrência(s) em 1 arquivo(s): tests/lib.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.
resultado_confere depende de compilador, padrão C ou sistema operacional?
resultado_confere é uma função de runner Bash: requer Bash e utilitários Unix; no Windows o projeto usa Git Bash/MSYS2, não CMD/PowerShell.
Quais armadilhas preciso evitar ao usar resultado_confere?
O contrato editorial registra: “Saída alternativa não é aprovação genérica: precisa corresponder ao conjunto declarado para aquele caso.”