Man page - nng_url_parse(3)
Packages contas this manual
- nng_respondent_open(3)
- nng_listener_start(3)
- nng_log(3)
- nng_msg_header_trim(3)
- nng_stats_get(3)
- nng_listener_id(3)
- nng_msg_chop(3)
- nng_ctx_close(3)
- nng_msg_header_insert(3)
- nng_sockaddr(5)
- nng_pipe_id(3)
- nng_pipe_close(3)
- nng_stat_desc(3)
- libnng(3)
- nng_aio_set_msg(3)
- nng_pub(7)
- nng_listener_set(3)
- nng_recv_aio(3)
- nng_socket_raw(3)
- nng_ipc_register(3)
- nng_aio_alloc(3)
- nng_sendmsg(3)
- nng_ctx_getopt(3)
- nng_sockaddr_abstract(5)
- nng_stat_timestamp(3)
- nng_free(3)
- nng_ctx_open(3)
- nng_send(3)
- nng_stat_string(3)
- nng_stream(5)
- nng_socket_id(3)
- nng_socket_set(3)
- nng_stats_free(3)
- nng_dialer(5)
- nng_stat_next(3)
- nng_msg_set_pipe(3)
- nng_ctx_set(3)
- nng_sockaddr_ipc(5)
- nng_options(5)
- nng_dialer_create(3)
- nng_url_parse(3)
- nng_listener_setopt(3)
- nng_aio_get_output(3)
- nng_req_open(3)
- nng_iov(5)
- nng_dialer_get(3)
- nng_zt_register(3)
- nng_ctx_setopt(3)
- nng_listener_getopt(3)
- nng_stat_bool(3)
- nng_push(7)
- nng_stream_dialer(5)
- nng_aio_get_input(3)
- nng_msg_alloc(3)
- nng_close(3)
- nng_req(7)
- nng_aio_cancel(3)
- nng_tls(7)
- nng_url_free(3)
- nng_pipe_listener(3)
- nng_respondent(7)
- nng_sockaddr_in(5)
- nng_pair(7)
- nng_pipe_getopt(3)
- nng_aio_stop(3)
- nng_aio_free(3)
- nng_pipe_get(3)
- nng_aio_result(3)
- nng(7)
- nng_msg_insert(3)
- nng_ws(7)
- nng_sub_open(3)
- nng_listener_create(3)
- nng_socket_proto_id(3)
- nng_stat_find_listener(3)
- nng_zerotier(7)
- nng_msg_header_chop(3)
- nng_stat_find(3)
- nng_stat_name(3)
- nng_msg_free(3)
- nng_aio(5)
- nng_str_sockaddr(3)
- nng_sub(7)
- nng_msg_header_append(3)
- nng_log_set_facility(3)
- nng_pipe_socket(3)
- nng_sockaddr_in6(5)
- nng_stat_find_socket(3)
- nng_dialer_id(3)
- nng_tcp_register(3)
- nng_tls_engine(5)
- nng_device(3)
- nng_url(5)
- nng_msg_clear(3)
- nng_log_set_level(3)
- nng_stream_listener(5)
- nng_setopt(3)
- nng_tls_config(5)
- nng_tcp_options(5)
- nng_msg_header_len(3)
- nng_recvmsg(3)
- nng_dialer_close(3)
- nng_msg_dup(3)
- nng_pipe_dialer(3)
- nng_listener_close(3)
- nng_aio_set_input(3)
- nng_listen(3)
- nng_tcp(7)
- nng_msg_len(3)
- nng_listener(5)
- nng_dialer_getopt(3)
- nng_ctx(5)
- nng_version(3)
- nng_ws_register(3)
- nng_tls_options(5)
- nng_stat_type(3)
- nng_msg_body(3)
- nng_alloc(3)
- nng_msg_append(3)
- nng_ctx_recv(3)
- nng_tls_register(3)
- nng_sockaddr_inproc(5)
- nng_socket(5)
- nng_socket(7)
- nng_ctx_get(3)
- nng_wss_register(3)
- nng_stat_unit(3)
- nng_inproc(7)
- nng_sockaddr_zt(5)
- nng_msg(5)
- nng_strfree(3)
- nng_aio_finish(3)
- nng_pull_open(3)
- nng_aio_defer(3)
- nng_stat(5)
- nng_sleep_aio(3)
- nng_aio_set_iov(3)
- nng_inproc_register(3)
- nng_aio_abort(3)
- nng_msg_realloc(3)
- nng_strdup(3)
- nng_dialer_setopt(3)
- nng_aio_begin(3)
- nng_msg_get_pipe(3)
- nng_rep(7)
- nng_ctx_id(3)
- nng_getopt(3)
- nng_pipe(5)
- nng_pipe_notify(3)
- nng_strerror(3)
- nng_pair_open(3)
- nng_rep_open(3)
- nng_msg_header(3)
- nng_msg_trim(3)
- nng_aio_get_msg(3)
- nng_log_get_level(3)
- nng_dialer_set(3)
- nng_msg_header_clear(3)
- nng_log_set_logger(3)
- nng_listener_get(3)
- nng_aio_set_timeout(3)
- nng_aio_count(3)
- nng_socket_get(3)
- nng_send_aio(3)
- nng_pub_open(3)
- nng_surveyor_open(3)
- nng_recv(3)
- nng_pull(7)
- nng_dial(3)
- nng_push_open(3)
- nng_dialer_start(3)
- nng_stat_value(3)
- nng_bus(7)
- nng_stat_child(3)
- nng_ctx_send(3)
- nng_stat_find_dialer(3)
- nng_url_clone(3)
- nng_aio_set_output(3)
- nng_ipc(7)
- nng_socket_proto_name(3)
- nng_bus_open(3)
- nng_aio_wait(3)
- nng_duration(5)
- nng_surveyor(7)
- nng_ipc_options(5)
Package: libnng-dev
apt-get install libnng-dev
apt-get install libnng-dev
Manuals in package:
Documentations in package:
Manual
| NNG_URL_PARSE(3) | NNG Reference Manual | NNG_URL_PARSE(3) |
NAME
nng_url_parse - create URL structure from a string
SYNOPSIS
#include <nng/nng.h> int nng_url_parse(nng_url **urlp, const char *str);
DESCRIPTION
The nng_url_parse() function parses the string str containing an RFC 3986 <https://tools.ietf.org/html/rfc3986> compliant URL, and creates an nng_url structure containing the results. A pointer to the resulting structure is stored in urlp.
The structure may disposed of when no longer needed by calling nng_url_free().
URL Canonicalization
The nng_url_parse() function also canonicalizes the results, as follows:
1.The URL is parsed into the various components.
2.The u_scheme,
u_hostname, u_host, and
u_port members are converted to lower case.
3.Percent-encoded values for unreserved
characters <https://tools.ietf.org/html/rfc3986#section-2.3>
converted to their unencoded forms.
4.Additionally URL percent-encoded values for characters
in the path and with numeric values larger than 127 (i.e. not ASCII) are
decoded.
5.The resulting u_path is
checked for invalid UTF-8 sequences, consisting of surrogate pairs, illegal
byte sequences, or overlong encodings. If this check fails, then the entire
URL is considered invalid, and the function returns
NNG_EINVAL.
6.Path segments consisting of .
and .. are resolved as per RFC 3986 6.2.2.3
<https://tools.ietf.org/html/rfc3986#section-6.2.2.3>.
7.Further, empty path segments are removed, meaning that
duplicate slash (/) separators are removed from the
path.
8.If a port was not specified, but the scheme defines a
default port, then u_port will be filled in with the
value of the default port.
Tip
Only the u_userinfo,
u_query, and u_fragment
members will ever be
NULL. The other members will be filled in with either
default values or the empty string if they cannot be determined from
str.
RETURN VALUES
This function returns 0 on success, and non-zero otherwise.
ERRORS
NNG_ENOMEM
Insufficient free memory exists to allocate a
message.
NNG_EINVAL
An invalid URL was supplied.
SEE ALSO
nng_url_clone(3), nng_url_free(3), nng_strerror(3), nng_url(5), nng(7)
| 2025-04-20 |