Pular para o conteúdo principal

falha

Página gerada do fonte

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

Registra falha no runner da biblioteca e imprime detalhe opcional.

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

Assinatura e expansão​

falha()

Como funciona​

Incrementa FALHAS e escreve FALHA mais contexto em stdout.

Implementação​

falha() {
FALHAS=$((FALHAS + 1))
printf ' FALHA %s\n' "$1"
if [ -n "${2:-}" ]; then
printf ' %s\n' "$2"
fi
if [ "${GITHUB_ACTIONS:-}" = "true" ]; then
printf '::error::FALHA %s\n' "$1"
[ -n "${2:-}" ] && printf '::error::%s\n' "$2"
return 0
fi
}

Como este símbolo aparece nos testes​

13 ocorrência(s) em 2 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: fatal_esperado, representabilidade_esperada, run_biblioteca.sh. Linhas: 39, 47, 55, 63, 74, 89. Tipo de evidência: código; via falha.

Linhas 37–41 · abrir contexto
OK=$((OK + 1))
else
falha "testes unitarios" "$(head -3 "$TMP/err" "$TMP/out" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 45–49 · abrir contexto
OK=$((OK + 1))
else
falha "wrappers de stdin" "$(head -3 "$TMP/err" "$TMP/out" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 53–57 · abrir contexto
OK=$((OK + 1))
else
falha "wrappers numericos invalidos" "$(head -3 "$TMP/err" "$TMP/out" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 61–65 · abrir contexto
OK=$((OK + 1))
else
falha "linha longa" "$(head -3 "$TMP/err" "$TMP/out" | tr '\n' ' ')"
fi

Ver no GitHub

Linhas 72–76 · abrir contexto
OK=$((OK + 1))
else
falha "erro esperado: $modo" "rc=$rc; $(head -2 "$TMP/fatal.err" | tr '\n' ' ')"
fi
}

Ver no GitHub

Linhas 87–91 · abrir contexto
OK=$((OK + 1))
else
falha "$descricao: $modo" "rc=$rc; $(head -2 "$TMP/fatal.err" | tr '\n' ' ')"
fi
}

Ver no GitHub

tests/run_msvc.sh​

Contexto: confere_saida, run_msvc.sh. Linhas: 85, 91, 112, 126, 165, 173, 181. Tipo de evidência: código; via falha.

Linhas 83–87 · abrir contexto
tr -d '\r' < "$TMP/err.raw" > "$TMP/err"
if [ "$rc" != "0" ]; then
falha "$nome ($rotulo)" "codigo de saida $rc"
return
fi

Ver no GitHub

Linhas 89–93 · abrir contexto
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") \

Ver no GitHub

Linhas 110–114 · abrir contexto
[ -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'

Ver no GitHub

Linhas 124–128 · abrir contexto
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

Ver no GitHub

Linhas 163–167 · abrir contexto
else
anota "$TMP/log"
falha "$nome (M0)" "compilacao falhou: $(head -3 "$TMP/log" | tr '\n' ' ')"
fi
fi

Ver no GitHub

Linhas 171–175 · abrir contexto
if ! "$T_BASICGOLC" "$fonte" -o "$gerado" > "$TMP/log" 2>&1; then
anota "$TMP/log"
falha "$nome (M1)" "basicgolc falhou: $(head -3 "$TMP/log" | tr '\n' ' ')"
continue
fi

Ver no GitHub

1 outros blocos de contexto: use os links de linha e o JSON de inventário.

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

Em uma frase, o que falha faz?​

Registra falha no runner da biblioteca e imprime detalhe opcional.

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

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

falha()

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

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

OK=$((OK + 1))
else
falha "testes unitarios" "$(head -3 "$TMP/err" "$TMP/out" | tr '\n' ' ')"
fi

Onde falha é exercitado nos testes?​

Há 13 ocorrência(s) em 2 arquivo(s): tests/run_biblioteca.sh, 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.

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

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