6.4 Immutable Bytestrings

An immutable bytestring is a bytes? value that is immutable, in the sense of immutable?. The rebellion/binary/immutable-bytes module provides functions and predicates that always accept and return immutable bytestrings.

procedure (immutable-subbytes bstr start [end]) → immutable-bytes?

bstr : immutable-bytes?

start : natural?

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes=? bstr1 bstr2 ...) → boolean?

bstr1 : immutable-bytes?

bstr2 : immutable-bytes?

procedure (immutable-bytes<? bstr1 bstr2 ...) → boolean?

bstr1 : immutable-bytes?

bstr2 : immutable-bytes?

procedure (immutable-bytes>? bstr1 bstr2 ...) → boolean?

bstr1 : immutable-bytes?

bstr2 : immutable-bytes?

procedure (immutable-bytes->string/utf-8   bstr             err-char            [ start             end])   →   immutable-string?

bstr : immutable-bytes?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes->string/locale   bstr             err-char            [ start             end])   →   immutable-string?

bstr : immutable-bytes?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes->string/latin-1   bstr             err-char            [ start             end])   →   immutable-string?

bstr : immutable-bytes?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-string->bytes/utf-8   str             err-byte            [ start]             end)   →   immutable-bytes?

str : immutable-string?

err-byte : (or/c byte? #f)

start : natural? = 0

end : (immutable-string-length str)

procedure (immutable-string->bytes/locale   str             err-byte            [ start]             end)   →   immutable-bytes?

str : immutable-string?

err-byte : (or/c byte? #f)

start : natural? = 0

end : (immutable-string-length str)

procedure (immutable-string->bytes/latin-1   str             err-byte            [ start]             end)   →   immutable-bytes?

str : immutable-string?

err-byte : (or/c byte? #f)

start : natural? = 0

end : (immutable-string-length str)

procedure (immutable-string-utf-8-length   str            [ start             end])   →   natural?

str : immutable-string?

start : natural? = 0

end : natural? = (immutable-string-length str)

procedure (immutable-bytes-utf-8-length   bstr             err-char            [ start             end])   →   (or/c natural? #f)

bstr : immutable-bytes?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes-utf-8-ref   bstr             pos             err-char            [ start             end])   →   (or/c char? #f)

bstr : immutable-bytes?

pos : natural?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes-utf-8-index   bstr             pos             err-char            [ start             end])   →   (or/c natural? #f)

bstr : immutable-bytes?

pos : natural?

err-char : (or/c char? #f)

start : natural? = 0

end : natural? = (immutable-bytes-length bstr)

procedure (immutable-bytes-convert   converter       source      [ start       end])

→   immutable-bytes? natural? (or/c 'complete 'continues 'aborts 'error)

converter : bytes-converter?

source : immutable-bytes?

start : natural? = 0

end : natural? = (immutable-bytes-length source)

procedure (immutable-bytes-convert-end converter) → immutable-bytes?

converter : bytes-converter?

procedure (immutable-bytes-append* bstr ... bstrs) → immutable-bytes?

bstr : immutable-bytes?

bstrs : (listof immutable-bytes?)

procedure (immutable-bytes-join bstrs sep) → immutable-bytes?

bstrs : (listof immutable-bytes?)

sep : immutable-bytes?