Pular para o conteúdo principal

BG_RETORNE · RETORNE

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: include/basicgol.h:133.

Devolve controle e, opcionalmente, um valor da função.

Tipo: macro de objeto · Módulo/categoria: Programa e declarações.

Nomes equivalentes: RETORNE. Os testes de qualquer um desses nomes são reunidos nesta página.

Assinatura e expansão​

#define BG_RETORNE return

Corpo da macro:

return

Como funciona​

Expande para return; a expressão e o ponto-e-vírgula são do chamador.

Como este símbolo aparece nos testes​

31 ocorrência(s) em 7 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/04_estruturas/e07_enumeracao/programa.c​

Contexto: e07_enumeracao. Linhas: 13, 15, 17, 19, 21. Tipo de evidência: código; via RETORNE.

Linhas 11–23 · abrir contexto
ESCOLHA (c)
CASO VERMELHO:
RETORNE "vermelho";
CASO VERDE:
RETORNE "verde";
CASO AZUL:
RETORNE "azul";
CONTRARIO:
RETORNE "desconhecida";
FIM_ESCOLHA
RETORNE "?";
}

Ver no GitHub

tests/casos/04_estruturas/e08_recursao/programa.c​

Contexto: e08_recursao. Linhas: 6, 8, 13, 15. Tipo de evidência: código; via RETORNE.

Linhas 4–17 · abrir contexto
FUNCAO INTEIRO64 fatorial(INTEIRO n) {
SE n <= 1 ENTAO
RETORNE 1;
FIM_SE
RETORNE (INTEIRO64) n * fatorial(n - 1);
}

FUNCAO INTEIRO fib(INTEIRO n) {
SE n < 2 ENTAO
RETORNE n;
FIM_SE
RETORNE fib(n - 1) + fib(n - 2);
}

Ver no GitHub

tests/casos/04_estruturas/e11_procedimento_vazio/programa.c​

Contexto: e11_procedimento_vazio. Linhas: 5, 9. Tipo de evidência: código; via RETORNE.

Linhas 3–11 · abrir contexto

PROCEDIMENTO nada(void) {
RETORNE;
}

FUNCAO VAZIO nada2(void) {
RETORNE;
}

Ver no GitHub

tests/casos/07_multiarquivo/m01_modulos/matematica.c​

Contexto: m01_modulos. Linhas: 10, 15, 17, 22, 27, 31. Tipo de evidência: código; via RETORNE.

Linhas 8–33 · abrir contexto
b = resto;
FIM_ENQUANTO
RETORNE ABS(a);
}

FUNCAO INTEIRO mmc(INTEIRO a, INTEIRO b) {
SE IGUAL(a, 0) OU IGUAL(b, 0) ENTAO
RETORNE 0;
FIM_SE
RETORNE ABS(a / mdc(a, b) * b);
}

FUNCAO LOGICO eh_primo(INTEIRO n) {
SE n < 2 ENTAO
RETORNE FALSO;
FIM_SE
INTEIRO d = 2;
ENQUANTO d * d <= n FACA
SE IGUAL(n MOD d, 0) ENTAO
RETORNE FALSO;
FIM_SE
d = d + 1;
FIM_ENQUANTO
RETORNE VERDADEIRO;
}

Ver no GitHub

tests/casos/08_aplicacao/app_acervo/acervo.c​

Contexto: app_acervo. Linhas: 28, 32, 38, 50, 94, 99, 106, 113, 127, 129, 131, 133. Tipo de evidência: código; via RETORNE.

Linhas 26–34 · abrir contexto
ENQUANTO i < total FACA
SE IGUAL(acervo[i].id, id) ENTAO
RETORNE i;
FIM_SE
i = i + 1;
FIM_ENQUANTO
RETORNE -1;
}

Ver no GitHub

Linhas 36–40 · abrir contexto
INTEIRO pos = busca(id);
SE pos < 0 ENTAO
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, EMPRESTADO) ENTAO

Ver no GitHub

Linhas 48–52 · abrir contexto
INTEIRO pos = busca(id);
SE pos < 0 ENTAO
RETORNE FALSO;
FIM_SE
SE IGUAL(acervo[pos].situacao, DISPONIVEL) ENTAO

Ver no GitHub

Linhas 92–101 · abrir contexto
i = i + 1;
FIM_ENQUANTO
RETORNE contador;
}

FUNCAO REAL media_ano(void) {
SE IGUAL(total, 0) ENTAO
RETORNE 0.0;
FIM_SE
INTEIRO soma = 0;

Ver no GitHub

Linhas 104–108 · abrir contexto
soma = soma + acervo[i].ano;
}
RETORNE (1.0 * soma) / total;
}

Ver no GitHub

Linhas 111–115 · abrir contexto
FUNCAO INTEIRO indice_raridade(REAL fator) {
SE IGUAL(total, 0) ENTAO
RETORNE 0;
FIM_SE
REAL soma = 0.0;

Ver no GitHub

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

tests/casos/08_aplicacao/app_acervo/principal.c​

Contexto: app_acervo. Linhas: 19. Tipo de evidência: código; via RETORNE.

Linhas 17–21 · abrir contexto
i = i + 1;
FIM_ENQUANTO
RETORNE valor;
}

Ver no GitHub

tests/casos/09_tipos_expr/t10_estouro_divisao/programa.c​

Contexto: t10_estouro_divisao. Linhas: 11. Tipo de evidência: código; via RETORNE.

Linhas 9–13 · abrir contexto
ESCREVA("MIN/-1: nao representavel");
quociente = DIVIDE(minimo, -1);
RETORNE 9; /* DIVIDE precisa falhar nesta representação. */
}

Ver no GitHub

Também aparece na tabela de expansão conferida por cc -E -dM: L34.

Evidência indireta​

Estes símbolos chamam/encaminham para este nome. As referências deles ajudam a rastrear o caminho, mas não substituem um teste específico deste símbolo.

Compiladores, padrão C e sistema operacional​

Condições que envolvem a definição:

  • defined(BASICGOL_H) (fonte)
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.

Checklist de integração​

  • Compile com C11: o cabeçalho seleciona formatos e divisões com _Generic, e C99/C89 são recusados com mensagem explícita.
  • A forma curta RETORNE e a forma canônica BG_RETORNE são a mesma macro; escolha uma por arquivo para não misturar estilos.
  • Rode make test (ou make test-biblioteca para a biblioteca) antes de integrar.
make
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa

Perguntas frequentes​

Perguntas reunidas a partir da definição, do contrato editorial e dos testes de BG_RETORNE. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que BG_RETORNE faz?​

Devolve controle e, opcionalmente, um valor da função.

Para que exatamente BG_RETORNE expande?​

O pré-processador substitui BG_RETORNE pelo texto abaixo, sem criar função nem avaliar argumentos por conta própria.

return

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

Uso extraído de tests/casos/04_estruturas/e07_enumeracao/programa.c:11, com as linhas vizinhas preservadas:

ESCOLHA (c)
CASO VERMELHO:
RETORNE "vermelho";
CASO VERDE:
RETORNE "verde";

Onde BG_RETORNE é exercitado nos testes?​

Há 31 ocorrência(s) em 7 arquivo(s): tests/casos/04_estruturas/e07_enumeracao/programa.c, tests/casos/04_estruturas/e08_recursao/programa.c, tests/casos/04_estruturas/e11_procedimento_vazio/programa.c, tests/casos/07_multiarquivo/m01_modulos/matematica.c, tests/casos/08_aplicacao/app_acervo/acervo.c …. 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.

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

BG_RETORNE exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.

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.