File: stdlib-text.md

package info (click to toggle)
golang-github-d5-tengo 2.17.0-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 1,240 kB
  • sloc: makefile: 12
file content (141 lines) | stat: -rw-r--r-- 8,248 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
# Module - "text"

```golang
text := import("text")
```

## Functions

- `re_match(pattern string, text string) => bool/error`: reports whether the
  string s contains any match of the regular expression pattern.
- `re_find(pattern string, text string, count int) => [[{text: string, begin: int, end: int}]]/undefined`:
  returns an array holding all matches, each of which is an array of map object
  that contains matching text, begin and end (exclusive) index.
- `re_replace(pattern string, text string, repl string) => string/error`:
  returns a copy of src, replacing matches of the pattern with the replacement
  string repl.
- `re_split(pattern string, text string, count int) => [string]/error`: slices
  s into substrings separated by the expression and returns a slice of the
  substrings between those expression matches.
- `re_compile(pattern string) => Regexp/error`: parses a regular expression and
  returns, if successful, a Regexp object that can be used to match against
  text.
- `compare(a string, b string) => int`: returns an integer comparing two
  strings lexicographically. The result will be 0 if a==b, -1 if a < b, and +1
  if a > b.
- `contains(s string, substr string) => bool`: reports whether substr is within
  s.
- `contains_any(s string, chars string) => bool`: reports whether any Unicode
  code points in chars are within s.
- `count(s string, substr string) => int`: counts the number of non-overlapping
  instances of substr in s.
- `equal_fold(s string, t string) => bool`: reports whether s and t,
  interpreted as UTF-8 strings,
- `fields(s string) => [string]`: splits the string s around each instance of
  one or more consecutive white space characters, as defined by unicode.IsSpace,
  returning a slice of substrings of s or an empty slice if s contains only
  white space.
- `has_prefix(s string, prefix string) => bool`: tests whether the string s
  begins with prefix.
- `has_suffix(s string, suffix string) => bool`: tests whether the string s
  ends with suffix.
- `index(s string, substr string) => int`: returns the index of the first
  instance of substr in s, or -1 if substr is not present in s.
- `index_any(s string, chars string) => int`: returns the index of the first
  instance of any Unicode code point from chars in s, or -1 if no Unicode code
  point from chars is present in s.
- `join(arr string, sep string) => string`: concatenates the elements of a to
  create a single string. The separator string sep is placed between elements
  in the resulting string.
- `last_index(s string, substr string) => int`: returns the index of the last
  instance of substr in s, or -1 if substr is not present in s.
- `last_index_any(s string, chars string) => int`: returns the index of the
  last instance of any Unicode code point from chars in s, or -1 if no Unicode
  code point from chars is present in s.
- `repeat(s string, count int) => string`: returns a new string consisting of
  count copies of the string s.
- `replace(s string, old string, new string, n int) => string`: returns a copy
  of the string s with the first n non-overlapping instances of old replaced by
  new.
- `substr(s string, lower int, upper int) => string => string`: returns a
  substring of the string s specified by the lower and upper parameters.
- `split(s string, sep string) => [string]`: slices s into all substrings
  separated by sep and returns a slice of the substrings between those
  separators.
- `split_after(s string, sep string) => [string]`: slices s into all substrings
  after each instance of sep and returns a slice of those substrings.
- `split_after_n(s string, sep string, n int) => [string]`: slices s into
  substrings after each instance of sep and returns a slice of those substrings.
- `split_n(s string, sep string, n int) => [string]`: slices s into substrings
  separated by sep and returns a slice of the substrings between those
  separators.
- `title(s string) => string`: returns a copy of the string s with all Unicode
  letters that begin words mapped to their title case.
- `to_lower(s string) => string`: returns a copy of the string s with all
  Unicode letters mapped to their lower case.
- `to_title(s string) => string`: returns a copy of the string s with all
  Unicode letters mapped to their title case.
- `to_upper(s string) => string`: returns a copy of the string s with all
  Unicode letters mapped to their upper case.
- `pad_left(s string, pad_len int, pad_with string) => string`: returns a copy
  of the string s padded on the left with the contents of the string pad_with
  to length pad_len. If pad_with is not specified, white space is used as the
  default padding.
- `pad_right(s string, pad_len int, pad_with string) => string`: returns a
  copy of the string s padded on the right with the contents of the string
  pad_with to length pad_len. If pad_with is not specified, white space is
  used as the default padding.
- `trim(s string, cutset string) => string`: returns a slice of the string s
  with all leading and trailing Unicode code points contained in cutset removed.
- `trim_left(s string, cutset string) => string`: returns a slice of the string
  s with all leading Unicode code points contained in cutset removed.
- `trim_prefix(s string, prefix string) => string`: returns s without the
  provided leading prefix string.
- `trim_right(s string, cutset string) => string`: returns a slice of the
  string s, with all trailing Unicode code points contained in cutset removed.
- `trim_space(s string) => string`: returns a slice of the string s, with all
  leading and trailing white space removed, as defined by Unicode.
- `trim_suffix(s string, suffix string) => string`: returns s without the
  provided trailing suffix string.
- `atoi(str string) => int/error`: returns the result of ParseInt(s, 10, 0)
  converted to type int.
- `format_bool(b bool) => string`: returns "true" or "false" according to the
  value of b.
- `format_float(f float, fmt string, prec int, bits int) => string`: converts
  the floating-point number f to a string, according to the format fmt and
  precision prec.
- `format_int(i int, base int) => string`: returns the string representation of
  i in the given base, for 2 <= base <= 36. The result uses the lower-case
  letters 'a' to 'z' for digit values >= 10.
- `itoa(i int) => string`: is shorthand for format_int(i, 10).
- `parse_bool(s string) => bool/error`: returns the boolean value represented
  by the string. It accepts 1, t, T, TRUE, true, True, 0, f, F, FALSE, false,
  False. Any other value returns an error.
- `parse_float(s string, bits int) => float/error`: converts the string s to a
  floating-point number with the precision specified by bitSize: 32 for float32,
  or 64 for float64. When bitSize=32, the result still has type float64, but it
  will be convertible to float32 without changing its value.
- `parse_int(s string, base int, bits int) => int/error`: interprets a string s
  in the given base (0, 2 to 36) and bit size (0 to 64) and returns the
  corresponding value i.
- `quote(s string) => string`: returns a double-quoted Go string literal
  representing s. The returned string uses Go escape sequences (\t, \n, \xFF,
  \u0100) for control characters and non-printable characters as defined by
  IsPrint.
- `unquote(s string) => string/error`: interprets s as a single-quoted,
  double-quoted, or backquoted Go string literal, returning the string value
  that s quotes.  (If s is single-quoted, it would be a Go character literal;
  Unquote returns the corresponding one-character string.)

## Regexp

- `match(text string) => bool`: reports whether the string s contains any match
  of the regular expression pattern.
- `find(text string, count int) => [[{text: string, begin: int, end: int}]]/undefined`:
  returns an array holding all matches, each of which is an array of map object
  that contains matching text, begin and end (exclusive) index.
- `replace(src string, repl string) => string`: returns a copy of src,
  replacing matches of the pattern with the replacement string repl.
- `split(text string, count int) => [string]`: slices s into substrings
  separated by the expression and returns a slice of the substrings between
  those expression matches.