Pular para o conteúdo principal

resultado_confere

Página gerada do fonte

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.

Contrato e armadilhas
  • 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

Ver no GitHub

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

Ver no GitHub

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.
Não confunda implementação com certificação

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.”