std/strmisc

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