verifica_w04
Gerada por tools/gerar_documentacao.py. Definição: tools/basicgolc.c:1127.
Emite W-04 quando a variável de controle de um laço parece modificada no corpo.
Tipo: função C · Visibilidade: interna (static) · Arquivo: tools/basicgolc.c.
Assinatura e expansão
static void verifica_w04(Estado *e, const Lista *l, int i)
Parâmetros formais: Estado *e, const Lista *l, int i.
Como funciona
Varre tokens com profundidade para localizar atribuições/incrementos relevantes ao controle, respeitando a estrutura reconhecida pelo transpilador.
- É aviso heurístico, não prova de todas as formas possíveis de aliasing/modificação.
Comentário do fonte
W-04: variavel de controle de PARA modificada dentro do corpo.
Implementação completa · 79 linhas
{
int j = proximo_significativo(l, i);
int prof = 0;
int fim_args = -1;
int corpo = -1;
char var[128];
size_t n = 0;
if (j < 0 || !(l->itens[j].tipo == TK_PONT && strcmp(l->itens[j].texto, "(") == 0)) {
return;
}
/* nome da variavel de controle = primeiro argumento */
j = proximo_significativo(l, j);
if (j < 0 || l->itens[j].tipo != TK_IDENT) {
return;
}
n = strlen(l->itens[j].texto);
if (n >= sizeof var) {
return;
}
memcpy(var, l->itens[j].texto, n + 1);
/* fim da lista de argumentos */
prof = 1;
for (j = j + 1; j < l->qtd && prof > 0; j++) {
if (l->itens[j].tipo == TK_PONT) {
const char *t = l->itens[j].texto;
if (strcmp(t, "(") == 0 || strcmp(t, "[") == 0) {
prof++;
} else if (strcmp(t, ")") == 0 || strcmp(t, "]") == 0) {
prof--;
if (prof == 0) {
fim_args = j;
}
}
}
}
if (fim_args < 0) {
return;
}
corpo = proximo_significativo(l, fim_args);
if (corpo < 0 || !(l->itens[corpo].tipo == TK_PONT
&& strcmp(l->itens[corpo].texto, "{") == 0)) {
return; /* forma sem chaves: W-04 nao se aplica */
}
prof = 0;
for (j = corpo; j < l->qtd; j++) {
const Token *t = &l->itens[j];
if (t->tipo == TK_PONT) {
if (strcmp(t->texto, "{") == 0) {
prof++;
continue;
}
if (strcmp(t->texto, "}") == 0) {
prof--;
if (prof == 0) {
return;
}
continue;
}
if (strcmp(t->texto, "=") == 0 || strcmp(t->texto, "+=") == 0
|| strcmp(t->texto, "-=") == 0 || strcmp(t->texto, "*=") == 0
|| strcmp(t->texto, "/=") == 0 || strcmp(t->texto, "%=") == 0
|| strcmp(t->texto, "++") == 0 || strcmp(t->texto, "--") == 0) {
int ant = j - 1;
while (ant > corpo && !significado(l->itens[ant].tipo)) {
ant--;
}
if (ant > corpo && l->itens[ant].tipo == TK_IDENT
&& strcmp(l->itens[ant].texto, var) == 0) {
aviso(e, l->itens[ant].linha, "W-04",
"a variavel de controle '%s' do PARA e modificada dentro "
"do corpo: o passo do laco sera sobrescrito", var);
return;
}
}
}
}
}
Nomes internos referenciados: aviso, proximo_significativo, significado.
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.
Caso de aviso correspondente: w04_controle_modificado.
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 verifica_w04. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.
Em uma frase, o que verifica_w04 faz?
Emite W-04 quando a variável de controle de um laço parece modificada no corpo.
Qual é a assinatura e o tipo de retorno de verifica_w04?
Assinatura extraída de tools/basicgolc.c; visibilidade interna (static).
static void verifica_w04(Estado *e, const Lista *l, int i)
Como chamar verifica_w04 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 verifica_w04(Estado *e, const Lista *l, int i)
Por que não há teste direto para verifica_w04?
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.
verifica_w04 depende de compilador, padrão C ou sistema operacional?
verifica_w04 é 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.
Quais armadilhas preciso evitar ao usar verifica_w04?
O contrato editorial registra: “É aviso heurístico, não prova de todas as formas possíveis de aliasing/modificação.”