Share via


Use new IncStr parameter to change integers by more than 1 in string variables

Enabled for Public preview General availability
Admins, makers, marketers, or analysts, automatically Apr 1, 2025 Apr 1, 2025

Business value

For some time you've been able to increase a positive number or decrease a negative number inside a string variable by 1 using the IncStr method on Text types. This is useful when handling iterations, for example, involving number series. If you needed to make a change of more than 1, however, you had to write extensive custom logic. To help in these scenarios, the IncStr method now supports a new optional increments parameter to change more than 1.

Feature details

A new overload of the IncStr method is added to support an arbitrary increase or decrease of a number in a string variable. This allows for incrementing number series or other similar series by more than one position in one go.

When decreasing a positive number, use a try function to catch cases where the string can't be decreased further. Format-wise, when decreasing, leading zeros will be added as applicable.

The example shows incrementing the integer 99 in the AText string variable to 109 in a single call, by using the new IncStr method overload with an increment parameter of 10.

Increment integers in string variables by more than 1 using the new IncStr overload

Tell us what you think

Help us improve Dynamics 365 Business Central by discussing ideas, providing suggestions, and giving feedback. Use the forum at https://aka.ms/bcideas.

Additional resources

Text.IncStr(Text, BigInteger) Method (docs)