Pular para o conteúdo principal

confere_saida

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tests/run_msvc.sh:76.

Compara saída de exemplo no runner MSVC normalizando newlines.

Tipo: função Shell · Visibilidade: pública · Arquivo: tests/run_msvc.sh.

Assinatura e expansão​

confere_saida()

Como funciona​

Remove CR dos lados antes de comparar o conteúdo dourado, tolerando o modo texto do CRT.

Implementação completa · 56 linhas
confere_saida() {
local nome="$1" rotulo="$2" bin="$3" entrada="$4" rc linha falhou=0

"$bin" < "$entrada" > "$TMP/out.raw" 2> "$TMP/err.raw"
rc=$?
# Normaliza CRLF: o CRT no Windows escreve \r\n; o restante é byte a byte.
tr -d '\r' < "$TMP/out.raw" > "$TMP/out"
tr -d '\r' < "$TMP/err.raw" > "$TMP/err"
if [ "$rc" != "0" ]; then
falha "$nome ($rotulo)" "codigo de saida $rc"
return
fi
if [ -f "docs/exemplos/$nome.esperado.txt" ]; then
if ! diff -q <(tr -d '\r' < "docs/exemplos/$nome.esperado.txt") \
"$TMP/out" > /dev/null; then
falha "$nome ($rotulo)" \
"saida difere do dourado (docs/exemplos/$nome.esperado.txt)"
diff -u <(tr -d '\r' < "docs/exemplos/$nome.esperado.txt") \
"$TMP/out" > "$TMP/diff" || true
sed -n '1,10p' "$TMP/diff" | sed 's/^/ /'
if [ "${GITHUB_ACTIONS:-}" = "true" ]; then
# so as linhas que mudaram: GitHub exibe ~10 annotations por
# passo; um dump inteiro esconde o diff de verdade
grep -E '^[+-]' "$TMP/diff" | grep -v -E '^(\+\+\+|---)' \
| while IFS= read -r linha; do
printf '::error::%s\n' "$linha"
done
fi
return
fi
fi
if [ -f "docs/exemplos/$nome.contem.txt" ]; then
while IFS= read -r linha; do
linha="${linha%$'\r'}"
[ -z "$linha" ] && continue
if ! grep -qF -- "$linha" "$TMP/out"; then
falha "$nome ($rotulo)" "saida nao contem: $linha"
if [ "${GITHUB_ACTIONS:-}" = "true" ]; then
printf '::error::saida produzida:\n'
sed -n '1,20p' "$TMP/out" | while IFS= read -r linha_out; do
printf '::error::| %s\n' "$linha_out"
done
fi
falhou=1
fi
done < "docs/exemplos/$nome.contem.txt"
[ "$falhou" = "1" ] && return
fi
if [ -f "docs/exemplos/$nome.esperado_stderr.txt" ]; then
if ! grep -qF -- "$(tr -d '\r' < "docs/exemplos/$nome.esperado_stderr.txt")" "$TMP/err"; then
falha "$nome ($rotulo)" "stderr nao contem a linha esperada"
return
fi
fi
ok "$nome ($rotulo)"
}

Nomes internos referenciados: E.

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/run_msvc.sh​

Contexto: run_msvc.sh. Linhas: 162, 178. Tipo de evidência: código; via confere_saida.

Linhas 160–164 · abrir contexto
if "$CL" $FLAGS -I include "$fonte" \
-Fo:"$BUILD/$nome.obj" -Fe:"$exe" -link "$T_LIBRARY" > "$TMP/log" 2>&1; then
confere_saida "$nome" M0 "./$exe" "$entrada"
else
anota "$TMP/log"

Ver no GitHub

Linhas 176–180 · abrir contexto
if "$CL" $FLAGS -I include "$gerado" \
-Fo:"$BUILD/$nome-m1.obj" -Fe:"$exe" -link "$T_LIBRARY" > "$TMP/log" 2>&1; then
confere_saida "$nome" M1 "./$exe" "$entrada"
else
anota "$TMP/log"

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 confere_saida. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que confere_saida faz?​

Compara saída de exemplo no runner MSVC normalizando newlines.

Qual é a assinatura e o tipo de retorno de confere_saida?​

Assinatura extraída de tests/run_msvc.sh; visibilidade pública.

confere_saida()

Como confere_saida aparece em código real deste repositório?​

Uso extraído de tests/run_msvc.sh:160, com as linhas vizinhas preservadas:

if "$CL" $FLAGS -I include "$fonte" \
-Fo:"$BUILD/$nome.obj" -Fe:"$exe" -link "$T_LIBRARY" > "$TMP/log" 2>&1; then
confere_saida "$nome" M0 "./$exe" "$entrada"
else
anota "$TMP/log"

Onde confere_saida é exercitado nos testes?​

Há 2 ocorrência(s) em 1 arquivo(s): tests/run_msvc.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.

confere_saida depende de compilador, padrão C ou sistema operacional?​

confere_saida é 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.