Pular para o conteúdo principal

testa_texto

Página gerada do fonte

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

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_texto(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 · 146 linhas
{
char buffer[32];
char pequeno[4] = "xyz";
char justo[5];
char formato[32];
int inteiro = 17;
int inteiro_antes;
unsigned natural = 9;
unsigned natural_antes;
double real = 2.0;
double real_antes;
char numero_grande[1024];
size_t i;

VERIFICA(bg_tamanho_texto(NULL) == 0);
VERIFICA(bg_tamanho_texto("abc") == 3);
VERIFICA(bg_copia_texto(buffer, sizeof buffer, "abc"));
VERIFICA(strcmp(buffer, "abc") == 0);
VERIFICA(bg_copia_texto(buffer, sizeof buffer, NULL));
VERIFICA(buffer[0] == '\0');
VERIFICA(bg_copia_texto(pequeno, sizeof pequeno, "abc")); /* capacidade exata */
VERIFICA(strcmp(pequeno, "abc") == 0);
VERIFICA(!bg_copia_texto(pequeno, sizeof pequeno, "quatro"));
VERIFICA(pequeno[0] == '\0');
VERIFICA(!bg_copia_texto(NULL, 1, "x"));
VERIFICA(!bg_copia_texto(buffer, 0, "x"));

VERIFICA(bg_junta_texto(buffer, sizeof buffer, "ab", "cd"));
VERIFICA(strcmp(buffer, "abcd") == 0);
VERIFICA(bg_junta_texto(justo, sizeof justo, "ab", "cd"));
VERIFICA(strcmp(justo, "abcd") == 0); /* 4 bytes + NUL cabem exatamente */
VERIFICA(bg_junta_texto(buffer, sizeof buffer, NULL, "x"));
VERIFICA(strcmp(buffer, "x") == 0);
VERIFICA(bg_copia_texto(buffer, sizeof buffer, "abcd"));
VERIFICA(bg_junta_texto(buffer, sizeof buffer, buffer, buffer + 1));
VERIFICA(strcmp(buffer, "abcdbcd") == 0); /* origens sobrepostas */
VERIFICA(!bg_junta_texto(pequeno, sizeof pequeno, "ab", "cd"));
VERIFICA(pequeno[0] == '\0');
VERIFICA(!bg_junta_texto(NULL, 0, "a", "b"));

VERIFICA(bg_copia_texto(buffer, sizeof buffer, "ab"));
VERIFICA(bg_acrescenta_texto(buffer, sizeof buffer, "cd"));
VERIFICA(strcmp(buffer, "abcd") == 0);
VERIFICA(bg_copia_texto(buffer, sizeof buffer, "ab"));
VERIFICA(bg_acrescenta_texto(buffer, 5, "cd"));
VERIFICA(strcmp(buffer, "abcd") == 0); /* capacidade exata */
VERIFICA(bg_acrescenta_texto(buffer, sizeof buffer, buffer));
VERIFICA(strcmp(buffer, "abcdabcd") == 0);
VERIFICA(!bg_acrescenta_texto(buffer, 8, "x"));
VERIFICA(buffer[0] == '\0');
VERIFICA(!bg_acrescenta_texto(NULL, 0, "x"));

VERIFICA(bg_trecho_texto(buffer, sizeof buffer, "abcdef", 2, 3));
VERIFICA(strcmp(buffer, "cde") == 0);
VERIFICA(bg_trecho_texto(buffer, sizeof buffer, "abcdef", 4, SIZE_MAX));
VERIFICA(strcmp(buffer, "ef") == 0);
VERIFICA(bg_trecho_texto(buffer, sizeof buffer, "abc", SIZE_MAX, 1));
VERIFICA(buffer[0] == '\0');
VERIFICA(bg_trecho_texto(buffer, sizeof buffer, "abc", 1, 0));
VERIFICA(buffer[0] == '\0');
VERIFICA(bg_trecho_texto(justo, sizeof justo, "abc", 0, 3));
VERIFICA(strcmp(justo, "abc") == 0); /* capacidade exata */
VERIFICA(!bg_trecho_texto(pequeno, sizeof pequeno, "abcdef", 0, 4));
VERIFICA(pequeno[0] == '\0');
VERIFICA(bg_copia_texto(buffer, sizeof buffer, "abcdef"));
VERIFICA(bg_trecho_texto(buffer, sizeof buffer, buffer, 2, 3));
VERIFICA(strcmp(buffer, "cde") == 0);

VERIFICA(bg_compara_texto("a", "b") == -1);
VERIFICA(bg_compara_texto("b", "a") == 1);
VERIFICA(bg_compara_texto("a", "a") == 0);
VERIFICA(bg_compara_texto(NULL, "") == 0);
VERIFICA(bg_texto_vazio(NULL));
VERIFICA(bg_texto_vazio(""));
VERIFICA(!bg_texto_vazio(" "));

VERIFICA(bg_formata_texto(formato, sizeof formato, "%s-%d", "id", 42));
VERIFICA(strcmp(formato, "id-42") == 0);
VERIFICA(bg_formata_texto(pequeno, sizeof pequeno, "%d", 123));
VERIFICA(strcmp(pequeno, "123") == 0); /* capacidade exata */
VERIFICA(!bg_formata_texto(pequeno, sizeof pequeno, "%s", "longo"));
VERIFICA(pequeno[0] == '\0');
(void) strcpy(pequeno, "x");
VERIFICA(!bg_formata_texto(pequeno, sizeof pequeno, NULL));
VERIFICA(pequeno[0] == '\0');
VERIFICA(!bg_formata_texto(NULL, sizeof formato, "%d", 1));
VERIFICA(!bg_formata_texto(formato, 0, "%d", 1));

errno = EDOM;
(void) snprintf(formato, sizeof formato, " \t%d \n", INT_MIN);
VERIFICA(bg_texto_para_inteiro(formato, &inteiro));
VERIFICA(errno == EDOM);
VERIFICA(inteiro == INT_MIN);
(void) snprintf(formato, sizeof formato, "%d", INT_MAX);
VERIFICA(bg_texto_para_inteiro(formato, &inteiro));
VERIFICA(inteiro == INT_MAX);
inteiro_antes = inteiro;
VERIFICA(!bg_texto_para_inteiro("12abc", &inteiro));
VERIFICA(inteiro == inteiro_antes);
VERIFICA(!bg_texto_para_inteiro("", &inteiro));
VERIFICA(!bg_texto_para_inteiro(NULL, &inteiro));
VERIFICA(!bg_texto_para_inteiro("1", NULL));

VERIFICA(bg_texto_para_natural(" +123 \t", &natural));
VERIFICA(natural == 123U);
(void) snprintf(formato, sizeof formato, "%u", UINT_MAX);
VERIFICA(bg_texto_para_natural(formato, &natural));
VERIFICA(natural == UINT_MAX);
natural_antes = natural;
VERIFICA(!bg_texto_para_natural("-1", &natural));
VERIFICA(natural == natural_antes);
VERIFICA(!bg_texto_para_natural("7x", &natural));
VERIFICA(!bg_texto_para_natural(NULL, &natural));
VERIFICA(!bg_texto_para_natural("1", NULL));

for (i = 0; i + 1 < sizeof numero_grande; ++i) {
numero_grande[i] = '9';
}
numero_grande[sizeof numero_grande - 1] = '\0';
VERIFICA(!bg_texto_para_inteiro(numero_grande, &inteiro));
VERIFICA(!bg_texto_para_natural(numero_grande, &natural));

errno = EDOM;
VERIFICA(bg_texto_para_real(" 3.5 \t", &real));
VERIFICA(errno == EDOM);
VERIFICA(real == 3.5);
real_antes = real;
VERIFICA(!bg_texto_para_real("2,5", &real));
VERIFICA(real == real_antes);
VERIFICA(!bg_texto_para_real("1e9999", &real));
VERIFICA(!bg_texto_para_real("1e-9999", &real));
VERIFICA(!bg_texto_para_real("3.5x", &real));
VERIFICA(!bg_texto_para_real(NULL, &real));
VERIFICA(!bg_texto_para_real("1", NULL));

VERIFICA(bg_numero_para_inteiro(12.9, &inteiro));
VERIFICA(inteiro == 12);
VERIFICA(bg_numero_para_inteiro(-12.9, &inteiro));
VERIFICA(inteiro == -12);
inteiro_antes = inteiro;
VERIFICA(!bg_numero_para_inteiro(NAN, &inteiro));
VERIFICA(inteiro == inteiro_antes);
VERIFICA(!bg_numero_para_inteiro(HUGE_VAL, &inteiro));
VERIFICA(!bg_numero_para_inteiro(-HUGE_VAL, &inteiro));
VERIFICA(!bg_numero_para_inteiro(1.0, NULL));
}

Nomes internos referenciados: VERIFICA, bg_acrescenta_texto, bg_compara_texto, bg_copia_texto, bg_formata_texto, bg_junta_texto, bg_numero_para_inteiro, bg_tamanho_texto, bg_texto_para_inteiro, bg_texto_para_natural, bg_texto_para_real, bg_texto_vazio, bg_trecho_texto.

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: 568. Tipo de evidência: código; via testa_texto.

Linhas 566–570 · abrir contexto
testa_console();
testa_entrada_numerica();
testa_texto();
testa_caracteres();
testa_matematica();

Ver no GitHub

Compiladores, padrão C e sistema operacional​

Nenhum ramo condicional externo foi detectado para este símbolo. Marcadores de plataforma/representação presentes: INT_MIN, UINT_MAX.

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

Em uma frase, o que testa_texto faz?​

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

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

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

static void testa_texto(void)

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

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

testa_console();
testa_entrada_numerica();
testa_texto();
testa_caracteres();
testa_matematica();

Onde testa_texto é 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_texto depende de compilador, padrão C ou sistema operacional?​

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