Pular para o conteúdo principal

main

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tools/basicgolc.c:1791.

Ponto de entrada do transpilador: interpreta a CLI, orquestra leitura/tradução, trata erros de E/S e devolve o código de saída.

Tipo: função C · Visibilidade: pública · Arquivo: tools/basicgolc.c.

Assinatura e expansão​

int main(int argc, char **argv)

Parâmetros formais: int argc, char **argv.

Como funciona​

O comportamento normativo é o corpo extraído abaixo. Não foi inferida uma garantia adicional sem contrato/documentação no fonte.

Implementação completa · 106 linhas
{
const char *entrada = NULL;
const char *saida = NULL;
bool checar = false;
Estado e;
char *src;
Lista l;
int i;
FILE *f;
int rc;

memset(&e, 0, sizeof e);
memset(&l, 0, sizeof l);

for (i = 1; i < argc; i++) {
if (strcmp(argv[i], "-h") == 0 || strcmp(argv[i], "--ajuda") == 0) {
uso(stdout);
return 0;
} else if (strcmp(argv[i], "-v") == 0 || strcmp(argv[i], "--versao") == 0) {
printf("basicgolc %s (BASICGOL 1.1.0)\n", BG_VERSAO);
return 0;
} else if (strcmp(argv[i], "-o") == 0) {
if (i + 1 >= argc) {
fputs("basicgolc: -o exige um argumento\n", stderr);
return 2;
}
saida = argv[++i];
} else if (strcmp(argv[i], "--checar") == 0 || strcmp(argv[i], "--check") == 0) {
checar = true;
} else if (strcmp(argv[i], "-w") == 0 || strcmp(argv[i], "--sem-avisos") == 0) {
e.sem_avisos = true;
} else if (strcmp(argv[i], "-") == 0) {
entrada = "-";
} else if (argv[i][0] == '-') {
fprintf(stderr, "basicgolc: opcao desconhecida '%s'\n", argv[i]);
uso(stderr);
return 2;
} else if (entrada == NULL) {
entrada = argv[i];
} else {
fprintf(stderr, "basicgolc: mais de um arquivo de entrada ('%s')\n", argv[i]);
return 2;
}
}

if (entrada == NULL) {
fputs("basicgolc: falta o arquivo de entrada\n", stderr);
uso(stderr);
return 2;
}
if (checar && saida != NULL) {
fputs("basicgolc: --checar nao combina com -o\n", stderr);
return 2;
}

e.arquivo = entrada;
buf_ini(&e.saida);

src = le_arquivo(entrada);
tokeniza(src, &l);
normaliza_apelidos(&l);
coleta_enumeradores(entrada, &e);
coleta_parametros(&e, &l);
traduz(&e, &l);

if (e.erros > 0) {
fprintf(stderr, "basicgolc: %d erro(s), nenhum arquivo gerado\n", e.erros);
return finaliza(&e, &l, src, 1);
}

if (checar) {
fprintf(stderr, "basicgolc: %s ok (%d aviso(s))\n", entrada, e.avisos);
return finaliza(&e, &l, src, 0);
}

f = (saida == NULL) ? stdout : fopen(saida, "wb");
if (f == NULL) {
bg_morte("nao consegui criar '%s'", saida);
}
if (fwrite(e.saida.dados, 1, e.saida.tam, f) != e.saida.tam) {
if (saida != NULL) {
fclose(f);
}
bg_morte("falha ao escrever '%s'", saida ? saida : "stdout");
}
/* Fechar (ou descarregar stdout) e onde o erro de E/S realmente aparece:
* o retorno de fwrite nao pega disco cheio em fluxo bufferizado, entao
* `basicgolc x.c > /dev/full` saia 0 e o C gerado se perdia em silencio.
* O arquivo de saida pode ficar incompleto quando isto falha: o codigo 70
* e o sinal; nao removemos o arquivo porque o destino pode ser um
* dispositivo (ex.: /dev/null, /dev/full, um pipe nomeado). */
rc = 0;
if (saida != NULL) {
if (fclose(f) != 0) {
rc = -1;
}
} else if (fflush(stdout) != 0 || ferror(stdout)) {
rc = -1;
}
if (rc != 0) {
finaliza(&e, &l, src, 0);
bg_morte("falha ao gravar a saida (%s)", saida ? saida : "stdout");
}

return finaliza(&e, &l, src, 0);
}

Interface BASICGOL relacionada​

BG_INICIO

Nomes internos referenciados: bg_morte, buf_ini, coleta_enumeradores, coleta_parametros, finaliza, le_arquivo, normaliza_apelidos, tokeniza, traduz, uso.

Como este símbolo aparece nos testes​

9 ocorrência(s) em 9 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/auditar_exemplos.py​

Contexto: auditar_exemplos.py. Linhas: 151. Tipo de evidência: código; via main.

Linhas 149–151 · abrir contexto

if __name__ == '__main__':
sys.exit(main())

Ver no GitHub

tests/documentacao/check_llms_build.py​

Contexto: check_llms_build.py. Linhas: 35. Tipo de evidência: código; via main.

Linhas 33–35 · abrir contexto

if __name__ == '__main__':
main()

Ver no GitHub

tests/documentacao/test_gerador.py​

Contexto: test_gerador.py. Linhas: 160. Tipo de evidência: código; via main.

Linhas 158–160 · abrir contexto

if __name__ == "__main__":
unittest.main()

Ver no GitHub

tests/fuzz_basicgolc.py​

Contexto: fuzz_basicgolc.py. Linhas: 184. Tipo de evidência: código; via main.

Linhas 182–184 · abrir contexto

if __name__ == "__main__":
sys.exit(main())

Ver no GitHub

tests/portabilidade/cpp_inclusao.cpp​

Contexto: cpp_inclusao.cpp. Linhas: 19. Tipo de evidência: código; via main.

Linhas 17–21 · abrir contexto
#include <cstring>

int main()
{
char destino[8] = {0};

Ver no GitHub

tests/run.sh · heredoc na linha 174​

Contexto: C incorporado no runner (linha 174). Linhas: 191. Tipo de evidência: código; via main.

Linhas 189–191 · abrir contexto
#error "nome curto NATURAL_CURTO nao deveria existir"
#endif
int main(void) { return 0; }

Ver no GitHub

tests/run.sh · heredoc na linha 202​

Contexto: C incorporado no runner (linha 202). Linhas: 209. Tipo de evidência: código; via main.

Linhas 207–209 · abrir contexto
#error "SOMA_SEGURA nao deveria existir sem BG_USAR_EXTENSOES"
#endif
int main(void) { return 0; }

Ver no GitHub

tests/test_biblioteca.c​

Contexto: test_biblioteca.c. Linhas: 551. Tipo de evidência: código; via main.

Linhas 549–553 · abrir contexto
}

int main(int argc, char **argv)
{
if (argc == 2 && strcmp(argv[1], "--stdin") == 0) {

Ver no GitHub

tests/test_filesystem.c​

Contexto: test_filesystem.c. Linhas: 16. Tipo de evidência: código; via main.

Linhas 14–18 · abrir contexto
}

int main(void) {
// temp file
char tmp[256];

Ver no GitHub

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.

Testes de caixa-preta

O transpilador é exercitado pela CLI em tests/run.sh, tests/run_portabilidade.sh e tests/fuzz_basicgolc.py. Uma ligação no grafo de chamadores não prova que cada ramo desta função foi coberto.

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.

  • O transpilador abre entrada/saída em modo binário; BG_FORMATO só adiciona atributo printf em GCC/Clang.
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 main. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que main faz?​

Ponto de entrada do transpilador: interpreta a CLI, orquestra leitura/tradução, trata erros de E/S e devolve o código de saída.

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

Assinatura extraída de tools/basicgolc.c; visibilidade pública.

int main(int argc, char **argv)

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

Uso extraído de tests/auditar_exemplos.py:149, com as linhas vizinhas preservadas:


if __name__ == '__main__':
sys.exit(main())

Onde main é exercitado nos testes?​

Há 9 ocorrência(s) em 9 arquivo(s): tests/auditar_exemplos.py, tests/documentacao/check_llms_build.py, tests/documentacao/test_gerador.py, tests/fuzz_basicgolc.py, tests/portabilidade/cpp_inclusao.cpp …. 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.

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

main é código interno em C: compila com C11 nos alvos exercitados, mas não faz parte da API pública nem da matriz de portabilidade da linguagem.

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.