tur/httpd-string

stdlib/httpd-string.tur

optional owned-String accessors for stdlib/httpd.

Since: v2 (string-owned-builders-and-optional-accessors-plan, Part 2)

defn

httpd-req-cookie-raw

(httpd-req-cookie-raw [conn ptr<void> name : cstr] :)

internal: cookie value as a fresh cstr, or NULL.

defn

(httpd-req-cookie-opt [conn ptr<void> name : cstr] :)

read a cookie value as an optional owned String.

Parameters

conn		connection handle from the worker
name		cookie name to look up (case-sensitive, per RFC 6265)

Returns

(Option String) -- some owned value on a match, none on any miss.

Example

(let [o (httpd-req-cookie-opt c "session")]
    (if (some? o) (string/to-cstr (unwrap o)) "<no session>"))

Since: v2

defn

(httpd-req-form-raw [conn ptr<void> field : cstr] :)

internal: decoded form value as a fresh cstr, or NULL.

defn

(httpd-req-form-opt [conn ptr<void> field : cstr] :)

look up a URL-encoded form field as an optional String.

Parameters

conn		connection handle from the worker
field		form field name (case-sensitive, plain ASCII)

Returns

(Option String) -- some decoded owned value on a match, none on any miss.

Example

(let [o (httpd-req-form-opt c "username")]
    (if (some? o) (string/to-cstr (unwrap o)) "<anonymous>"))

Since: v2

defn

(cstr-null? [s : cstr] :)

internal: true iff the cstr pointer is NULL (a miss sentinel).