view release on metacpan or  search on metacpan

libxwrite.h  view on Meta::CPAN

 * \param target The target of PI.
 * \param content The content of PI. (optional)
 */
void xwrite_write_PI(XWrite* this, const gchar* target, const gchar* content);

/**
 * \brief Declare a comment.
 *
 * \param this The context.
 * \param comment The comment in UTF-8.
 */
void xwrite_write_comment(XWrite* this, const gchar* comment);

/**
 * \brief Open an element.
 *
 * The element will be in incomplete state.
 *
 * \param this The context.
 * \param qname The name of element in UTF-8.
 */
void xwrite_start_element(XWrite* this, const gchar* qname);

/**
 * \brief Close an element.
 * 
 * \param this The context.
 * \param qname The name of element in UTF-8. Beware that it's your
 *              responsible to properly close the innermost element.
 */
void xwrite_end_element(XWrite* this, const gchar* qname);

/**
 * \brief Add an attribute to the innermost open element.
 *
 * This function must be called only while the open element is in
 * incomplete state.
 *
 * \param this The context.
 * \param qname The name of attribute in UTF-8.
 * \param value The value of attribute in UTF-8.
 */
void xwrite_add_attribute(XWrite* this, const gchar* qname, const gchar* value);

/**
 * \brief Add a text to the innermost open element.
 *
 * After the call of this function, the element will be in complete
 * state (i.e. you can't add attributes anymore).
 *
 * \param this The context.
 * \param str The text in UTF-8.
 * \see xwrite_add_base64()
 */
void xwrite_add_text(XWrite* this, const gchar* str);

/**
 * \brief Add an XML CDATA.
 *
 * \param this The context.
 * \param cdata The CDATA in UTF-8.
 */
void xwrite_add_CDATA(XWrite* this, const gchar* cdata);

/**
 * \brief Add a binary to the innermost open element with encoding in
 *        Base64.
 * 
 * \param this The context.
 * \param buf  The beginning address of region to be added.
 * \param len  The length of region.
 * \see xwrite_add_text()
 */
void xwrite_add_base64(XWrite* this, const gchar* buf, gsize len);

#endif