#ifndef STRING_H
#define STRING_H


/*!
 * \file
 *
 * \brief UpnpString object declararion.
 *
 * This class implements string operations in the UPnP library.
 *
 * \author Marcelo Roberto Jimenez
 *
 * \version 1.0
 *
 * \defgroup UpnpString The UpnpString Class
 *
 * @{
 */


#include "UpnpGlobal.h" /* for EXPORT_SPEC */


#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */


/*!
 * \brief Type of the string objects inside libupnp.
 */
typedef struct s_UpnpString UpnpString;


/*!
 * \brief Constructor.
 *
 * \return A pointer to a new allocated object.
 */
EXPORT_SPEC UpnpString *UpnpString_new();


/*!
 * \brief Destructor.
 */
EXPORT_SPEC void UpnpString_delete(
	/*! \em \b this pointer. */
	UpnpString *p);


/*!
 * \brief Copy Constructor.
 *
 * \return A pointer to a new allocated copy of the original object.
 */
EXPORT_SPEC UpnpString *UpnpString_dup(
	/*! \em \b this pointer. */
	const UpnpString *p);


/*!
 * \brief Assignment operator.
 */
EXPORT_SPEC void UpnpString_assign(
	/*! \em \b this pointer. */
	UpnpString *p,
	/*! Pointer to the right hand side object. */
	const UpnpString *q);


/*!
 * \brief Returns the length of the string.
 *
 * \return The length of the string.
 * */
EXPORT_SPEC int UpnpString_get_Length(
	/*! \em \b this pointer. */
	const UpnpString *p);


/*!
 * \brief Returns the pointer to char.
 *
 * \return The pointer to char.
 */
EXPORT_SPEC const char *UpnpString_get_String(
	/*! \em \b this pointer. */
	const UpnpString *p);


/*!
 * \brief Sets the string from a pointer to char.
 */
EXPORT_SPEC void UpnpString_set_String(
	/*! \em \b this pointer. */
	UpnpString *p,
	/*! (char *) to copy from. */
	const char *s);


/*!
 * \brief Sets the string from a pointer to char using a maximum of N chars.
 */
EXPORT_SPEC void UpnpString_set_StringN(
	/*! \em \b this pointer. */
	UpnpString *p,
	/*! (char *) to copy from. */
	const char *s,
	/*! Maximum number of chars to copy.*/
	int n);


/*!
 * \brief Clears the string, sets its size to zero.
 */
EXPORT_SPEC void UpnpString_clear(
	/*! \em \b this pointer. */
	UpnpString *p);


#ifdef __cplusplus
}
#endif /* __cplusplus */


/* @} UpnpString The UpnpString API */


#endif /* STRING_H */