StringLen
Revision as of 15:12, 10 March 2008 by imported>Speedo (Expanding string info)
Beta Function
This function has not been fully tested yet, and is not ready to be used in a released mod. It may not have the same function in later versions, may require the script to be recompiled, or simply may be removed. Use for testing purposes only until the author of the function says otherwise.
A command for Pluggy.
Syntax:
(Length:long) StringLen StringID:long NewLength:long Global:short
Returns or sets the string length.
- If NewLength is not specified, it returns the current length.
- If NewLength is specified, it sets the size and returns the new size.
- If you want to modify a string from another mod, you will need to set the Global flag to 1. If Global is 0 or unset the function will fail. If the string is protected the function will fail.
- If the string does not exist, it returns -1.
Notes
- To effectively clear out a string without destroying and recreating, set the length to 0.
StringLen StringID 0
- If you expand the size of an existing string, each new character is set to the null character (\0).