Função INSERT( )

Retorna a cadeia original com um texto especificado inserido em um local de byte específico.

Sintaxe

INSERT(cadeia; inserir_texto; local)

Parâmetros

Nome	Tipo	Descrição
cadeia	caractere	O campo, expressão ou valor literal no qual será inserido o texto.
inserir_texto	caractere	O texto a inserir.
local	numérico	A posição de caractere em que inserir_texto deve ser inserido em cadeia.

Saída

Caractere.

Exemplos

Exemplos básicos

Retorna "aXXXbcde":

INSERT("abcde"; "XXX"; 2)

Retorna "XXXabcde":

INSERT("abcde"; "XXX"; 0)

Retorna "abcdeXXX", com "XXX" inserido na posição do byte 6 em vez de 8, pois "abcde" só tem 5 caracteres de comprimento:

INSERT("abcde"; "XXX"; 8)

Observações

Como funciona?

A função INSERT( ) insere caracteres especificados ou espaços em uma cadeia de caracteres, começando em uma posição específica da cadeia.

Quando usar INSERT( )

Use INSERT( ) para normalizar dados para formatação, para correspondência de duplicidades e para os comandos JOIN e DEFINE RELATION, que exigem campos idênticos.

Por exemplo, os números de peça de um arquivo podem estar no formato "12345" e em outro arquivo, "12-345." No primeiro arquivo, é possível usar INSERT( ) para inserir um hífen (-) na posição 3.

Diretrizes de localização

• Se o valor local for maior que o comprimento da cadeia o valor inserir_texto será inserido no final da cadeia.
• Se o local for 0 ou 1, inserir_texto será inserido no início da cadeia.

Inserção de aspas

Se você especificar aspas em inserir_texto, deverá colocá-los entre apóstrofos.

Por exemplo: ""