uce/site/doc/pages/request_query_path.txt
2026-06-16 12:21:31 +00:00

24 lines
829 B
Plaintext

:sig
String request_query_path(Request& context, String default_path = "index")
:see
>uri
request_query_route
request_context_params
route_path_sanitize
route_path_is_safe
parse_query
:content
Returns the first keyless query-string segment as a sanitized route path.
For a request such as `/?workspace/projects&theme=dark`, this returns `workspace/projects`.
When no keyless route is supplied, the result is `default_path`. When unsafe route input is supplied, the result is an empty string. Unsafe route input includes `.` or `..` segments, empty interior segments, backslashes, dots in filenames, or any character outside ASCII letters, digits, `_`, and `-`.
The runtime-populated `context.params["ROUTE_PATH"]` uses the same sanitizer.
:example
print(request_query_path(context, "index") != "" ? "path\n" : "empty\n");