Pular para o conteúdo principal

testa_console

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: tests/test_biblioteca.c:39.

Grupo executável do harness da biblioteca padrão.

Tipo: função C · Visibilidade: interna (static) · Arquivo: tests/test_biblioteca.c.

Assinatura e expansão​

static void testa_console(void)

Parâmetros formais: void.

Como funciona​

Prepara cenários de sucesso, fronteira e falha, chama a API e registra condições com VERIFICA ou retorna um código de erro ao modo de integração. O fonte completo e as referências extraídas aparecem abaixo.

Implementação completa · 71 linhas
{
char buffer[8] = "sobra";
char lido[64];
char uma_posicao[1] = { 'x' }; /* capacidade de um byte; sem NUL (C4295) */
FILE *entrada = cria_arquivo_temporario("abc\n1234567\n12345678\n\ncrlf\r\nfinal");
FILE *saida = tmpfile();
FILE *limite = cria_arquivo_temporario("x\n\n");

VERIFICA(entrada != NULL);
VERIFICA(saida != NULL);
VERIFICA(limite != NULL);
if (entrada == NULL || saida == NULL || limite == NULL) {
if (entrada != NULL) (void) fclose(entrada);
if (saida != NULL) (void) fclose(saida);
if (limite != NULL) (void) fclose(limite);
return;
}

VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(strcmp(buffer, "abc") == 0);
VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(strcmp(buffer, "1234567") == 0);
VERIFICA(bg_leia_linha(entrada, buffer, 5) == false);
VERIFICA(buffer[0] == '\0');
VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(buffer[0] == '\0'); /* linha vazia é sucesso */
VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(strcmp(buffer, "crlf") == 0);
VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(strcmp(buffer, "final") == 0); /* última linha sem LF */
VERIFICA(!bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(buffer[0] == '\0');
VERIFICA(!bg_leia_linha(NULL, buffer, sizeof buffer));
VERIFICA(buffer[0] == '\0');
(void) fclose(entrada);

VERIFICA(!bg_leia_linha(limite, uma_posicao, 0));
VERIFICA(uma_posicao[0] == 'x'); /* capacidade zero não autoriza escrita */
VERIFICA(!bg_leia_linha(limite, uma_posicao, sizeof uma_posicao));
VERIFICA(uma_posicao[0] == '\0'); /* nenhum byte cabe além do NUL */
VERIFICA(bg_leia_linha(limite, uma_posicao, sizeof uma_posicao));
VERIFICA(uma_posicao[0] == '\0'); /* linha vazia cabe até em capacidade 1 */
VERIFICA(!bg_leia_linha(limite, NULL, 1));
(void) fclose(limite);

entrada = tmpfile();
VERIFICA(entrada != NULL);
if (entrada != NULL) {
(void) fputc('a', entrada);
(void) fputc('\0', entrada);
(void) fputc('b', entrada);
(void) fputc('\n', entrada);
(void) fputs("ok\n", entrada);
rewind(entrada);
VERIFICA(!bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(buffer[0] == '\0');
VERIFICA(bg_leia_linha(entrada, buffer, sizeof buffer));
VERIFICA(strcmp(buffer, "ok") == 0);
(void) fclose(entrada);
}

VERIFICA(bg_escreva_texto(saida, "literal %s%n"));
VERIFICA(bg_escreva_linha(saida, " linha"));
VERIFICA(!bg_escreva_texto(saida, NULL));
VERIFICA(!bg_escreva_linha(saida, NULL));
VERIFICA(!bg_escreva_texto(NULL, "nao escreve"));
rewind(saida);
VERIFICA(fgets(lido, sizeof lido, saida) != NULL);
VERIFICA(strcmp(lido, "literal %s%n linha\n") == 0);
(void) fclose(saida);
}

Nomes internos referenciados: VERIFICA, bg_escreva_linha, bg_escreva_texto, bg_leia_linha, cria_arquivo_temporario.

Como este símbolo aparece nos testes​

1 ocorrência(s) em 1 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/test_biblioteca.c​

Contexto: test_biblioteca.c. Linhas: 566. Tipo de evidência: código; via testa_console.

Linhas 564–568 · abrir contexto
}

testa_console();
testa_entrada_numerica();
testa_texto();

Ver no GitHub

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.

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 testa_console. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que testa_console faz?​

Grupo executável do harness da biblioteca padrão.

Qual é a assinatura e o tipo de retorno de testa_console?​

Assinatura extraída de tests/test_biblioteca.c; visibilidade interna (static).

static void testa_console(void)

Como testa_console aparece em código real deste repositório?​

Uso extraído de tests/test_biblioteca.c:564, com as linhas vizinhas preservadas:

}

testa_console();
testa_entrada_numerica();
testa_texto();

Onde testa_console é exercitado nos testes?​

Há 1 ocorrência(s) em 1 arquivo(s): tests/test_biblioteca.c. 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.

testa_console depende de compilador, padrão C ou sistema operacional?​

testa_console é 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.