Histórico da Página

Sintaxe

STUFF( <expressão caracter 1>, <expressão numérica 1> , <expressão numérica 2> , <expressão caracter 2> )

Propósito

Elimina e insere caracteres em uma cadeia de caracteres.

Argumentos

< expressão caracter 1 >

Define a cadeia de caracteres que sofrerá a substituição.

< expressão numérica 1 >

Define a posição inicial da substituição na expressão caracter 1.

< expressão numérica 2 >

Define o número de caracteres que serão substituídos, a partir da expressão numérica 1, na expressão caracter 1.

< expressão caracter 2 >

Define a cadeia de caracteres que substituirá os caracteres definidos na expressão caracter 1 com base nas expressões numéricas 1 e 2.

Utilização

A função STUFF() pode realizar as seguintes operações:

Inserção

Se a expressão numérica 2 for zero, nenhum caracter é removido da expressão caracter 1 e toda a expressão caracter 2 são inseridas na expressão caracter 1 a partir da posição especificada pela expressão numérica 1.

Substituição

Se a expressão caracter 2 for especificada com o mesmo número de caracteres definidos pela expressão numérica 2, a expressão caracter 2substituirá os caracteres da expressão caracter 1 a partir da posição definida pela expressão numérica 1.

Eliminação

Se a expressão caracter 2 for uma cadeia de caracteres nula (“”), o número de caracteres especificados pela expressão numérica 2 será removido da expressão caracter 1.

Substituição e Inserção

Se a expressão caracter 2 possuir um número maior de caracteres que o definido pela expressão numérica 2, todos os caracteres, a partir da posição indicada pela expressão numérica 1, serão substituídos e os restantes inseridos.

Substituição e Eliminação

Se o tamanho da expressão caracter 2 for menor que o número de caracteres especificados na expressão numérica 2, todos os caracteres na expressão caracter 1 são eliminados a partir do final da expressão caracter 2, até atingir o número de caracteres da expressão numérica 2.

Substituição e Eliminação do restante

Se a expressão numérica 2 for maior que o tamanho da expressão caracter 1, a expressão caracter 2 será inserida a partir da posição definida pela expressão numérica 1 e o restante da expressão caracter 1 será eliminado.

Exemplos

Exemplo de substituição:

MsgAlert( STUFF(“Clipper”, 4, 2, “ff”) )     // Resulta “Cliffer”

Exemplo de eliminação:

MsgAlert( STUFF(“Clipper”, 3, 4, “ff”) )     // Resulta “Cli”

Exemplo de inserção:

MsgAlert( STUFF(“Clipper”, 3, 0, “pp”) )     // Resulta “Clipppper”

Exemplo de substituição e inserção:

MsgAlert( STUFF(“ABCDEFG”, 3, 2, “123”) )     // Resulta “AB123EFG”

Exemplo de substituição e eliminação:

MsgAlert( STUFF(“ABCDEFG”, 3, 4, “123”) )     // Resulta “AB123G”

Exemplo de substituição e eliminação do restante:

MsgAlert( STUFF(“ABCDEFG”, 3, 20, “123”) )     // Resulta “AB123”