Pular para o conteúdo principal

falhou

Página gerada do fonte

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

Ver no GitHub

Linhas 16–20 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 2 falhou");
FIM_SE

Ver no GitHub

Linhas 22–26 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 3 falhou");
FIM_SE

Ver no GitHub

Linhas 46–50 · abrir contexto
ESCREVAL(n);
SENAO
ESCREVAL("inteiro 4 falhou");
FIM_SE
FIM

Ver no GitHub

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"

Ver no GitHub

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

Ver no GitHub

Linhas 295–299 · abrir contexto
[ -d "$dir" ] || continue
dir="${dir%/}"
caso_execucao "$dir"
done
done

Ver no GitHub

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

Ver no GitHub

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"

Ver no GitHub

Linhas 72–76 · abrir contexto
ok "$rotulo"
else
falhou "$rotulo" "$(tail -5 "$TMP/saida.log" | tr '\n' ' ')"
fi
}

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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"

Ver no GitHub

Linhas 117–121 · abrir contexto
done
fi
falhou=1
fi
done < "docs/exemplos/$nome.contem.txt"

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

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

Ver no GitHub

Linhas 262–266 · abrir contexto
cc="${COMPILADORES[$i]%|}"
cc="${cc#|}"
CTAG="c${i}"

for prog in precedencia controle fronteira; do

Ver no GitHub

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

Ver no GitHub

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")"

Ver no GitHub

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