tur/string-slice

(StringSlice)

(string/slice [s :String off :int len :int] :StringSlice)

a zero-copy view of String s over bytes [off, off+len).

(slice/to-cstr (string/slice (string/from-cstr "hello world") 6 5))  ; => "world"

Since: v2

(string/slice-cstr [s :cstr off :int len :int] :StringSlice)

slice a raw cstr safely by copying it into an owned

Since: v2

(slice/retain [sl :StringSlice] :StringSlice)

increment the slice's refcount, returning a second handle.

Since: v2

(slice/release [sl :StringSlice] :void)

decrement the slice's refcount; at zero, release the parent.

Since: v2

(slice/len [sl :StringSlice] :int)

byte length of the slice.

Since: v2

(slice/empty? [sl :StringSlice] :bool)

true iff the slice has length zero.

Since: v2

(slice/byte-at [sl :StringSlice i :int] :int)

the byte (0..255) at index i, or -1 if out of range.

Since: v2

(slice/compare [a :StringSlice b :StringSlice] :int)

lexicographic byte compare of two slices: -1, 0, or 1.

Since: v2

(slice/eq? [a :StringSlice b :StringSlice] :bool)

content equality of two slices.

Since: v2

(slice/hash [sl :StringSlice] :int)

content hash over the slice's byte range.

Since: v2

(slice/sub [sl :StringSlice off :int len :int] :StringSlice)

a sub-view [off, off+len) RELATIVE to this slice (clamped).

(let [w (string/slice (string/from-cstr "hello world") 6 5)]  ; "world"
    (slice/to-cstr (slice/sub w 0 3)))                          ; => "wor"

Since: v2

(slice/to-string [sl :StringSlice] :String)

copy the slice's range into a fresh owned String.

Since: v2

(slice/to-cstr [sl :StringSlice] :cstr)

copy the slice's range into a fresh NUL-terminated cstr.

Since: v2

(definstance Eq [StringSlice])

content equality (no allocation).

(definstance Ord [StringSlice])

lexicographic byte ordering.

(definstance Show [StringSlice])

the slice content as a fresh owned String.

(definstance Hash [StringSlice])

content hash over the byte range.