Source   Edit  

strings

bookmark

TLDR

• generally any proc that accepts a string, also accepts a char, and sometimes setchar
• if supporting unicode, use the unicode procs to prevent any gotchas
  • e.g. the default .len proc doesnt return the actual number of chars in a unicode string

links

• high impact
  • str format
  • str utils
  • uri parsing
• niche
  • cstr utils
  • ropes (very long strings)
  • str (high perf) utils
  • str misc
  • unicode
  • unicode decode
  • word wrap
  • encodings
  • edit distance
  • punycode

TODOs

• strutils
  • BinaryPrefixMode, FloatFormatMode, SkipTable, addSep, alignleft,right
  • center, cmpIgnoreStyle, dedent, indent, indentation, unindent
  • nimIdentNormalize, validIdentifier
  • format (like % +auto stringifies), normalize, spaces
  • formatBiggestFloat, formatEng, Float, Size, fromBin, Hex, Oct
  • initSkipTable, insertSep, intToStr
  • isAlphaAscii, Numeric,
  • isDigit, EmptyOrWhitespace, LowerAscii, SpaceAscii, UpperAscii
  • parseInt, BiggestInt/Uint, BinInt, Bool, Enum, Float, HexInt, HexStr, OctInt, Uint
  • toBin,Hex,Oct,Octal
  • trimZeros,
• rework this entire file
  • we dont need examples of every fkn proc, but we should list them

strformat

• simply importing strformat enhances the system & operator
• doesnt interprate literal escapes like & does e.g. fmt"{str1}nnn"
• escape works with these char and string literals
  • for others use a hex/decimal char/string
  • if an API returns a string regex containing \s im sure theres something in regex.nim that can help
• fmt syntax: [fillalign]sign0.precision
  • 3 align flags: > < ^
  • 3 sign flags for numbers: + - (space)
  • additional flags exist specifically for integers & floats
• fmt floats section is interesting
  • as is fmt expressions
  • shiz gets crazy
  • flags for fmt

strutils

• AllChars (and related) useful for creating inverted sets to check for invalid chars in a string
• % used for index/named replacement
• stripLineEnd is useful conjunction with osproc.execCmdEx
• skipped type conversion procs; check skipped for the ones we skipped
• the split like procs also have an iterator syntax that accepts a block
• tokenize looks interesting

string formatters

• strutils: "$1 $2" % "first, "second"
• strformat: fmt"{first} {second}"