Type: Text constant or code

The result after increasing or decreasing String.

If String contains more than one number, only the number closest to the end of the string is changed. For example, 'A10B20' is changed to 'A10B21' and 'a12b12c' to 'a12b13c'.

If String contains a negative number, it is decreased by one. For example, '-55' is changed to '-56'.

Zero (0) is considered a positive number, so it is increased it by one. For example, 'A0' is changed to 'A1'.

When String contains a number such as 99, it is increased to 100 and the length of the output string is: LEN(String) + 1. For example, 'a12b99c' is changed to 'a12b100c'.

If String does not contain any number, the output string is an empty string. For example, 'aaa' is changed to ''.

This example requires that you create the following variables and text constants in the C/AL Globals window.

	Copy Code
Account := Text000; NegAccount := Text001; MyAccount := Text002; MESSAGE(Text003, Account, NegAccount, MyAccount); ResAccount := INCSTR(Account); ResNegAccount := INCSTR(NegAccount); ResMyAccount := INCSTR(MyAccount); MESSAGE(Text004, ResAccount, ResNegAccount, ResMyAccount);

The first message displays the following:

The text strings before INCSTR is called:

Account no. 99 does not balance.

Account no. 2342 shows a total of $ -452.

My bank account shows a total of $ 0.

The second message displays the following:

The text strings after INCSTR has been called:

Account no. 100 does not balance.

Account no. 2342 shows a total of $ -453.

My bank account shows a total of $ 1.

The example shows that if the string contains more than one number, only the last number is changed. Furthermore, positive numbers and zero are increased and negative numbers are decreased.

Reference