strtabs

nimony/lib/std/strtabs.nim

• type StringTableMode = enum
    modeCaseSensitive = (0, "modeCaseSensitive")
    modeCaseInsensitive = (1, "modeCaseInsensitive")
    modeStyleInsensitive = (2, "modeStyleInsensitive")

• func dollar`.StringTableMode(e: StringTableMode): string

• type StringTableObj = object
    counter: int64
    data: seq
    mode: StringTableMode

• type StringTableRef = ref StringTableObj not nil

• type FormatFlag = enum
    useEnvironment = (0, "useEnvironment")
    useEmpty = (1, "useEmpty")
    useKey = (2, "useKey")

• func dollar`.FormatFlag(e: FormatFlag): string
• proc mode(t: ref StringTableObj not nil): StringTableMode
• iterator pairs(t: ref StringTableObj not nil): tuple[key: string, value: string]

  Iterates over every (key, value) pair in the table t.

• iterator keys(t: ref StringTableObj not nil): string

  Iterates over every key in the table t.

• iterator values(t: ref StringTableObj not nil): string

  Iterates over every value in the table t.

• proc len(t: ref StringTableObj not nil): int64

  Returns the number of keys in t.

• proc [](t: ref StringTableObj not nil; key: string): var string

  Retrieves the location at t[key].

  If key is not in t, the KeyError exception is raised. One can check with hasKey proc whether the key exists.

  See also:

  • getOrDefault proc
  • []= proc for inserting a new

  (key, value) pair in the table

  • hasKey proc for checking if a key

  is in the table

• proc getOrDefault(t: ref StringTableObj not nil; key: string; default: string): string

  Retrieves the location at t[key].

  If key is not in t, the default value is returned (if not specified, it is an empty string ("")).

  See also:

  • [] proc for retrieving a value of a key
  • hasKey proc for checking if a key

  is in the table

  • []= proc for inserting a new

  (key, value) pair in the table

• proc hasKey(t: ref StringTableObj not nil; key: string): bool

  Returns true if key is in the table t.

  See also:

  • getOrDefault proc
  • contains proc
• proc contains(t: ref StringTableObj not nil; key: string): bool

  Alias of hasKey proc for use with the in operator.

• proc []=(t: ref StringTableObj not nil; key: string; val: string)

  Inserts a (key, value) pair into t.

  See also:

  • [] proc for retrieving a value of a key
  • del proc for removing a key from the table
• proc newStringTable(mode: StringTableMode): ref StringTableObj not nil

  Creates a new empty string table.

  See also:

  • `newStringTable(keyValuePairs) proc

  <#newStringTable,varargs[tuple[string,string]],StringTableMode>`_

• proc clear(s: ref StringTableObj not nil; mode: StringTableMode)

  Resets a string table to be empty again, perhaps altering the mode.

  See also:

  • del proc for removing a key from the table
• proc clear(s: ref StringTableObj not nil)

  Resets a string table to be empty again without changing the mode.

• proc del(t: ref StringTableObj not nil; key: string)

  Removes key from t.

  See also:

  • clear proc for resetting a

  table to be empty

  • []= proc for inserting a new

  (key, value) pair in the table

• proc $(t: ref StringTableObj not nil): string

  The $ operator for string tables. Used internally when calling echo on a table.

• proc %(f: string; t: ref StringTableObj not nil; flags: set[FormatFlag]): string

  The % operator for string tables.