coleta_de_cabecalho
Gerada por tools/gerar_documentacao.py. Definição: tools/basicgolc.c:943.
Coleta enumeradores de cabeçalhos locais para reduzir falsos positivos de W-05.
Tipo: função C · Visibilidade: interna (static) · Arquivo: tools/basicgolc.c.
Assinatura e expansão
static void coleta_de_cabecalho(const char *caminho, Estado *e, int prof)
Parâmetros formais: const char *caminho, Estado *e, int prof.
Como funciona
Tokeniza o cabeçalho, reconhece ENUMERACAO/FIM_ENUMERACAO e segue includes locais recursivamente. Usa guarda de arquivos visitados e limites de profundidade/tabela.
- É uma coleta heurística de nomes, não resolução completa do pré-processador C.
- Os limites atuais são profundidade 4, oito caminhos visitados e 256 enumeradores no estado.
Comentário do fonte
Coleta os enumeradores declarados em cabecalhos locais (#include "...") para que o W-05 respeite a excecao documentada de R-1 tambem entre arquivos.
Implementação completa · 94 linhas
{
static char vistos[8][512];
static int qtd_vistos = 0;
char dir[512];
char *texto;
char *p;
const char *barra;
Lista l = { NULL, 0, 0 };
int i;
if (prof > 4 || qtd_vistos >= 8) {
return;
}
for (i = 0; i < qtd_vistos; i++) {
if (strcmp(vistos[i], caminho) == 0) {
return; /* ja lido (guarda de inclusao) */
}
}
if (strlen(caminho) < sizeof vistos[0]) {
strcpy(vistos[qtd_vistos++], caminho);
}
texto = le_arquivo_ou_nulo(caminho);
if (texto == NULL) {
return;
}
barra = strrchr(caminho, '/');
if (barra == NULL) {
dir[0] = '\0';
} else {
size_t n = (size_t) (barra - caminho) + 1;
if (n >= sizeof dir) {
n = sizeof dir - 1;
}
memcpy(dir, caminho, n);
dir[n] = '\0';
}
/* enumeradores do proprio cabecalho */
tokeniza(texto, &l);
{
bool dentro = false;
for (i = 0; i < l.qtd; i++) {
const Token *t = &l.itens[i];
if (t->tipo != TK_IDENT) {
continue;
}
if (strcmp(t->texto, "ENUMERACAO") == 0) {
dentro = true;
continue;
}
if (strcmp(t->texto, "FIM_ENUMERACAO") == 0) {
dentro = false;
continue;
}
if (!dentro) {
continue;
}
{
int prox = proximo_significativo(&l, i);
if (prox >= 0 && l.itens[prox].tipo == TK_PONT
&& (strcmp(l.itens[prox].texto, ",") == 0
|| strcmp(l.itens[prox].texto, "=") == 0)) {
registra_enumerador_nome(e, t->texto);
} else if (prox >= 0 && l.itens[prox].tipo == TK_IDENT
&& strcmp(l.itens[prox].texto, "FIM_ENUMERACAO") == 0) {
registra_enumerador_nome(e, t->texto);
}
}
}
}
/* includes locais, resolvidos a partir do diretorio deste arquivo */
p = strstr(texto, "#include \"");
while (p != NULL) {
const char *ini = p + strlen("#include \"");
const char *fim = strchr(ini, '"');
if (fim != NULL) {
char alvo[1024];
size_t n = (size_t) (fim - ini);
if (strlen(dir) + n + 1 < sizeof alvo) {
memcpy(alvo, dir, strlen(dir));
memcpy(alvo + strlen(dir), ini, n);
alvo[strlen(dir) + n] = '\0';
coleta_de_cabecalho(alvo, e, prof + 1);
}
}
p = strstr(p + 1, "#include \"");
}
lista_libera(&l);
free(texto);
}
Nomes internos referenciados: le_arquivo_ou_nulo, lista_libera, proximo_significativo, registra_enumerador_nome, tokeniza.
Como este símbolo aparece nos testes
Nenhuma referência direta a este nome foi encontrada nos arquivos de teste. Isso pode ser esperado para guardas de inclusão, configuração ou código exercitado indiretamente; não é uma afirmação de cobertura zero.
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.
Nenhum arquivo de teste foi localizado para os chamadores diretos.
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.
- A resolução de diretório procura '/' no caminho; a suíte Windows exercita os caminhos fornecidos pelo runner.
- 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 coleta_de_cabecalho. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que coleta_de_cabecalho faz?
Coleta enumeradores de cabeçalhos locais para reduzir falsos positivos de W-05.
Qual é a assinatura e o tipo de retorno de coleta_de_cabecalho?
Assinatura extraída de tools/basicgolc.c; visibilidade interna (static).
static void coleta_de_cabecalho(const char *caminho, Estado *e, int prof)
Como chamar coleta_de_cabecalho corretamente?
Nenhum exemplo editorial nem chamada direta em teste foi localizada. A forma de uso é a assinatura acima; os chamadores aparecem na seção de evidência indireta quando existem.
static void coleta_de_cabecalho(const char *caminho, Estado *e, int prof)
Por que não há teste direto para coleta_de_cabecalho?
A busca estática não encontrou o identificador nos arquivos de teste. Isso é esperado para guardas de inclusão, configuração de build e nomes alcançados apenas por chamadores internos. O JSON de cobertura registra a lacuna em vez de convertê-la em aprovação.
coleta_de_cabecalho depende de compilador, padrão C ou sistema operacional?
coleta_de_cabecalho é 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.
Ressalvas registradas: A resolução de diretório procura '/' no caminho; a suíte Windows exercita os caminhos fornecidos pelo runner.
Quais armadilhas preciso evitar ao usar coleta_de_cabecalho?
O contrato editorial registra: “É uma coleta heurística de nomes, não resolução completa do pré-processador C.” “Os limites atuais são profundidade 4, oito caminhos visitados e 256 enumeradores no estado.”