Strings

echo "words words words ⚑"
echo """
<html>
  <head>
  </head>\n\n

  <body>
  </body>
</html> """

proc re(s: string): string = s

echo r".""."
echo re"\b[a-z]++\b"
$ nim c -r strings.nim
words words words ⚑
<html>
  <head>
  <head/>\n\n

  <body>
  <body/>
<html/>
.".
\b[a-z]++\b

There are several types of string literals:

Strings are null-terminated, so that cstring("foo") requires zero copying. However, you should be careful that the lifetime of the cstring does not exceed the lifetime of the string it is based upon.

Strings can also almost be thought of as seq[char] with respect to assignment semantics. See seqs for the possible manipulations, for example:

echo "abc"[0]
echo "abcdefg"[0 .. 4]
echo "abcdefg"[0 .. ^2]
$ nim c -r strindex.nim
a
abcde
abcdef

The strutils module provides procs for handling strings.

import strutils

var a = "hello welcome,friend"

# The split proc takes a sequence of characters and splits a string based on them
echo a.split({' ', ','})

# The contains proc determines whether a string contains a substring or character
echo a.contains("hello")
$ nim c -r strutils.nim
@["hello", "welcome", "friend"]
true

A note about Unicode

Unicode symbols are allowed in strings, but are not treated in any special way, so if you want count glyphs or uppercase Unicode symbols, you must use the unicode module.

Strings are generally considered to be encoded as UTF-8, so because of Unicode’s backwards compatibility, can be treated exactly as ASCII, with all values above 127 ignored.