Introduce accessors for nng_url struct and make it opaque.

This provides safety by ensuring that applications do not
depend on the size or layout of nng_url itself.

1 files changed, 15 insertions, 0 deletions

diff --git a/src/core/url.h b/src/core/url.h
index 2eb3ed46..f8a141ac 100644
--- a/src/core/url.h
+++ b/src/core/url.h
@@ -13,6 +13,21 @@
 
 #include "core/defs.h"
 
+struct nng_url {
+	char       *u_rawurl;   // never NULL
+	const char *u_scheme;   // never NULL
+	const char *u_userinfo; // will be NULL if not specified
+	char       *u_hostname; // name only, will be "" if not specified
+	uint16_t    u_port;  // port, may be zero for schemes that do not use
+	char       *u_path;  // path, will be "" if not specified
+	char       *u_query; // without '?', will be NULL if not specified
+	char       *u_fragment; // without '#', will be NULL if not specified
+	// these members are private
+	char  *u_buffer;
+	size_t u_bufsz;
+	char   u_static[NNG_MAXADDRLEN]; // Most URLs fit within this
+};
+
 extern uint16_t nni_url_default_port(const char *);
 extern int      nni_url_asprintf(char **, const nng_url *);
 extern int      nni_url_asprintf_port(char **, const nng_url *, int);