main
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
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())
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()
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()
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())
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};
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; }
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; }
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) {
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];
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.
BG_INICIO→ tests/casos/06_negativos/n09_dois_inicio/programa.c, tests/run.sh, tests/run_portabilidade.sh
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.
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.