Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

xo_parse_args(3) [freebsd man page]

LIBXO(3)						   BSD Library Functions Manual 						  LIBXO(3)

NAME
xo_parse_args -- detect, parse, and remove arguments for libxo LIBRARY
library ``libxo'' SYNOPSIS
#include <libxo/xo.h> int xo_parse_args(int argc, char **argv); int xo_set_program(const char *name); DESCRIPTION
The xo_parse_args() function is used to process command-line arguments. libxo specific options are processed and removed from the argument list so the calling application does not need to process them. If successful, a new value for argc is returned. On failure, a message it emitted and -1 is returned. argc = xo_parse_args(argc, argv); if (argc < 0) exit(1); Following the call to xo_parse_args(), the application can process the remaining arguments in a normal manner. libxo uses command line options to trigger rendering behavior. The following options are recognised: --libxo <options> --libxo=<options> --libxo:<brief-options> Options is a comma-separated list of tokens that correspond to output styles, flags, or features: Token Action dtrt Enable "Do The Right Thing" mode html Emit HTML output indent=xx Set the indentation level info Add info attributes (HTML) json Emit JSON output keys Emit the key attribute for keys (XML) no-locale Do not initialize the locale setting no-top Do not emit a top set of braces (JSON) not-first Pretend the 1st output item was not 1st (JSON) pretty Emit pretty-printed output text Emit TEXT output units Add the 'units' (XML) or 'data-units (HTML) attribute warn Emit warnings when libxo detects bad calls warn-xml Emit warnings in XML xml Emit XML output xpath Add XPath expressions (HTML) The ``brief-options'' are single letter commands, designed for those with too little patience to use real tokens. No comma separator is used. Token Action H Enable HTML output (XO_STYLE_HTML) I Enable info output (XOF_INFO) i<num> Indent by <number> J Enable JSON output (XO_STYLE_JSON) P Enable pretty-printed output (XOF_PRETTY) T Enable text output (XO_STYLE_TEXT) W Enable warnings (XOF_WARN) X Enable XML output (XO_STYLE_XML) x Enable XPath data (XOF_XPATH) The xo_set_program() function sets name of the program as reported by functions like xo_failure(), xo_warn(), xo_err(), etc. The program name is initialized by xo_parse_args(), but subsequent calls to xo_set_program() can override this value. Note that the value is not copied, so the memory passed to xo_set_program() (and xo_parse_args()) must be maintained by the caller. ADDITIONAL DOCUMENTATION
Complete documentation can be found on github: http://juniper.github.io/libxo/libxo-manual.html libxo lives on github as: https://github.com/Juniper/libxo The latest release of libxo is available at: https://github.com/Juniper/libxo/releases SEE ALSO
xo_emit(3) HISTORY
The libxo library was added in FreeBSD 11.0. AUTHOR
Phil Shafer BSD
December 4, 2014 BSD

Check Out this Related Man Page

LIBXO(3)						   BSD Library Functions Manual 						  LIBXO(3)

NAME
xo_emit -- emit formatted output based on format string and arguments LIBRARY
library ``libxo'' SYNOPSIS
#include <libxo/xo.h> LIBXO(3) BSD Library Functions Manual LIBXO(3) NAME
xo_open_container xo_open_container_h xo_open_container_hd xo_open_container_d xo_close_container xo_close_container_h xo_close_container_hd xo_close_container_d -- open and close containers LIBRARY
library ``libxo'' SYNOPSIS
int xo_open_container(const char *name); int xo_open_container_h(xo_handle_t *handle, const char *name); int xo_open_container_hd(xo_handle_t *handle, const char *name); int xo_open_container_d(const char *name); int xo_close_container(const char *name); int xo_close_container_h(xo_handle_t *handle, const char *name); int xo_close_container_hd(xo_handle_t *handle); int xo_close_container_d(void); DESCRIPTION
libxo represents to types of hierarchy: ``containers'' and ``lists''. A container appears once under a given parent where a list contains instances that can appear multiple times. A container is used to hold related fields and to give the data organization and scope. The con- tainer has no value, but serves to contain other nodes. To open a container, call xo_open_container() or xo_open_container_h(). The former uses the default handle and the latter accepts a specific handle. To close a level, use the xo_close_container() or xo_close_container_h() functions. Each open call must have a matching close call. If the XOF_WARN flag is set and the name given does not match the name of the currently open container, a warning will be generated. Example: xo_open_container("top"); xo_open_container("system"); xo_emit("{:host-name/%s%s%s", hostname, domainname ? "." : "", domainname ?: ""); xo_close_container("system"); xo_close_container("top"); Sample Output: Text: my-host.example.org XML: <top> <system> <host-name>my-host.example.org</host-name> </system> </top> JSON: "top" : { "system" : { "host-name": "my-host.example.org" } } HTML: <div class="data" data-tag="host-name">my-host.example.org</div> EMITTING HIERARCHY
To create a container, use the xo_open_container() and xo_close_container() set of functions. The handle parameter contains a handle such as returned by xo_create(3) or NULL to use the default handle. The name parameter gives the name of the container, encoded in UTF-8. Since ASCII is a proper subset of UTF-8, traditional C strings can be used directly. The close functions with the ``_d'' suffix are used in ``Do The Right Thing'' mode, where the name of the open containers, lists, and instances are maintained internally by libxo to allow the caller to avoid keeping track of the open container name. Use the XOF_WARN flag to generate a warning if the name given on the close does not match the current open container. For TEXT and HTML output, containers are not rendered into output text, though for HTML they are used when the XOF_XPATH flag is set. EXAMPLE: xo_open_container("system"); xo_emit("The host name is {:host-name}0, hn); xo_close_container("system"); XML: <system><host-name>foo</host-name></system> DTRT MODE
Some users may find tracking the names of open containers, lists, and instances inconvenient. libxo offers a ``Do The Right Thing'' mode, where libxo will track the names of open containers, lists, and instances so the close function can be called without a name. To enable DTRT mode, turn on the XOF_DTRT flag prior to making any other libxo output. xo_set_flags(NULL, XOF_DTRT); Each open and close function has a version with the suffix ``_d'', which will close the open container, list, or instance: xo_open_container("top"); ... xo_close_container_d(); Note that the XOF_WARN flag will also cause libxo to track open containers, lists, and instances. A warning is generated when the name given to the close function and the name recorded do not match. ADDITIONAL DOCUMENTATION
Complete documentation can be found on github: http://juniper.github.io/libxo/libxo-manual.html libxo lives on github as: https://github.com/Juniper/libxo The latest release of libxo is available at: https://github.com/Juniper/libxo/releases SEE ALSO
xo_emit(3) HISTORY
The libxo library was added in FreeBSD 11.0. AUTHOR
Phil Shafer BSD
December 4, 2014 BSD
Man Page