str Module

%

% ⇒ interpolate

See interpolate.

=%

=% ⇒ apply-interpolate

See apply-interpolate.

=~

=~ ⇒ regex

See regex.

apply-interpolate

string quot ⇒ string

The same as pushing apply and then interpolate on the stack.

capitalize

'sym ⇒ string

Returns a copy of 'sym with the first character capitalized.

chr

int ⇒ string

Returns the single character string obtained by interpreting int as an ASCII code.

escape

'sym ⇒ string

Returns a copy of 'sym with quotes and backslashes escaped with a backslash.

from-semver

string ⇒ dict

Given a basic SemVer-compliant string (with no additional labels) string, it pushes a dictionary dict on the stack containing a major, minor, and patch key/value pairs.

indent

'sym int ⇒ string

Returns string containing 'sym indented with int spaces.

indexof

string1 string2 ⇒ int

If string2 is contained in string1, returns the index of the first match or -1 if no match is found.

interpolate

string quot ⇒ string

Substitutes the placeholders included in string with the values in quot.

Notes

  • If quot contains symbols or quotations, they are not interpreted. To do so, call apply before interpolating or use apply-interpolate instead.
  • You can use the $# placeholder to indicate the next placeholder that has not been already referenced in the string.
  • You can use named placeholders like $pwd, but in this case quot must contain a quotation containing both the placeholder names (odd items) and the values (even items).

Example

The following code (executed in a directory called ‘/Users/h3rald/Development/min’ containing 19 files):

"Directory '$1' includes $2 files." (. (. ls 'file? filter size)) apply interpolate

produces:

"Directory '/Users/h3rald/Development/min' includes 19 files."

join

quot 'sym ⇒ string

Joins the elements of quot using separator 'sym, producing string.

length

'sym ⇒ int

Returns the length of 'sym.

lowercase

'sym ⇒ string

Returns a copy of 'sym converted to lowercase.

match

string1 string2 ⇒ bool

Returns true if string2 matches string1, false otherwise.

Tip

string2 can be a sgregex.-compatible regular expression.

ord

string ⇒ int

Returns the ASCII code int corresponding to the single character string.

parse-url

string ⇒ url

Parses the url string into its components and stores them into url.

prefix

'sym1 'sym2 ⇒ string

Prepends 'sym2 to 'sym1.

repeat

'sym int ⇒ string

Returns string containing 'sym repeated int times.

replace

string1 string2 string3 ⇒ string4

Returns a copy of string1 containing all occurrences of string2 replaced by string3

Tip

string2 can be a sgregex.-compatible regular expression.

Example

The following:

"This is a stupid test. Is it really a stupid test?" " s[a-z]+" " simple" replace

produces:

"This is a simple test. Is it really a simple test?"

regex

string1 string2 ⇒ quot

Performs a search and/or a search-and-replace operation using pattern string2.

string2 can be one of the following patterns:

  • /search-regex/modifiers
  • s/search-regex/replacemenet/modifiers

quot is always a quotation containing:

  • One or more strings containing the first match and captures (if any), like for the search operator.
  • A string containing the resuling string after the search-and-replace operation.

Tip

  • search-regex can be a sgregex.-compatible regular expression.
  • modifiers are optionals can contain one or more of the following characters, in any order:
    • i: case-insensitive match.
    • m: multi-line match.
    • s: dot character includes newlines.

Example: Search

The following:

"This is a GOOD idea." "/(good) idea/i" regex

produces: ("GOOD idea", "GOOD")

Example: Search and Replace

The following:

"This is a GOOD idea." "s/good/bad/i" regex

produces: ("This is a bad idea")

search

string1 string2 ⇒ quot

Returns a quotation containing the first occurrence of string2 within string2. Note that:

  • The first element of quot is the matching substring.
  • Other elements (if any) contain captured substrings.

Tip

string2 can be a sgregex.-compatible regular expression.

Example

The following:

"192.168.1.1, 127.0.0.1" "[0-9]+\.[0-9]+\.([0-9]+)\.([0-9]+)" search

produces: ("192.168.1.1", "1", "1")

semver-inc-major

string1 ⇒ string2

Increments the major digit of the SemVer-compliant string (with no additional labels) string1.

semver-inc-minor

string1 ⇒ string2

Increments the minor digit of the SemVer-compliant string (with no additional labels) string1.

semver-inc-patch

string1 ⇒ string2

Increments the patch digit of the SemVer-compliant string (with no additional labels) string1.

semver?

string ⇒ bool

Checks whether string is a SemVer-compliant version or not.

split

'sym1 'sym2 ⇒ quot

Splits 'sym1 using separator 'sym2 and returns the resulting strings within the quotation quot.

strip

'sym ⇒ string

Returns string, which is set to 'sym with leading and trailing spaces removed.

substr

string1 int1 int2 ⇒ string2

Returns a substring string2 obtained by retriving int2 characters starting from index int1 within string1.

suffix

'sym1 'sym2 ⇒ string

Appends 'sym2 to 'sym1.

titleize

'sym ⇒ string

Returns a copy of 'sym in which the first character of each word is capitalized.

to-semver

dict ⇒ string

Given a a dictionary dict containing a major, minor, and patch key/value pairs , it pushes a basic SemVer-compliant string (with no additional labels) string on the stack.

uppercase

'sym1 ⇒ 'sym2

Returns a copy of 'sym converted to uppercase.