{"title":"Text.StrLen(Text) Method","url":"https://jonas-paprotka.de/docs/dev-itpro/developer/methods-auto/text/text-strlen-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-strlen-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-strlen-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":"Gets the length of a string you define.","date":"2026-10-01","meta":{"topic":"reference"},"outline":[{"level":2,"title":"Syntax","slug":"syntax","at":100,"chars":133},{"level":2,"title":"Parameters","slug":"parameters","at":233,"chars":97},{"level":2,"title":"Return Value","slug":"return-value","at":330,"chars":84},{"level":2,"title":"Remarks","slug":"remarks","at":414,"chars":505},{"level":2,"title":"Example","slug":"example","at":919,"chars":755},{"level":2,"title":"Related information","slug":"related-information","at":1674,"chars":132}],"text":"> Version: _Available or changed with runtime version 1.0._\nGets the length of a string you define.\n## Syntax\n```al\nLength :=   Text.StrLen(String: Text)\n```\n> NOTE\n> This method can be invoked without specifying the data type name.\n## Parameters\nString\nType: text-data-type\nThe string for which you want to determine the length.\n## Return Value\nLength\nType: ../integer/integer-data-type\nThe length of the string.\n## Remarks\nThe difference between the StrLen method and the MaxStrLen Method \\(Code, Text\\)<text-maxstrlen-string-method> is that the StrLen returns the actual number of characters in the input string, whereas MaxStrLen returns the maximum defined length of the input string.\nIn Dynamics 365 Business Central, if you call StrLen on a Variant, then you get an error that the contents of the parameter are not valid. In earlier versions of Dynamics 365, if you call StrLen on a Variant, then 0 is returned.\n## Example\nThis example shows the difference between the StrLen and the MaxStrLen methods.\n```al\nvar\n    City: Text[30];\n    MaxLength: Integer;\n    Length: Integer;\n    Text000: Label 'Atlanta';\n    Text001: Label 'The MaxStrLen method returns: %1,\\\\';\n    Text002: Label 'whereas the StrLen method returns: %2';\nbegin\n    City := Text000;\n    MaxLength := MaxStrLen(City);\n    Length := StrLen(City);\n    Message(Text001 + Text002, MaxLength, Length);\nend;\n```\nThe message window displays the following:\nThe MaxStrLen method returns: 30\nwhereas the StrLen method returns: 7\nThis shows that the MaxLength method returns the maximum possible length according to the definition of the string variable, whereas StrLen returns the actual length of the text.\n## Related information\ntext-data-type\nGet Started with AL<../../devenv-get-started>\nDeveloping Extensions<../../devenv-dev-overview>"}