Pular para o conteúdo principal

bg_junta_texto

Página gerada do fonte

Gerada por tools/gerar_documentacao.py. Definição: src/biblioteca/texto.c:35.

Concatena dois textos em um destino limitado, aceitando NULL e sobreposição.

Tipo: função C · Visibilidade: pública · Arquivo: src/biblioteca/texto.c.

Assinatura e expansão​

bool bg_junta_texto(char *destino, size_t capacidade,
const char *primeiro, const char *segundo)

Parâmetros formais: char *destino, size_t capacidade, const char *primeiro, const char *segundo.

Declarações públicas localizadas:

Junta dois textos em destino; aceita origens NULL vazias e sobreposição.

Como funciona​

Verifica a soma dos comprimentos sem overflow, aloca um temporário, copia as partes e usa memmove para o destino. A cópia temporária permite que as origens apontem para o próprio destino. Libera a alocação antes de retornar.

Retorno: false em argumento inválido, falta de espaço ou falha de malloc; nesses casos um destino válido fica vazio.

Exemplo de uso​

TEXTO_FIXO(nome, 32);
LOGICO ok = JUNTA_TEXTO(nome, TAMANHO_DE(nome), "BASIC", "GOL");

Implementação​

{
size_t n1 = bg_tamanho_texto(primeiro);
size_t n2 = bg_tamanho_texto(segundo);
size_t total;
char *temporario;

if (destino == NULL || capacidade == 0) {
return false;
}
if (n1 >= capacidade || n2 >= capacidade - n1) {
destino[0] = '\0';
return false;
}
total = n1 + n2; /* seguro: n1+n2 < capacidade */
temporario = (char *) malloc(total + 1);
if (temporario == NULL) {
destino[0] = '\0';
return false;
}
if (n1 > 0) {
memcpy(temporario, primeiro, n1);
}
if (n2 > 0) {
memcpy(temporario + n1, segundo, n2);
}
temporario[total] = '\0';
memmove(destino, temporario, total + 1);
free(temporario);
return true;
}

Interface BASICGOL relacionada​

BG_JUNTA_TEXTO

Nomes internos referenciados: bg_tamanho_texto.

Como este símbolo aparece nos testes​

11 ocorrência(s) em 2 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/portabilidade/fronteira.c​

Contexto: fronteira.c. Linhas: 56, 58, 60, 62, 65. Tipo de evidência: código; via bg_junta_texto.

Linhas 54–67 · abrir contexto
char sobreposto[8] = "abcd";

EXIGE(bg_junta_texto(dst, 7, "abc", "def") == true); /* 6 + NUL */
EXIGE(strcmp(dst, "abcdef") == 0);
EXIGE(bg_junta_texto(dst, 6, "abc", "def") == false);
EXIGE(dst[0] == '\0');
EXIGE(bg_junta_texto(dst, 7, NULL, "def") == true);
EXIGE(strcmp(dst, "def") == 0);
EXIGE(bg_junta_texto(dst, 7, NULL, NULL) == true);
EXIGE(strcmp(dst, "") == 0);
/* destino sobreposto às próprias origens */
EXIGE(bg_junta_texto(sobreposto, TAMANHO_DE(sobreposto), sobreposto, "xy") == true);
EXIGE(strcmp(sobreposto, "abcdxy") == 0);
}

Ver no GitHub

tests/test_biblioteca.c​

Contexto: testa_texto. Linhas: 166, 168, 170, 173, 175, 177. Tipo de evidência: código; via bg_junta_texto.

Linhas 164–179 · abrir contexto
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"));

Ver no GitHub

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.

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.

  • Usa malloc/memmove padrão; não depende de asprintf ou strlcat, que variam entre sistemas.
  • Tamanhos são bytes. Conversões reais usam a locale C corrente; o projeto não chama setlocale.
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.

Checklist de integração​

  • Compile com C11: o cabeçalho seleciona formatos e divisões com _Generic, e C99/C89 são recusados com mensagem explícita.
  • Declare pelo cabeçalho (include/basicgol/texto.h) e ligue build/libbasicgol.a; não copie o corpo de src/biblioteca/texto.c para o seu arquivo.
  • Rode make test (ou make test-biblioteca para a biblioteca) antes de integrar.
make
cc -std=c11 -Wall -Wextra -Wformat=2 -I include programa.c \
build/libbasicgol.a -lm -o programa

Perguntas frequentes​

Perguntas reunidas a partir da definição, do contrato editorial e dos testes de bg_junta_texto. As respostas repetem apenas o que o repositório mostra; quando não há evidência, isso é dito.

Em uma frase, o que bg_junta_texto faz?​

Concatena dois textos em um destino limitado, aceitando NULL e sobreposição.

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

Assinatura extraída de src/biblioteca/texto.c; visibilidade pública.

Retorno: false em argumento inválido, falta de espaço ou falha de malloc; nesses casos um destino válido fica vazio.

bool bg_junta_texto(char *destino, size_t capacidade,
const char *primeiro, const char *segundo)

Como usar bg_junta_texto em um programa?​

Exemplo editorial mantido em tools/documentacao/contratos.json e conferido contra a assinatura real:

TEXTO_FIXO(nome, 32);
LOGICO ok = JUNTA_TEXTO(nome, TAMANHO_DE(nome), "BASIC", "GOL");

Onde bg_junta_texto é exercitado nos testes?​

Há 11 ocorrência(s) em 2 arquivo(s): tests/portabilidade/fronteira.c, 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.

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

bg_junta_texto exige C11 como o restante da linguagem; largura de tipo, libc e CRT continuam sendo os do alvo.

Ressalvas registradas: Usa malloc/memmove padrão; não depende de asprintf ou strlcat, que variam entre sistemas.

O que acontece em caso de falha ou uso inválido?​

false em argumento inválido, falta de espaço ou falha de malloc; nesses casos um destino válido fica vazio.