ne_buffer_concat(3) [opensolaris man page]

NE_BUFFER_APPEND(3)						neon API reference					       NE_BUFFER_APPEND(3)

NAME

       ne_buffer_append, ne_buffer_zappend, ne_buffer_concat - append data to a string buffer

SYNOPSIS

       #include <ne_string.h>

       void ne_buffer_append (ne_buffer *buf, const char *string, size_t len);

       void ne_buffer_zappend (ne_buffer *buf, const char *string);

       void ne_buffer_concat (ne_buffer *buf, const char *str, ...);

DESCRIPTION

       The  ne_buffer_append  and  ne_buffer_zappend  functions append a string to the end of a buffer; extending the buffer as necessary. The len
       passed to ne_buffer_append specifies the length of the string to append; there must be no NUL terminator in the	first  len  bytes  of  the
       string. ne_buffer_zappend must be passed a NUL-terminated string.

       The  ne_buffer_concat  function takes a variable-length argument list following str; each argument must be a char * pointer to a NUL-termi-
       nated string. A NULL pointer must be given as the last argument to mark the end of the list. The strings (including str)  are  appended	to
       the buffer in the order given. None of the strings passed to ne_buffer_concat are modified.

EXAMPLES

       The following code will output "Hello, world. And goodbye.".

       ne_buffer *buf = ne_buffer_create();
       ne_buffer_zappend(buf, "Hello");
       ne_buffer_concat(buf, ", world. ", "And ", "goodbye.", NULL);
       puts(buf->data);
       ne_buffer_destroy(buf);

SEE ALSO

       ne_buffer(3), ne_buffer_create(3), ne_buffer_destroy(3)

AUTHOR

       Joe Orton <neon@webdav.org>.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES

       Source for Neon is available on http://opensolaris.org.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES

       Source for Neon is available on http://opensolaris.org.

neon 0.25.5							  20 January 2006					       NE_BUFFER_APPEND(3)

NE_ADDR_RESOLVE(3)						neon API reference						NE_ADDR_RESOLVE(3)

NAME

       ne_addr_resolve, ne_addr_result, ne_addr_first, ne_addr_next, ne_addr_error, ne_addr_destroy - functions to resolve hostnames to addresses

SYNOPSIS

       #include <ne_socket.h>

       ne_sock_addr *ne_addr_resolve (const char *hostname, int flags);

       int ne_addr_result (const ne_sock_addr *addr);

       const ne_inet_addr *ne_addr_first (ne_sock_addr *addr);

       const ne_inet_addr *ne_addr_next (ne_sock_addr *addr);

       char *ne_addr_error (const ne_sock_addr *addr, char *buffer, size_t bufsiz);

       void ne_addr_destroy (ne_sock_addr *addr);

DESCRIPTION

       The  ne_addr_resolve function resolves the given hostname, returning an ne_sock_addr object representing the address (or addresses) associ-
       ated with the hostname. The flags parameter is currently unused, and must be passed as 0.

       The hostname passed to ne_addr_resolve can be a DNS hostname (e.g. "www.example.com") or an IPv4 dotted quad (e.g. "192.0.34.72");  or,	on
       systems which support IPv6, an IPv6 hex address, which may be enclosed in brackets, e.g. "[::1]".

       To  determine  whether  the hostname was successfully resolved, the ne_addr_result function is used, which returns non-zero if an error oc-
       curred. If an error did occur, the ne_addr_error function can be used, which will copy the error string into a given buffer (of	size  buf-
       siz).

       The  functions  ne_addr_first and ne_addr_next are used to retrieve the Internet addresses associated with an address object which has been
       successfully resolved. ne_addr_first returns the first address; ne_addr_next returns the next address after the most recent call to  ne_ad-
       dr_next	or  ne_addr_first,  or	NULL if there are no more addresses. The ne_inet_addr pointer returned by these functions can be passed to
       ne_sock_connect to connect a socket.

       After the address object has been used, it should be destroyed using ne_addr_destroy.

RETURN VALUE

       ne_addr_resolve returns a pointer to an address object, and never NULL. ne_addr_error returns the buffer parameter .

EXAMPLES

       The code below prints out the set of addresses associated with the hostname www.google.com.

       ne_sock_addr *addr;
       char buf[256];

       addr = ne_addr_resolve("www.google.com", 0);
       if (ne_addr_result(addr)) {
	   printf("Could not resolve www.google.com: %s
",
		  ne_addr_error(addr, buf, sizeof buf));
       } else {
	   const ne_inet_addr *ia;
	   printf("www.google.com:");
	   for (ia = ne_addr_first(addr); ia != NULL; ia = ne_addr_next(addr)) {
	       printf(" %s", ne_iaddr_print(ia, buf, sizeof buf));
	   }
	   putchar('
');
       }
       ne_addr_destroy(addr);

SEE ALSO

       ne_iaddr_print(3)

AUTHOR

       Joe Orton <neon@webdav.org>.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES

       Source for Neon is available on http://opensolaris.org.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +--------------------+-----------------+
       |  ATTRIBUTE TYPE    | ATTRIBUTE VALUE |
       +--------------------+-----------------+
       |Availability	    | SUNWneon	      |
       +--------------------+-----------------+
       |Interface Stability | Volatile	      |
       +--------------------+-----------------+
NOTES

       Source for Neon is available on http://opensolaris.org.

neon 0.25.5							  20 January 2006						NE_ADDR_RESOLVE(3)