OpenSim.Region.ScriptEngine.Shared.Api.LSL_Api.llParseStringKeepNulls C# (CSharp) Method

Separators demarcate tokens and are elided as they are encountered. Spacers also demarcate tokens, but are themselves retained as tokens. Both separators and spacers may be arbitrarily long strings. i.e. ":::". The function returns an ordered list representing the tokens found in the supplied sources string. If two successive tokenizers are encountered, then a null-string entry is added to the list. It is a precondition that the source and toekizer lisst are non-null. If they are null, then a null pointer exception will be thrown while their lengths are being determined. A small amount of working memoryis required of approximately 8*#tokenizers + 8*srcstrlen. There are many ways in which this function can be implemented, this implementation is fairly naive and assumes that when the function is invooked with a short source string and/or short lists of tokenizers, then performance will not be an issue. In order to minimize the perofrmance effects of long strings, or large numbers of tokeizers, the function skips as far as possible whenever a toekenizer is found, and eliminates redundant tokenizers as soon as is possible. The implementation tries to minimize temporary garbage generation.