Pular para o conteúdo principal

verifica_w04

Página gerada do fonte

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.

Contrato e armadilhas
  • É 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​

Sem uso direto localizado

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.

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 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.”