{"title":"Text.IncStr(Text, BigInteger) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/text/text-incstr-string-biginteger-method/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/text/text-incstr-string-biginteger-method, MicrosoftDocs/dynamics365smb-devitpro-pb at 828b6ee (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/dev-itpro/developer/methods-auto/text/text-incstr-string-biginteger-method","source":{"name":"Business Central developer and IT pro docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-devitpro-pb","commit":"828b6ee72fcd75755627cd6011f3d20899217ab2","date":"2026-11-19"},"checked":"2026-11-19","description":"Increments the last positive number by the provided increment.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":208,"chars":159},{"level":2,"title":"Parameters","slug":"parameters","at":367,"chars":164},{"level":2,"title":"Return Value","slug":"return-value","at":531,"chars":71},{"level":2,"title":"Remarks","slug":"remarks","at":602,"chars":729},{"level":3,"title":"Example","slug":"example","at":1021,"chars":310},{"level":2,"title":"Related information","slug":"related-information","at":1331,"chars":136}],"text":"> Version: _Available or changed with runtime version 15.0._\nIncrements the last positive number by the provided increment. The result of the increment must be zero or positive, otherwise an error is thrown.\n## Syntax\n```al\nNewString :=   Text.IncStr(String: Text, Increment: BigInteger)\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nString\nType: text-data-type\nThe string that you want to increase or decrease.\nIncrement\nType: ../biginteger/biginteger-data-type\nThe increment value.\n## Return Value\nNewString\nType: text-data-type\nThe incremented string.\n## Remarks\nThe Text.IncStr method increases the last positive number or decreases the last negative number inside a string by the provided positive increment. The method returns a new string with the incremented or decremented value. When decreasing a positive number, you should use a try function to catch cases where the string can't be decreased further. When decreasing, leading zeros will be added as applicable.\n### Example\n```al\ncodeunit 50111 MyAccountCodeunit\n{\n    procedure MyIncStr()\n    var\n        Account: Text[60];\n        ResultAccount: Text[60];\n        AText: TextConst ENU = 'Account No. 99 doesn''t balance.';\n    begin\n        Account := AText;\n        ResultAccount := IncStr(Account, 10);\n    end;\n}\n```\n## Related information\ntext-data-type\nGetting started with AL<../../devenv-get-started>\nDeveloping extensions<../../devenv-dev-overview>"}