str Module

%

% ⇒ interpolate

See interpolate.

=%

=% ⇒ apply-interpolate

See apply-interpolate.

apply-interpolate

str quot ⇒ str

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

capitalize

'sym ⇒ str

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

chr

int ⇒ str

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

escape

'sym ⇒ str

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

from-semver

str ⇒ dict

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

indent

'sym int ⇒ str

Returns str containing 'sym indented with int spaces.

indexof

str1 str2 ⇒ int

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

interpolate

str quot ⇒ str

Substitutes the placeholders included in str 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 ⇒ str

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

length

'sym ⇒ int

Returns the length of 'sym.

lowercase

'sym ⇒ str

Returns a copy of 'sym converted to lowercase.

match?

str1 str2 ⇒ bool

Returns true if str2 matches str1, false otherwise.

Tip

str2 is a Perl Compatible Regular Expression.

ord

str ⇒ int

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

parse-url

str ⇒ dict:url

Parses the url str into its components and stores them into dict:url.

prefix

'sym1 'sym2 ⇒ str

Prepends 'sym2 to 'sym1.

repeat

'sym int ⇒ str

Returns str containing 'sym repeated int times.

replace

str1 str2 str3 ⇒ str4

Returns a copy of str1 containing all occurrences of str2 replaced by str3

Tip

str2 is a Perl 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?"

replace-apply

str1 str2 quot ⇒ str3

Returns a copy of str1 containing all occurrences of str2 replaced by applying quot to each quotation corresponding to each match.

Tip

str2 is a Perl Compatible Regular Expression.

Example

The following:

":1::2::3::4:" ":(\d):" (1 get :d "-$#-" (d) =%) replace-apply

produces:

"-1--2--3--4-"

Note that for each match the following quotations (each containing the full match and the captured matches) are produced as input for the replace quotation: (“-1-” “1”) (“-2-” “2”) (“-3-” “3”) (“-4-” “4”)

search

str1 str2 ⇒ quot

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

  • The first element of quot is the matching substring.
  • Other elements (if any) contain captured substrings.
  • If no matches are found, the quotation contains empty strings.

Tip

str2 is a Perl 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")

search-all

str1 str2 ⇒ quot

Returns a quotation of quotations (like the one returned by the search operator) containing all occurrences of str2 within str1.

semver-inc-major

str1 ⇒ str2

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

semver-inc-minor

str1 ⇒ str2

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

semver-inc-patch

str1 ⇒ str2

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

semver?

str ⇒ bool

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

split

'sym1 'sym2 ⇒ quot

Splits 'sym1 using separator 'sym2 (a Perl Compatible Regular Expression) and returns the resulting strings within the quotation quot.

strip

'sym ⇒ str

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

substr

str1 int1 int2 ⇒ str2

Returns a substring str2 obtained by retrieving int2 characters starting from index int1 within str1.

suffix

'sym1 'sym2 ⇒ str

Appends 'sym2 to 'sym1.

titleize

'sym ⇒ str

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

to-semver

dict ⇒ str

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) str on the stack.

uppercase

'sym1 ⇒ 'sym2

Returns a copy of 'sym converted to uppercase.