Source Edit

This module provides some high performance string operations.

Experimental API, subject to change.

Procs

  1. proc add(x: var string; y: openArray[char]) {....raises: [], tags: [], forbids: [].}

Concatenates x and y in place. y must not overlap with x to allow future memcpy optimizations. Source Edit 

  1. func setSlice(s: var string; slice: Slice[int]) {....raises: [], tags: [],
  2.     forbids: [].}

Inplace version of substr.

Example:

  1. import std/sugar
  3. var a = "Hello, Nim!"
  4. doAssert a.dup(setSlice(7 .. 9)) == "Nim"
  5. doAssert a.dup(setSlice(0 .. 0)) == "H"
  6. doAssert a.dup(setSlice(0 .. 1)) == "He"
  7. doAssert a.dup(setSlice(0 .. 10)) == a
  8. doAssert a.dup(setSlice(1 .. 0)).len == 0
  9. doAssert a.dup(setSlice(20 .. -1)).len == 0
  12. doAssertRaises(AssertionDefect):
  13.   discard a.dup(setSlice(-1 .. 1))
  15. doAssertRaises(AssertionDefect):
  16.   discard a.dup(setSlice(1 .. 11))

Source Edit 

  1. func strip(a: var string; leading = true; trailing = true;
  2.            chars: set[char] = whitespaces) {.inline, ...raises: [], tags: [],
  3.     forbids: [].}

Inplace version of strip. Strips leading or trailing chars (default: whitespace characters).

If leading is true (default), leading chars are stripped. If trailing is true (default), trailing chars are stripped. If both are false, the string is unchanged.

Example:

  1. var a = "  vhellov   "
  2. strip(a)
  3. assert a == "vhellov"
  5. a = "  vhellov   "
  6. a.strip(leading = false)
  7. assert a == "  vhellov"
  9. a = "  vhellov   "
  10. a.strip(trailing = false)
  11. assert a == "vhellov   "
  13. var c = "blaXbla"
  14. c.strip(chars = {'b', 'a'})
  15. assert c == "laXbl"
  16. c = "blaXbla"
  17. c.strip(chars = {'b', 'a', 'l'})
  18. assert c == "X"

Source Edit