internal API for now, subject to modifications and moving around
string API's focusing on performance, that can be used as building blocks for other routines.
Un-necessary allocations are avoided and appropriate algorithms are used at the expense of code clarity when justified.
Procs
proc dataPointer[T](a: T): pointer
- same as C++ data that works with std::string, std::vector etc. Note: safe to use when a.len == 0 but whether the result is nil or not is implementation defined for performance reasons. Source Edit
proc forceCopy(result: var string; a: string) {....raises: [], tags: [].}
- also forces a copy if a is shallow Source Edit
proc setLen(result: var string; n: int; isInit: bool) {....raises: [], tags: [].}
- when isInit = false, elements are left uninitialized, analog to {.noinit.} else, there are 0-initialized. Source Edit
proc toLowerAscii(a: var string) {....raises: [], tags: [].}
- optimized and inplace overload of strutils.toLowerAscii Source Edit