falhou
Gerada por tools/gerar_documentacao.py. Definição: tests/run_checkout_limpo.sh:39.
Conta e reporta falha nos runners auxiliares.
Tipo: função Shell · Visibilidade: pública · Arquivo: tests/run_checkout_limpo.sh.
Assinatura e expansão
falhou()
Como funciona
Incrementa o contador de falhas, imprime contexto e registra a linha na matriz/relatório quando o runner mantém um.
Implementação
falhou() {
FALHOU=$((FALHOU + 1))
printf ' FALHA %s\n' "$1"
[ -n "${2:-}" ] && printf ' %s\n' "$2"
FALHAS="$FALHAS
- $1"
return 0
}
Como este símbolo aparece nos testes
47 ocorrência(s) em 5 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/casos/09_tipos_expr/t12_leia_numeros/programa.c
Contexto: t12_leia_numeros. Linhas: 11, 18, 24, 48. Tipo de evidência: código; via falhou.
Linhas 9–13 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 1 falhou");
FIM_SE
Linhas 16–20 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 2 falhou");
FIM_SE
Linhas 22–26 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 3 falhou");
FIM_SE
Linhas 46–50 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 4 falhou");
FIM_SE
FIM
tests/run.sh
Contexto: run.sh. Linhas: 279, 290, 297, 304. Tipo de evidência: código; via falhou.
Linhas 277–281 · abrir contexto
|| t_falhou "basicgolc --ajuda sai 0"
"$T_BASICGOLC" --versao | grep -q "1.1.0" && t_ok "basicgolc --versao" \
|| t_falhou "basicgolc --versao"
"$T_BASICGOLC" > /dev/null 2>&1
[ $? -eq 2 ] && t_ok "basicgolc sem argumento sai 2" || t_falhou "basicgolc sem argumento sai 2"
Linhas 288–292 · abrir contexto
# ===============================================================
# 02..08 — casos de execução por diretório
# ===============================================================
for suite in 02_basico 03_controle 04_estruturas 05_entrada_saida 07_multiarquivo 08_aplicacao 09_tipos_expr; do
selecionado "$suite" || continue
Linhas 295–299 · abrir contexto
[ -d "$dir" ] || continue
dir="${dir%/}"
caso_execucao "$dir"
done
done
Linhas 302–306 · abrir contexto
# 06 — casos negativos (devem falhar na compilação, com mensagem prevista)
# ===============================================================
if selecionado 06_negativos; then
t_titulo "06 — negativos: erros do compilador C (caminho M0)"
for dir in "$T_CASOS/06_negativos"/*/; do
tests/run_checkout_limpo.sh
Contexto: roda, run_checkout_limpo.sh. Linhas: 64, 74, 93, 103, 113. Tipo de evidência: código; via falhou.
Linhas 62–66 · abrir contexto
if [ -d "$DEST/build" ] || [ -d "$DEST/build-sanitize" ]; then
falhou "o checkout limpo não deveria conter diretórios de build"
else
ok "nenhum artefato de build veio junto"
Linhas 72–76 · abrir contexto
ok "$rotulo"
else
falhou "$rotulo" "$(tail -5 "$TMP/saida.log" | tr '\n' ' ')"
fi
}
Linhas 91–95 · abrir contexto
ok "make cobertura não altera tests/COBERTURA.md (checagem do CI)"
else
falhou "make cobertura alterou tests/COBERTURA.md" \
"$(diff -u "$TMP/COBERTURA.antes.md" "$DEST/tests/COBERTURA.md" | head -6 | tr '\n' ' ')"
fi
Linhas 101–105 · abrir contexto
ok "comando M0 de uma linha do README compila e imprime 'Ola, mundo!'"
else
falhou "comando M0 de uma linha" "$(tail -4 "$TMP/m0.log" | tr '\n' ' ')"
fi
Linhas 111–115 · abrir contexto
ok "fluxo M1 de duas etapas do README (transpila e compila o C gerado)"
else
falhou "fluxo M1 de duas etapas" "$(tail -4 "$TMP/m1.log" | tr '\n' ' ')"
fi
tests/run_msvc.sh
Contexto: confere_saida. Linhas: 77, 119. Tipo de evidência: código; via falhou.
Linhas 75–79 · abrir contexto
confere_saida() {
local nome="$1" rotulo="$2" bin="$3" entrada="$4" rc linha falhou=0
"$bin" < "$entrada" > "$TMP/out.raw" 2> "$TMP/err.raw"
Linhas 117–121 · abrir contexto
done
fi
falhou=1
fi
done < "docs/exemplos/$nome.contem.txt"
tests/run_portabilidade.sh
Contexto: run_portabilidade.sh. Linhas: 222, 229, 233, 237, 249, 264, 270, 282, 285, 295, 298, 309, 312, 333, 352, 378, 400, 405, 412, 422, 433, 438, 458, 461, 467, 471, 492, 496, 500, 507, 518, 524. Tipo de evidência: código; via falhou.
Linhas 220–224 · abrir contexto
else
std_efetivo=$std
fi
if tenta "$cc" -std=$std_efetivo $FLAGS_ESTRITAS -I "$INCLUDE" \
-o "$TMP/h_${i}_$std" "$TMP/h.c" "$BIBLIOTECA" -lm; then
Linhas 227–239 · abrir contexto
falhou "[$i] compilar em -std=$std_efetivo" "$(head -4 "$TMP/e" | tr '\n' ' ')"
fi
done
# C99 e C89 recusados, com a mensagem da linguagem
printf '#include <basicgol.h>\nint main(void){return 0;}\n' > "$TMP/h99.c"
if tenta "$cc" -std=c99 -I "$INCLUDE" -o "$TMP/h99" "$TMP/h99.c"; then
falhou "[$i] C99 deveria ser recusado" "compilou em -std=c99"
elif grep -q "exige C11" "$TMP/e"; then
ok "[$i] -std=c99 recusado com mensagem da linguagem"
else
falhou "[$i] C99 recusado sem a mensagem esperada" "$(head -2 "$TMP/e" | tr '\n' ' ')"
fi
Linhas 247–251 · abrir contexto
# cada cabeçalho público sozinho (autocontido)
for h in basicgol.h basicgol/biblioteca.h basicgol/consola.h basicgol/texto.h \
basicgol/matematica.h basicgol/caractere.h basicgol/utilidades.h; do
printf '#include <%s>\nint main(void){return 0;}\n' "$h" > "$TMP/so.c"
if tenta "$cc" -std=c11 $FLAGS_ESTRITAS -I "$INCLUDE" -o "$TMP/so" "$TMP/so.c" -lm; then
Linhas 262–266 · abrir contexto
cc="${COMPILADORES[$i]%|}"
cc="${cc#|}"
CTAG="c${i}"
for prog in precedencia controle fronteira; do
Linhas 268–272 · abrir contexto
-o "$TMP/$prog.$i" "$PORT/$prog.c" "$BIBLIOTECA" -lm; then
falhou "[$i] compilar $prog.c" "$(head -4 "$TMP/e" | tr '\n' ' ')"
continue
fi
if "$TMP/$prog.$i" > "$TMP/$prog.$i.out" 2> "$TMP/$prog.$i.err"; then
Linhas 280–287 · abrir contexto
if "$FERRAMENTA" "$PORT/controle.c" -o "$TMP/controle.gerado.$i.c" 2> "$TMP/e" \
&& tenta "$cc" -std=c11 $FLAGS_ESTRITAS -I "$INCLUDE" \
-o "$TMP/controle.m1.$i" "$TMP/controle.gerado.$i.c" "$BIBLIOTECA" -lm; then
"$TMP/controle.m1.$i" > "$TMP/controle.m1.$i.out" 2>&1
if [ "$(cat "$TMP/controle.m1.$i.out")" = "$(cat "$TMP/controle.$i.out")" ]; then
ok "[$i] controle.c: M0 e M1 com a mesma saída"
else
falhou "[$i] controle.c: M0 e M1 divergem" "M0=$(cat "$TMP/controle.$i.out") M1=$(cat "$TMP/controle.m1.$i.out")"
15 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.
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 falhou. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que falhou faz?
Conta e reporta falha nos runners auxiliares.
Qual é a assinatura e o tipo de retorno de falhou?
Assinatura extraída de tests/run_checkout_limpo.sh; visibilidade pública.
falhou()
Como falhou aparece em código real deste repositório?
Uso extraído de tests/casos/09_tipos_expr/t12_leia_numeros/programa.c:9, com as linhas vizinhas preservadas:
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 1 falhou");
FIM_SE
Onde falhou é exercitado nos testes?
Há 47 ocorrência(s) em 5 arquivo(s): tests/casos/09_tipos_expr/t12_leia_numeros/programa.c, tests/run.sh, tests/run_checkout_limpo.sh, tests/run_msvc.sh, tests/run_portabilidade.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.
falhou depende de compilador, padrão C ou sistema operacional?
falhou é 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.