Histórico da Página
Incluir 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”