SerialIncrement

Retorna o texto e os números especificados, com os números incrementados pelo valor especificado.

Formato

SerialIncrement ( texto ; incrementarEm )

Parâmetros

texto - qualquer texto que também contém um número

incrementarEm - qualquer expressão numérica para incrementar o texto em

Tipo de dados retornado

texto

Originada na versão

7.0

Descrição

Essa função não remove o texto em texto, o que normalmente acontece quando se realiza uma operação matemática padrão com um valor que contém texto.

Se o valor incrementarEm for um número decimal, somente a porção de inteiro do valor incrementarEm será adicionada ao último número em texto. Qualquer caractere que não seja um número será considerado um separador. É possível usar valores incrementarEm positivos e negativos.

Exemplo 1

SerialIncrement("abc12";1) retorna abc13.

SerialIncrement ( "abc12" ; 7 ) retorna abc19.

SerialIncrement ( "abc12" ; -1 ) retorna abc11.

SerialIncrement ( "abc12" ; 1,2 ) retorna abc13.

SerialIncrement ( "abc1.2" ; 1,2 ) retorna abc1.3.

Exemplo 2

Neste exemplo, qualquer caractere que não seja um número é considerado um separador, e o número que está totalmente à direita é incrementado.

SerialIncrement("abc123;999";1) retorna abc123;1000.