frame/ownstr

src/frame/ownstr.tur

owned String surface for the frame spice.

Since: FR-string (0.x)

defopaque

String

(String)

an owned, refcounted, immutable string (ABI: ptr<void>).

defn

(ownstr-autolink :)

internal: pull src/runtime/tur_string.c into the link.

defn

(adopt-cstr [s : cstr] :)

defn

(to-cstr [s : String] :)

borrow the String's NUL-terminated bytes (O(1), no copy).

Parameters

the String to borrow from

Returns

cstr -- a borrowed view of the same bytes.

Since: FR-string (0.x)

defn

(release [s : String] :)

decrement the refcount; free the payload at zero.

Parameters

the String whose owning handle is being dropped

Since: FR-string (0.x)

defn

(str-len [s : String] :)

byte length of the String (not counting the NUL).

Parameters

the String to measure

Returns

int -- the byte length.

Since: FR-string (0.x)

Internal definitions

__adopt-cstr-raw-- take ownership of a freshly heap-allocated cstr as a String.