bg_junta_texto
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
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);
}
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"));
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.
BG_JUNTA_TEXTO→ tests/casos/04_estruturas/e03_texto_buffer/programa.c, tests/casos/05_entrada_saida/i09_texto_truncamento/programa.c, tests/casos/08_aplicacao/app_acervo/relatorio.c, tests/casos/09_tipos_expr/t11_texto_seguro/programa.c
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.
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 liguebuild/libbasicgol.a; não copie o corpo desrc/biblioteca/texto.cpara o seu arquivo. - Rode
make test(oumake test-bibliotecapara 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.