# strmisc

Dark Mode

- Manual
- Standard library
- Index

Search:
Group by:

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

# Imports

strutils

# Procs

    proc expandTabs(s: string; tabSize: int = 8): string {...}{.noSideEffect, procvar,
        raises: [], tags: [].}

  Expand 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.

  Examples:

      doAssert expandTabs("\t", 4) == "    "
      doAssert expandTabs("\tfoo\t", 4) == "    foo "
      doAssert expandTabs("\tfoo\tbar", 4) == "    foo bar"
      doAssert expandTabs("\tfoo\tbar\t", 4) == "    foo bar "
      doAssert expandTabs("ab\tcd\n\txy\t", 3) == "ab cd\n   xy "

  Source Edit

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

  Split the string at the first or last occurrence of `sep` into a 3-tuple

  Returns a 3 string tuple of (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

  Examples:

      doAssert partition("foo:bar", ":") == ("foo", ":", "bar")
      doAssert partition("foobarbar", "bar") == ("foo", "bar", "bar")
      doAssert partition("foobarbar", "bank") == ("foobarbar", "", "")
      doAssert partition("foobarbar", "foo") == ("", "foo", "barbar")
      doAssert partition("foofoobar", "bar") == ("foofoo", "bar", "")

  Source Edit

    proc rpartition(s: string; sep: string): (string, string, string) {...}{.
        noSideEffect, procvar, raises: [], tags: [].}

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

  Returns a 3 string tuple of (beforeSep, `sep`, afterSep) or ("", "", `s`) if `sep` is not found

  Examples:

      doAssert rpartition("foo:bar", ":") == ("foo", ":", "bar")
      doAssert rpartition("foobarbar", "bar") == ("foobar", "bar", "")
      doAssert rpartition("foobarbar", "bank") == ("", "", "foobarbar")
      doAssert rpartition("foobarbar", "foo") == ("", "foo", "barbar")
      doAssert rpartition("foofoobar", "bar") == ("foofoo", "bar", "")

  Source Edit