Man page - nng_url_parse(3)
Packages contains this manual
- nng_inproc(7)
- nng_msg_header(3)
- nng_push_open(3)
- nng_ipc_options(5)
- nng_bus_open(3)
- nng_tls_options(5)
- nng_aio_result(3)
- nng_pipe_socket(3)
- nng_msg(5)
- nng_stat_child(3)
- nng_pipe_get(3)
- nng_dialer_close(3)
- nng_tcp_register(3)
- nng_url_clone(3)
- nng_msg_free(3)
- nng_dialer_set(3)
- nng_sockaddr_zt(5)
- nng_pull(7)
- nng_stat_unit(3)
- nng_wss_register(3)
- nng_socket_proto_id(3)
- nng_ws_register(3)
- nng_pull_open(3)
- nng_stat_type(3)
- nng_stat_next(3)
- nng_listener_close(3)
- nng_setopt(3)
- nng_msg_insert(3)
- nng_aio_cancel(3)
- nng_listener_set(3)
- nng_msg_realloc(3)
- nng_log(3)
- nng_duration(5)
- nng_options(5)
- nng_strfree(3)
- nng_device(3)
- nng_msg_header_insert(3)
- nng_stat_find_listener(3)
- nng_stat_bool(3)
- nng_aio_set_timeout(3)
- nng_iov(5)
- nng_listener_setopt(3)
- nng_pipe_dialer(3)
- nng_msg_append(3)
- nng_aio_finish(3)
- nng_ws(7)
- nng_stream_listener(5)
- nng_aio_set_output(3)
- nng_ctx_get(3)
- nng_stat_find(3)
- nng_dialer_create(3)
- nng_dialer_getopt(3)
- nng_msg_header_len(3)
- nng_sendmsg(3)
- nng_listener_start(3)
- nng_socket(5)
- nng_str_sockaddr(3)
- nng_dialer_id(3)
- nng_msg_alloc(3)
- nng_recv_aio(3)
- nng_stats_free(3)
- nng_listener_getopt(3)
- nng_recvmsg(3)
- nng_ctx_getopt(3)
- nng_ctx_close(3)
- nng_alloc(3)
- nng_stat_string(3)
- nng(7)
- nng_listener_id(3)
- nng_msg_get_pipe(3)
- nng_aio_get_output(3)
- nng_pipe_getopt(3)
- nng_tcp(7)
- nng_pipe_notify(3)
- libnng(3)
- nng_stats_get(3)
- nng_surveyor_open(3)
- nng_aio_defer(3)
- nng_aio_count(3)
- nng_msg_chop(3)
- nng_sockaddr_abstract(5)
- nng_pipe_id(3)
- nng_msg_header_trim(3)
- nng_stream_dialer(5)
- nng_url_parse(3)
- nng_send(3)
- nng_tls_config(5)
- nng_strerror(3)
- nng_req(7)
- nng_dialer_setopt(3)
- nng_ctx(5)
- nng_respondent(7)
- nng_aio_begin(3)
- nng_dialer_get(3)
- nng_pipe_close(3)
- nng_aio_wait(3)
- nng_tcp_options(5)
- nng_ctx_id(3)
- nng_version(3)
- nng_dial(3)
- nng_stat_timestamp(3)
- nng_ipc_register(3)
- nng_stat_find_socket(3)
- nng_aio_set_iov(3)
- nng_rep(7)
- nng_msg_header_chop(3)
- nng_stat_find_dialer(3)
- nng_listener_get(3)
- nng_url(5)
- nng_zt_register(3)
- nng_zerotier(7)
- nng_req_open(3)
- nng_log_set_facility(3)
- nng_sub(7)
- nng_inproc_register(3)
- nng_listener_create(3)
- nng_aio_set_input(3)
- nng_stat_value(3)
- nng_aio_alloc(3)
- nng_ctx_open(3)
- nng_msg_len(3)
- nng_sockaddr_in(5)
- nng_ipc(7)
- nng_aio_get_input(3)
- nng_tls(7)
- nng_socket_raw(3)
- nng_sockaddr_inproc(5)
- nng_dialer_start(3)
- nng_surveyor(7)
- nng_close(3)
- nng_pub_open(3)
- nng_stream(5)
- nng_msg_set_pipe(3)
- nng_aio(5)
- nng_aio_stop(3)
- nng_pipe(5)
- nng_aio_free(3)
- nng_free(3)
- nng_sockaddr_ipc(5)
- nng_log_set_logger(3)
- nng_url_free(3)
- nng_listen(3)
- nng_aio_set_msg(3)
- nng_respondent_open(3)
- nng_rep_open(3)
- nng_getopt(3)
- nng_msg_body(3)
- nng_listener(5)
- nng_log_set_level(3)
- nng_pipe_listener(3)
- nng_aio_get_msg(3)
- nng_push(7)
- nng_socket_get(3)
- nng_ctx_set(3)
- nng_sub_open(3)
- nng_ctx_setopt(3)
- nng_socket(7)
- nng_stat(5)
- nng_tls_register(3)
- nng_sockaddr_in6(5)
- nng_aio_abort(3)
- nng_msg_dup(3)
- nng_socket_set(3)
- nng_send_aio(3)
- nng_recv(3)
- nng_pair(7)
- nng_sockaddr(5)
- nng_ctx_recv(3)
- nng_pair_open(3)
- nng_msg_clear(3)
- nng_sleep_aio(3)
- nng_stat_desc(3)
- nng_dialer(5)
- nng_strdup(3)
- nng_ctx_send(3)
- nng_msg_header_append(3)
- nng_msg_header_clear(3)
- nng_socket_proto_name(3)
- nng_socket_id(3)
- nng_log_get_level(3)
- nng_tls_engine(5)
- nng_pub(7)
- nng_stat_name(3)
- nng_msg_trim(3)
- nng_bus(7)
apt-get install libnng-dev
Manual
NNG_URL_PARSE
NAMESYNOPSIS
DESCRIPTION
URL Canonicalization
RETURN VALUES
ERRORS
SEE ALSO
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)