Pular para o conteúdo principal

C · tools/basicgolc

Fonte: tools/basicgolc.

FunçãoLinhasResumoReferências diretas
bg_morte53–62Erro fatal interno do transpilador, com status 70.0
buf_ini64–73Inicializa um buffer dinâmico vazio com capacidade inicial 256.0
buf_adiciona75–90Acrescenta uma string C ao buffer, crescendo a capacidade por dobramento.0
buf_limpa96–100Reutiliza o buffer sem liberar sua alocação.0
buf_libera102–108Libera a memória do buffer e zera seus metadados.0
emite_seguro110–120Emite texto de tradução garantindo separação do próximo token.0
lista_novo149–159Reserva e devolve a próxima posição da lista de tokens.0
lista_adiciona161–172Cria um token com cópia própria do texto e linha de origem.0
lista_libera177–187Libera todos os textos de tokens e o vetor da lista.0
le_arquivo193–221Lê um arquivo de entrada em modo binário para uma string C alocada.0
byte_ident230–233Reconhece bytes que podem continuar um identificador ASCII/UTF-8 no lexer.0
inicio_ident235–238Reconhece bytes que podem iniciar um identificador no lexer.0
tokeniza247–402Separa a fonte em identificadores, números, literais, pontuação, espaço, comentários e diretivas, preservando linhas.0
em_lista551–560Testa pertencimento de uma string a uma lista NULL-terminada.0
busca_traducao562–571Consulta a tabela estática de palavras-chave e tokens de sotaque ASCII.0
desacentua574–583Resolve apelidos acentuados conhecidos para sua forma ASCII.0
normaliza_apelidos587–607Substitui tokens de palavras-chave acentuadas por seus equivalentes ASCII antes da tradução.0
erro635–644Registra diagnóstico estrutural do transpilador e incrementa o contador de erros.1
aviso649–661Emite aviso W-xx sem transformar sucesso em erro.1
ja_avisado663–681Deduplica avisos por nome dentro da tabela limitada do estado.0
estado_libera685–701Libera todos os recursos de propriedade pelo Estado de tradução.0
finaliza705–711Caminho comum de encerramento que libera fonte, tokens e estado e devolve o código de saída.0
nome_bloco713–726Traduz o código interno de bloco para o nome usado em diagnósticos.0
fechador_de728–741Informa qual fechador seria válido para um tipo de bloco.0
empilha743–752Registra abertura de bloco e sua linha na pilha do transpilador.0
desempilha754–768Valida e remove o bloco mais interno ao encontrar um fechador.0
significado774–777Indica se um token participa da estrutura, ignorando espaço e comentário.0
proximo_significativo779–786Encontra o próximo token não triviais depois de um índice.0
ajusta_profundidade789–796Atualiza profundidade de delimitadores durante coleta de expressões.0
coleta_ate801–827Coleta uma expressão até um terminador de nível superior.0
buf_limpa_espacos829–852Remove whitespace ASCII das extremidades do buffer de tradução.0
em_bloco858–867Consulta se há um tipo de bloco em qualquer nível da pilha atual.0
eh_enumerador878–887Consulta a tabela de enumeradores conhecidos para a exceção do aviso W-05.0
le_arquivo_ou_nulo891–917Lê um cabeçalho opcional devolvendo NULL quando ele não pode ser usado.0
registra_enumerador_nome919–939Adiciona um enumerador único à tabela limitada do estado.0
coleta_de_cabecalho943–1037Coleta enumeradores de cabeçalhos locais para reduzir falsos positivos de W-05.0
coleta_enumeradores1039–1042Inicia a coleta de enumeradores a partir do arquivo de entrada.0
eh_ponteiro1044–1053Consulta se um nome foi registrado como parâmetro ponteiro/vetor.0
coleta_parametros1057–1107Pré-passe que registra parâmetros declarados como nome ou nome[].0
verifica_w061110–1124Emite W-06 para TAMANHO_VETOR aplicado a parâmetro ponteiro/vetor.0
verifica_w041127–1206Emite W-04 quando a variável de controle de um laço parece modificada no corpo.0
exige_parenteses1222–1231Informa se uma palavra-chave de valor exige argumentos entre parênteses.0
captura_parenteses1235–1258Captura argumentos balanceados de uma chamada de macro no fluxo de tokens.0
verifica_cabecalho1264–1308Valida a estrutura de cabeçalhos como SE/ENQUANTO/PARA antes de emitir C.0
verifica_w021311–1353Emite W-02 para variáveis locais declaradas sem inicializador no contexto analisado.0
verifica_w051356–1394Emite W-05 para identificadores do usuário totalmente maiúsculos, com exceções registradas.0
verifica_w071397–1425Emite W-07 quando capacidade de vetor/texto usa CONSTANTE em vez de literal/define.0
emite_identificador1431–1739Núcleo de tradução de palavras-chave, blocos e açúcar sintático M1.0
traduz1745–1770Percorre a lista de tokens e produz a saída C, verificando blocos não fechados ao final.0
uso1776–1789Imprime a ajuda de linha de comando do basicgolc no FILE fornecido.1
main1791–1897Contrato no corpo9

Perguntas frequentes​

Perguntas frequentes sobre tools/basicgolc e as 51 função(ões) indexada(s) nele.

Que funções este arquivo expõe?​

As funções abaixo foram extraídas do próprio arquivo. Elas são internas ao projeto: não fazem parte da API pública de basicgol.h.

static void bg_morte(const char *fmt, ...)
static void buf_ini(Buf *b)
static void buf_adiciona(Buf *b, const char *s)
static void buf_limpa(Buf *b)
static void buf_libera(Buf *b)
static void emite_seguro(Buf *b, const char *txt)

Como executar este arquivo?​

Depende do tipo de arquivo. A receita abaixo é a do projeto; flags e argumentos específicos estão na assinatura de cada função.

make && ./build/test_biblioteca

As funções internas têm teste próprio?​

4 das 51 funções possuem referência direta nos testes. As demais podem ser alcançadas apenas por chamadores; o JSON de cobertura registra a lacuna.

Qual é o contrato de bg_morte?​

Erro fatal interno do transpilador, com status 70.

{
va_list ap;
va_start(ap, fmt);
fputs("basicgolc: erro fatal: ", stderr);
vfprintf(stderr, fmt, ap);
fputc('\n', stderr);
va_end(ap);
exit(70);
}