SerialIncrement

Returns specified text and numbers, with the numbers incremented by the specified amount.

Format 

SerialIncrement ( text ; incrementBy )

Parameters 

text - any text that also contains a number

incrementBy - any numeric expression to increment the text by

Data type returned 

text

Originated in version 

7.0

Description 

This function doesn't remove the text in text, which normally happens when performing standard math against a value that contains text.

If the incrementBy value is a decimal number, then only the integer portion of incrementBy value is added to the last number in text. Any character other than a number is considered a separator. You can use both positive and negative incrementBy values.

Example 1 

SerialIncrement ( "abc12" ; 1 ) returns abc13.

SerialIncrement ( "abc12" ; 7 ) returns abc19.

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

SerialIncrement ( "abc12" ; 1.2 ) returns abc13.

SerialIncrement ( "abc1.2" ; 1.2 ) returns abc1.3.

Example 2 

In this example, any character other than a number is considered to be a separator and the number on the far right is incremented.

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

Related topics