Type of number to display

Int Number. Float Number. No number

Words can be like "two hundred eighty-eight"

Lower case word, Capitalized word, Upper case word

Words that use a float number like "two point one"

Roman number like XXI

Purpose: Avoid strings like "1 days" when it should be "1 day"

Send the number of the amount of things. 1 == singular

Send the singular word and the plural word

Accepts an optional NumberMode

Example:

assert multistring(1, "day", "days") == "1 day"
assert multistring(3, "cat", "cats") == "3 cats"
assert multistring(4, "dog", "dogs", NoNumber) == "dogs"
assert multistring(4, "dog", "dogs", LowWord) == "four dogs"
assert multistring(4, "DOG", "DoGs", CapWord) == "Four DoGs"
assert multistring(1, "dog", "dogs", UpWord) == "ONE dog"
assert multistring(1.2, "thing", "things", Number) == "1 thing"
assert multistring(1.2, "thing", "things", FloatNumber) == "1.2 things"
assert multistring(1.2, "thing", "things", LowWord) == "one thing"
assert multistring(1.2, "thing", "things", FloatUpWord) == "ONE POINT TWO things"
assert multistring(1.2, "thing", "things", Roman) == "I thing"

Purpose: Turn numbers into english words

Submit the number that is transformed into words

Example:

assert numberwords(0) == "zero"
assert numberwords(10) == "ten"
assert numberwords(122) == "one hundred twenty-two"
assert numberwords(3_654_321) == "three million six hundred fifty-four thousand three hundred twenty-one"
assert numberwords(9.1818) == "nine point two"
assert numberwords(603000000) == "six hundred three million"

Example:

assert countword("a") == 1
assert countword("z") == 26
assert countword("abc") == 6
assert countword("2 abc #$% 2") == 10

Purpose: Get the timeago message between two dates

Used for simple messages like "posted 1 hour ago"

The dates are 2 unix timestamps in seconds

Accepts an optional NumberMode

Example:

assert timeago(0, 10) == "10 seconds"
assert timeago(0, 140) == "2 minutes"
assert timeago(0, 140, FloatNumber) == "2.3 minutes"
assert timeago(0, Hour * 3, LowWord) == "three hours"
assert timeago(0, Month, CapWord) == "One Month"
assert timeago(0, Year * 10, UpWord) == "TEN YEARS"

Purpose: Generate random string tags

It alternates between vowels and consonants

Receives a number to set the length

Receives a boolean to set if vowels go first

A rand seed can be provided as an extra argument

Example:

let wtag = wordtag(3, true)
assert wtag.len == 3
assert wtag[0] in Vowels
assert wtag[1] in Consonants

Example:

assert leetspeak("maple strikter") == "m4pl3 s7r1k73r"

Purpose: Add numbers to lines

Send an array of lines

And the left and right parts around the number

Accepts an optional NumberMode

Example:

assert numerate(["This line", "That line"], "", ")") == "1) This line\n2) That line"
assert numerate(["This line", "That line"], "[", "]", LowWord) == "[one] This line\n[two] That line"
assert numerate(["This line", "That line"], "[", "]", CapWord) == "[One] This line\n[Two] That line"
assert numerate(["This line", "That line"], "[", "]", UpWord) == "[ONE] This line\n[TWO] That line"
assert numerate(["This line", "That line"], "(", ")", Roman) == "(I) This line\n(II) That line"

Purpose: Replace token with an incrementing number

Send the text and token

Accepts an optional NumberMode

Example:

assert insertnum("This is $ and this is $", "$") == "This is 1 and this is 2"
assert insertnum("Hello _ and _", "_", LowWord) == "Hello one and two"
assert insertnum("Hello _ and _", "_", CapWord) == "Hello One and Two"
assert insertnum("Hello _ and _", "_", UpWord) == "Hello ONE and TWO"
assert insertnum("x x x x x", "x", Roman) == "I II III IV V"

Print the number of words and characters per line

Send an array of lines

And two booleans to enable/disable words & chars

Example:

assert linesummary(["hello there"], true, true) == "hello there (2 words) (10 chars)"
assert linesummary(["ab", "c d e"], false, true) == "ab (2 chars)\nc d e (3 chars)"
assert linesummary(["ab", "c d e"], false, true, CapWord) == "ab (Two Chars)\nc d e (Three Chars)"

Example:

assert romano(21) == "XXI"
assert romano(1994) == "MCMXCIV"
assert romano(1) == "I"
assert romano(0) == "0"
assert romano(-11) == "-XI"

Example:

import std/options

assert wordsnumber("six hundred three").get() == 603.0
assert wordsnumber("six hundred three million").get() == 603000000.0
assert wordsnumber("six million three hundred ten thousand six hundred thirty-two").get() == 6310632.0
assert wordsnumber("zero").get() == 0
assert wordsnumber("minus four thousand two").get() == -4002.0
assert wordsnumber("thirty-three point three").get() == 33.3
assert wordsnumber("thirty three point five hundred thirty two thousand eleven").get() == 33.532011
assert wordsnumber("three hundred forty").get() == 340
assert wordsnumber("One HUNDRED NiNeteen").get() == 119
assert wordsnumber("minus three three two one seven point five").get() == -33217.5
assert wordsnumber("nothing here") == none(float)
assert wordsnumber("nothing two here forty").get() == 240

Turn a string into morse code

Words in the result are separated by a slash

Example:

assert writemorse("a b   c") == ".- / -... / -.-."
assert writemorse("420") == "....- ..--- -----"
assert writemorse("hunter 2") == ".... ..- -. - . .-. / ..---"
assert writemorse("@$.,") == ".--.-. ...-..- .-.-.- --..--"
assert writemorse("what 112 !!?") == ".-- .... .- - / .---- .---- ..--- / -.-.-- -.-.-- ..--.."
assert writemorse("100 + 200") == ".---- ----- ----- / .-.-. / ..--- ----- -----"

Turn morse code into a string

Words should be separated by a slash

Example:

assert readmorse(".-- .... .- - / .---- .---- ..--- / -.-.-- -.-.-- ..--..") == "what 112 !!?"
assert readmorse("- .... . / -- .- --. .. -.-. .. .- -.") == "the magician"
assert readmorse(".---- ----- ----- / .-.-. / ..--- ----- -----") == "100 + 200"

Shuffle words around

Send a string to be shuffled

A rand seed can be provided as an extra argument

Example:

import std/random
var rng = initRand(100)
assert shufflewords("this thing is", rng) == "thing is this"
assert shufflewords("this thing is", rng) == "this thing is"
assert shufflewords("this thing is", rng) == "thing this is"

Replace all numbers in a string

Send a text string

It checks every word in search for numbers

Accepts an optional NumberMode

Example:

assert textnumbers("Number 3.2 and 8.9") == "Number 3 and 8"
assert textnumbers("Number 3.2 and 8.9", FloatNumber) == "Number 3.2 and 8.9"
assert textnumbers("Number 3 and 8", LowWord) == "Number three and eight"
assert textnumbers("Number 3 and 8", Roman) == "Number III and VIII"
assert textnumbers("3.2 and 8.9", FloatCapWord) == "Three Point Two and Eight Point Nine"

Replace all words with their string length

Send a text string

Send a boolean to specify if words are kept

Accepts an optional NumberMode

Example:

assert wordslen("what is there", false) == "4 2 5"
assert wordslen("what is there", true) == "what (4) is (2) there (5)"
assert wordslen("what is there", false, CapWord) == "Four Two Five"
assert wordslen("what is there", true, Roman) == "what (IV) is (II) there (V)"

Capitalize every other letter

Send a text string

Send a boolean to specify if caps go first

Example:

assert dumbspeak("hello there", true) == "HeLlO tHeRe"
assert dumbspeak("hello there", false) == "hElLo ThErE"

Example:

assert nobreaks("this.\nthing") == "this. thing"

Add a frame around the text with a certain character

Send a text string

Send the max width of the output

Send the token used as the frame

Linebreaks get removed from the string

Example:

let s1 = """
############
# One line #
# Another  #
# line     #
############"""

let s2 = """
################
# One line     #
# Another line #
################"""

let s3 = """
#########################
# One line Another line #
#########################"""

assert charframe("One line\nAnother line", 10, '#') == s1
assert charframe("One line\nAnother line", 15, '#') == s2
assert charframe("One line\nAnother line", 25, '#') == s3

Get a list of the longest words

All words in the output are of equal length

Example:

assert longestwords("Is that the only solution to this problem?") == @["solution", "problem?"]

Get a list of the longest words

All words in the output are of equal length

Example:

assert shortestwords("Is that the only solution to this problem?") == @["is", "to"]

Remove chars from strings

Send a text string

Send an array of chars to replace

Send an optional replace_with string

Example:

assert repstring("what !is! this???!", ['!', '?']) == "what is this"
assert repstring("what??is this", ['?', 's'], "@") == "what@@i@ thi@"

Remove all non-ascii chars

Send an optional bool to set if numbers are kept

Example:

assert asciistring("That thing!!") == "That thing"
assert asciistring("N!u!mber 22...") == "Number 22"
assert asciistring("w2h2a2t 5is t4hi9s", false) == "what is this"

Remove all chars except the given ones

Send a text string

Send an array of chars to keep

Example:

assert keepchars("hello these thing", ['e', 'l']) == "ell ee"
assert keepchars("eeEEmsteeEm", ['E', 'm']) == "EEmEm"

Example:

assert remove_punctuation("hello, what is this?") == "hello what is this"
assert remove_punctuation("hello!! ok; ??") == "hello ok"
assert remove_punctuation("Hello #12") == "Hello #12"
assert remove_punctuation("Hello?!!?:?!:;; There") == "Hello There"

Example:

assert count_vowels("la pacha") == 3

Example:

assert count_consonants("la pacha") == 4

Count the number of letters in a string

Doesn't count whitespace

Example:

assert countletters("hello world") == 10

Print words every x milliseconds

Send a text string

Send the max number of words per line

Send the sleep delay in ms