Section 3: library functions
ne_buffer_destroy, ne_buffer_finish – destroy a buffer object Synopsis #include <ne_string.h> void ne_buffer_destroy(ne_buffer *buf); char *ne_buffer_finish(ne_buffer *buf); Description ne_buffer_destroy frees all memory associated with the buffer. ne_buffer_finish frees the buffer structure, but not the actual string stored in the buffer, which is returned and must be free()d by the caller. Any use of the buffer object…
ne_buffer_destroy, ne_buffer_finish – destroy a buffer object Synopsis #include <ne_string.h> void ne_buffer_destroy(ne_buffer *buf); char *ne_buffer_finish(ne_buffer *buf); Description ne_buffer_destroy frees all memory associated with the buffer. ne_buffer_finish frees the buffer structure, but not the actual string stored in the buffer, which is returned and must be free()d by the caller. Any use of the buffer object…
ne_buffer_create, ne_buffer_ncreate – create a string buffer Synopsis #include <ne_alloc.h> ne_buffer *ne_buffer_create(void); ne_buffer *ne_buffer_ncreate(size_t size); Description ne_buffer_create creates a new buffer object, with an implementation-defined initial size. ne_buffer_ncreate creates an ne_buffer where the minimum initial size is given in the size parameter. The buffer created will contain the empty string (""). Return Value Both functions…
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…
ne_buffer_clear, ne_buffer_grow, ne_buffer_altered – clear, grow, or mark as altered a string buffer Synopsis #include <ne_string.h> void ne_buffer_clear(ne_buffer *buf); void ne_buffer_altered(ne_buffer *buf); void ne_buffer_grow(ne_buffer *buf, size_t size); Description The ne_buffer_clear function sets the string stored in buf to be the empty string (""). The ne_buffer_altered function must be used after the string stored in the…
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…
ne_buffer_clear, ne_buffer_grow, ne_buffer_altered – clear, grow, or mark as altered a string buffer Synopsis #include <ne_string.h> void ne_buffer_clear(ne_buffer *buf); void ne_buffer_altered(ne_buffer *buf); void ne_buffer_grow(ne_buffer *buf, size_t size); Description The ne_buffer_clear function sets the string stored in buf to be the empty string (""). The ne_buffer_altered function must be used after the string stored in the…
ne_buffer – string buffer handling Synopsis #include <ne_string.h> typedef struct { char *data; size_t used; size_t length; } ne_buffer; Description The ne_buffer type represents an expandable memory buffer for holding NUL-terminated strings. The data field points to the beginnning of the string, the length of which is given by the used field. The current size…
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_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_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_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_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_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_add_request_header, ne_print_request_header – add headers to a request Synopsis #include <ne_request.h> void ne_add_request_header(ne_request *request, const char *name, const char *value); void ne_print_request_header(ne_request *request, const char *name, const char *format, …); Description The functions ne_add_request_header and ne_print_request_header can be used to add headers to a request, before it is sent. ne_add_request_header simply adds a header of…
YIQRGB – Converts a color specification given in the YIQ color space to the equivalent color specification in the Red, Green, Blue (RGB) color space. Synopsis CALL YIQRGB (Y, I, Q, R, G, B) C-Binding Synopsis #include <ncarg/ncargC.h> void c_yiqrgb (float y, float i, float q, float *r, float *g, float *b) Description Y (REAL,…
WTSTR – draws a specified text string at a specified position in the user coordinate system. The call has arguments specifying the size, orientation, and centering of the string. Status WTSTR specifies character sizes in Plotter Address Units (PAUs), which are no longer used in NCAR Graphics; thus, WTSTR is considered an obsolete routine. The…
WMSTNM – plots station model data as per WMO guidelines. Synopsis CALL WMSTNM (X, Y, IMDAT) C-Binding Synopsis #include <ncarg/gks.h> void c_wmstnm(float x, float y, char *imdat) Description X (Real, Input) – An X coordinate (specified in world coordinates) of a point that specifies the position of the base of the wind barb shaft in…
WMSETR – Sets the value of an internal parameter of type REAL. Synopsis CALL WMSETR (PNAM,RVAL) C-Binding Synopsis #include <ncarg/ncargC.h> void c_wmsetr (char *pnam, real rval) Description PNAM (an input constant or variable of type CHARACTER) specifies the name of the parameter to be set. The name must appear as the first three characters of…
WMSETI – Sets the value of an internal parameter of type INTEGER. Synopsis CALL WMSETI (PNAM,IVAL) C-Binding Synopsis #include <ncarg/ncargC.h> void c_wmseti (char *pnam, int ival) Description PNAM (an input constant or variable of type CHARACTER) specifies the name of the parameter to be set. The name must appear as the first three characters of…