# std/strmisc

Theme:

- Manual
- Standard library
- Index
- Compiler docs
- Fusion docs
- devel, stable

Search:
Source Edit

This module contains various string utility routines that are uncommonly used in comparison to the ones in strutils.

# Imports

strutils

# Procs

    func expandTabs(s: string; tabSize: int = 8): string {....raises: [], tags: [],
        forbids: [].}

  Expands tab characters in `s`, replacing them by spaces.

  The amount of inserted spaces for each tab character is the difference between the current column number and the next tab position. Tab positions occur every `tabSize` characters. The column number starts at 0 and is increased with every single character and inserted space, except for newline, which resets the column number back to 0.

  Example:

      doAssert expandTabs("\t", 4) == "    "
      doAssert expandTabs("\tfoo\t", 4) == "    foo "
      doAssert expandTabs("a\tb\n\txy\t", 3) == "a  b\n   xy "

  Source Edit

    func partition(s: string; sep: string; right: bool = false): (string, string,
        string) {....raises: [], tags: [], forbids: [].}

  Splits the string at the first (if `right` is false) or last (if `right` is true) occurrence of `sep` into a 3-tuple.

  Returns a 3-tuple of strings, `(beforeSep, sep, afterSep)` or `(s, "", "")` if `sep` is not found and `right` is false or `("", "", s)` if `sep` is not found and `right` is true.

  See also:

  - rpartition proc

  Example:

      doAssert partition("foo:bar:baz", ":") == ("foo", ":", "bar:baz")
      doAssert partition("foo:bar:baz", ":", right = true) == ("foo:bar", ":", "baz")
      doAssert partition("foobar", ":") == ("foobar", "", "")
      doAssert partition("foobar", ":", right = true) == ("", "", "foobar")

  Source Edit

    func rpartition(s: string; sep: string): (string, string, string) {....raises: [],
        tags: [], forbids: [].}

  Splits the string at the last occurrence of `sep` into a 3-tuple.

  Returns a 3-tuple of strings, `(beforeSep, sep, afterSep)` or `("", "", s)` if `sep` is not found. This is the same as `partition(s, sep, right = true)`.

  See also:

  - partition proc

  Example:

      doAssert rpartition("foo:bar:baz", ":") == ("foo:bar", ":", "baz")
      doAssert rpartition("foobar", ":") == ("", "", "foobar")

  Source Edit