CreateString
Revision as of 20:30, 25 March 2008 by imported>Speedo (Added notes)
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:
(StringID:long) CreateString EspID:short Text:string Protected:short RefuseZero:short
Creates a new string containing Text tagged with the EspID, and returns the StringID of the new string.
- If EspID is not specified or is -1, then the EspID is automatically associated to the calling mod.
- If Protected is not 0, then the string will be write-protected from other mods, and only the associated mod will ever be able to modify the string. Setting Protected to 1 is recommended if you don’t want your string to be modified by another mod.
- If the ESP file is not active upon reloading a savegame, all the associated strings are destroyed when/if the player saves.
- If RefuseZero is 1, then the returned StringID will never be zero.
Notes
- There is no way to pass the function a blank string. If you wish to create a string that is Protected or refuses StringID 0, use StringLen immediately after creating the string:
set nuString to CreateString -1 0 1 1 StringLen nuString 0