API
#bytesByte-string helpers, parallel to strings. Buffer is readable and writable. Search uses Horspool.
struct Bufferpub struct Buffer {
pub data string
pub off int
}Owning byte helpers aligned with `bytes` (Buffer, Equal, Compare, IndexByte, Count, Replace, HasPrefix). Unread views are copied strings, never a shared []byte header. Do not wrap Buffer in Result. Text cutsets, callbacks and simple case mappings share `#strings` Unicode semantics. IndexByte and MapBytes retain their explicit byte contracts.
data stringoff intbufferpub fn buffer() Bufferbuffer; returns Buffer.
none
Buffer — a value of this type
buffer_frompub fn buffer_from(s string) BufferBuffer from.
s stringBuffer — a value of this type
(&mut Buffer) writepub fn (b &mut Buffer) write(data &string) intMethod on `&mut Buffer`: write data and return the byte count.
b &mut Bufferdata &stringint — bytes written
(&mut Buffer) write_bytepub fn (b &mut Buffer) write_byte(c int) intMethod on `&mut Buffer`: write one byte. Throws on failure.
b &mut Bufferc intint — bytes written
(&mut Buffer) read_npub fn (b &mut Buffer) read_n(n int) stringMethod on `&mut Buffer`: read at most n bytes; may return shorter or empty at end.
b &mut Buffern intstring — result string
(&Buffer) lengthpub fn (b &Buffer) length() intMethod on `&Buffer`: return the current length.
b &Bufferint — a value of this type
(&Buffer) textpub fn (b &Buffer) text() stringMethod on `&Buffer`: return the current text.
b &Bufferstring — result string
(&Buffer) bytespub fn (b &Buffer) bytes() stringMethod on `&Buffer`: return the buffered bytes.
b &Bufferstring — result string
(&mut Buffer) resetpub fn (b &mut Buffer) reset()Method on `&mut Buffer`: clear internal state so the value can be reused.
b &mut Buffer(&mut Buffer) truncatepub fn (b &mut Buffer) truncate(n int) intCall `truncate` on `&mut Buffer`. Throws on failure.
b &mut Buffern intint — a value of this type
view_ofpub fn view_of(s &string) strings.ByteViewView of.
s &stringstrings.ByteView — a value of this type
view_slicepub fn view_slice(s &string, off int, n int) strings.ByteViewView slice.
s &stringoff intn intstrings.ByteView — a value of this type
equalpub fn equal(a &string, b &string) boolReport whether the two values are equal.
a &stringb &stringbool — true or false
comparepub fn compare(a &string, b &string) intLexicographic compare: -1, 0, or 1.
a &stringb &stringint — -1 if less, 0 if equal, 1 if greater
has_prefixpub fn has_prefix(s &string, prefix string) boolReport whether the value has the given prefix.
s &stringprefix stringbool — true or false
has_suffixpub fn has_suffix(s &string, suffix string) boolReport whether the value has the given suffix.
s &stringsuffix stringbool — true or false
index_bytepub fn index_byte(s &string, c int) intIndex of the first byte c; -1 if missing.
s &stringc intint — index; -1 if missing
last_index_bytepub fn last_index_byte(s &string, c int) intIndex of the last byte c; -1 if missing.
s &stringc intint — index; -1 if missing
last_indexpub fn last_index(s &string, sub string) intIndex of the last occurrence; -1 if missing.
s &stringsub stringint — index; -1 if missing
countpub fn count(s &string, sub string) intCount non-overlapping occurrences.
s &stringsub stringint — a value of this type
replacepub fn replace(s &string, old string, new string, n int) stringReplace a substring, limited by n.
s &stringold stringnew stringn intstring — result string
replace_allpub fn replace_all(s &string, old string, new string) stringReplace every occurrence of the substring.
s &stringold stringnew stringstring — result string
containspub fn contains(s &string, sub string) boolReport whether the input contains the given piece.
s &stringsub stringbool — true or false
indexpub fn index(s &string, sub string) intIndex of the first occurrence; -1 if missing.
s &stringsub stringint — index; -1 if missing
trim_leftpub fn trim_left(s &string, cutset string) stringStrip leading bytes that appear in the cutset.
s &stringcutset stringstring — result string
trim_rightpub fn trim_right(s &string, cutset string) stringStrip trailing bytes that appear in the cutset.
s &stringcutset stringstring — result string
trimpub fn trim(s &string, cutset string) stringStrip leading and trailing bytes that appear in the cutset.
s &stringcutset stringstring — result string
trim_spacepub fn trim_space(s &string) stringStrip leading and trailing ASCII whitespace.
s &stringstring — result string
trim_prefixpub fn trim_prefix(s &string, pre string) stringRemove prefix if present; otherwise return the input.
s &stringpre stringstring — result string
trim_suffixpub fn trim_suffix(s &string, suf string) stringRemove suffix if present; otherwise return the input.
s &stringsuf stringstring — result string
joinpub fn join(parts []string, sep string) stringJoin pieces with a separator.
parts []stringsep stringstring — result string
splitpub fn split(s &string, sep string) []stringSplit on the separator.
s &stringsep string[]string — slice result
fieldspub fn fields(s &string) []stringSplit on whitespace runs and drop the whitespace.
s &string[]string — slice result
index_funcpub fn index_func(s &string, f fn(int) bool) intText callbacks receive runes, aligned with strings. MapBytes remains byte-based.
s &stringf fn(int) boolint — index; -1 if missing
last_index_funcpub fn last_index_func(s &string, f fn(int) bool) intLast index where the callback is true; -1 if missing.
s &stringf fn(int) boolint — index; -1 if missing
map_bytespub fn map_bytes(s &string, f fn(int) int) stringMap each byte through f and rebuild the string.
s &stringf fn(int) intstring — result string
fields_funcpub fn fields_func(s &string, f fn(int) bool) []stringSplit on bytes for which the callback is true.
s &stringf fn(int) bool[]string — slice result
clonepub fn clone(s &string) stringCopy into a new independent string.
s &stringstring — result string
contains_funcpub fn contains_func(s &string, f fn(int) bool) boolReport whether any byte satisfies the callback.
s &stringf fn(int) boolbool — true or false
index_anypub fn index_any(s &string, chars string) intIndex of the first byte that appears in the cutset; -1 if missing.
s &stringchars stringint — index; -1 if missing
last_index_anypub fn last_index_any(s &string, chars string) intLast index of any cutset byte; -1 if missing.
s &stringchars stringint — index; -1 if missing
contains_anypub fn contains_any(s &string, chars string) boolReport whether any byte from the cutset occurs.
s &stringchars stringbool — true or false
index_runepub fn index_rune(s &string, r int) intIndex of the first rune; -1 if missing.
s &stringr intint — index; -1 if missing
contains_runepub fn contains_rune(s &string, r int) boolReport whether the rune occurs.
s &stringr intbool — true or false
split_npub fn split_n(s &string, sep string, n int) []stringSplit on the separator, at most n parts.
s &stringsep stringn int[]string — slice result
split_afterpub fn split_after(s &string, sep string) []stringSplit after the separator, keeping it on each piece.
s &stringsep string[]string — slice result
split_after_npub fn split_after_n(s &string, sep string, n int) []stringSplit after the separator, at most n parts.
s &stringsep stringn int[]string — slice result
trim_left_funcpub fn trim_left_func(s &string, f fn(int) bool) stringTrim leading bytes using the callback.
s &stringf fn(int) boolstring — result string
trim_right_funcpub fn trim_right_func(s &string, f fn(int) bool) stringTrim trailing bytes using the callback.
s &stringf fn(int) boolstring — result string
trim_funcpub fn trim_func(s &string, f fn(int) bool) stringTrim bytes on both ends using the callback.
s &stringf fn(int) boolstring — result string
to_valid_utf8pub fn to_valid_utf8(s &string, replacement string) stringReplace invalid UTF-8 sequences with replacement.
s &stringreplacement stringstring — result string
repeatpub fn repeat(s &string, n int) stringRepeat the content n times; n<=0 yields empty.
s &stringn intstring — result string
equal_foldpub fn equal_fold(a &string, b &string) boolASCII case-insensitive equality.
a &stringb &stringbool — true or false
to_lowerpub fn to_lower(s &string) stringMap ASCII letters to lowercase.
s &stringstring — result string
to_upperpub fn to_upper(s &string) stringMap ASCII letters to uppercase.
s &stringstring — result string
(&mut Buffer) growpub fn (b &mut Buffer) grow(n int)Method on `&mut Buffer`: ensure room for at least n more bytes.
b &mut Buffern int(&mut Buffer) write_stringpub fn (b &mut Buffer) write_string(s &string) intMethod on `&mut Buffer`: write a string and return the byte count.
b &mut Buffers &stringint — bytes written
(&mut Buffer) write_runepub fn (b &mut Buffer) write_rune(r int) intMethod on `&mut Buffer`: write a rune as UTF-8. Throws on failure.
b &mut Bufferr intint — bytes written
(&mut Buffer) read_bytepub fn (b &mut Buffer) read_byte() intMethod on `&mut Buffer`: read one byte; throws on failure. Throws on failure.
b &mut Bufferint — a value of this type
(&mut Buffer) unread_bytepub fn (b &mut Buffer) unread_byte() intMethod on `&mut Buffer`: unread the last byte. Throws on failure.
b &mut Bufferint — a value of this type
(&mut Buffer) read_runepub fn (b &mut Buffer) read_rune() RuneReadMethod on `&mut Buffer`: read one UTF-8 rune. Throws on failure.
b &mut BufferRuneRead — a value of this type
(&mut Buffer) unread_runepub fn (b &mut Buffer) unread_rune() intMethod on `&mut Buffer`: unread the last rune. Throws on failure.
b &mut Bufferint — a value of this type
(&Buffer) cappub fn (b &Buffer) cap() intMethod on `&Buffer`: return the capacity.
b &Bufferint — a value of this type
(&mut Buffer) nextpub fn (b &mut Buffer) next(n int) stringMethod on `&mut Buffer`: take the next item, or end according to this type.
b &mut Buffern intstring — result string
struct Cutpub struct Cut {
pub before string
pub after string
pub found bool
}Public struct `Cut`.
before stringafter stringfound boolcutpub fn cut(s &string, sep string) CutCut into before/after at the first sep.
s &stringsep stringCut — a value of this type
cut_prefixpub fn cut_prefix(s &string, pre string) CutCut off a prefix when present.
s &stringpre stringCut — a value of this type
cut_suffixpub fn cut_suffix(s &string, suf string) CutCut off a suffix when present.
s &stringsuf stringCut — a value of this type
(&mut Buffer) read_bytespub fn (b &mut Buffer) read_bytes(delim int) stringMethod on `&mut Buffer`: read through delim (inclusive).
b &mut Bufferdelim intstring — result string
(&mut Reader) read_resultpub fn (r &mut Reader) read_result(n int) io.ReadResultMethod on `&mut Reader`: read result.
r &mut Readern intio.ReadResult — a value of this type
(&mut Buffer) read_resultpub fn (b &mut Buffer) read_result(n int) io.ReadResultMethod on `&mut Buffer`: read result.
b &mut Buffern intio.ReadResult — a value of this type
(&mut Buffer) write_resultpub fn (b &mut Buffer) write_result(data string) io.WriteResultMethod on `&mut Buffer`: write result.
b &mut Bufferdata stringio.WriteResult — a value of this type
struct Readerpub struct Reader {
}`bytes.NewReader` subset. Same shape as `#strings` Reader: owning string payload (no shared []byte). read_n is empty at EOF; read_byte read_rune throw "EOF". seek whence 0/1/2.
none
struct RuneReadpub struct RuneRead {
pub ch int
pub size int
}Public struct `RuneRead`.
ch intsize intnew_readerpub fn new_reader(s string) ReaderConstruct reader.
s stringReader — a value of this type
(&Reader) sizepub fn (r &Reader) size() intMethod on `&Reader`: return the size.
r &Readerint — a value of this type
(&Reader) lengthpub fn (r &Reader) length() intMethod on `&Reader`: return the current length.
r &Readerint — a value of this type
(&mut Reader) resetpub fn (r &mut Reader) reset(s string)Method on `&mut Reader`: clear internal state so the value can be reused.
r &mut Readers string(&mut Reader) read_npub fn (r &mut Reader) read_n(n int) stringMethod on `&mut Reader`: read at most n bytes; may return shorter or empty at end.
r &mut Readern intstring — result string
(&mut Reader) read_bytepub fn (r &mut Reader) read_byte() intMethod on `&mut Reader`: read one byte; throws on failure. Throws on failure.
r &mut Readerint — a value of this type
(&mut Reader) unread_bytepub fn (r &mut Reader) unread_byte() intMethod on `&mut Reader`: unread the last byte. Throws on failure.
r &mut Readerint — a value of this type
(&mut Reader) read_runepub fn (r &mut Reader) read_rune() RuneReadMethod on `&mut Reader`: read one UTF-8 rune. Throws on failure.
r &mut ReaderRuneRead — a value of this type
(&mut Reader) unread_runepub fn (r &mut Reader) unread_rune() intMethod on `&mut Reader`: unread the last rune. Throws on failure.
r &mut Readerint — a value of this type
(&mut Reader) seekpub fn (r &mut Reader) seek(offset int, whence int) intMethod on `&mut Reader`: move the read position. whence 0/1/2 = absolute / relative / from end. Throws on failure.
r &mut Readeroffset intwhence intint — a value of this type
(&mut Reader) read_atpub fn (r &mut Reader) read_at(n int, off int) stringMethod on `&mut Reader`: read at most n bytes starting at offset off. Throws on failure.
r &mut Readern intoff intstring — result string