msg_mime_protos.h

Sofia SIP is an open-source SIP User-Agent library, compliant with the IETF RFC3261 specification.

 * @code 
 * 
 *  msg_content_id_t msg_content_id = MSG_CONTENT_ID_INIT;
 * 
 * @endcode
 * @HI
 */
#define MSG_CONTENT_ID_INIT() MSG_HDR_INIT(content_id)

/**Initialize an #msg_content_id_t structure.
 * 
 * An #msg_content_id_t structure can be initialized with the
 * msg_content_id_init() function/macro. For instance,
 * @code
 * 
 *  msg_content_id_t msg_content_id;
 * 
 *  msg_content_id_init(&msg_content_id);
 * 
 * @endcode
 * 
 * @param x pointer to #msg_content_id_t structure 
 */
#if SU_HAVE_INLINE
su_inline msg_content_id_t *msg_content_id_init(msg_content_id_t x[1])
{
  return MSG_HEADER_INIT(x, msg_content_id_class, sizeof(msg_content_id_t));
}
#else
#define msg_content_id_init(x) \
  MSG_HEADER_INIT(x, msg_content_id_class, sizeof(msg_content_id_t))
#endif

/**Test if header object is an instance of #msg_content_id_t.
 * 
 * The function msg_is_content_id() returns true (nonzero) if
 * the header class is an instance of Content-ID header
 * object and false (zero) otherwise.
 * 
 * @param header pointer to the header structure to be tested
 * 
 * @return The function msg_is_content_id() returns true (nonzero) if the
 * header object is an instance of header Content-ID header and false (zero)
 * otherwise.
 */
#if SU_HAVE_INLINE
su_inline int msg_is_content_id(msg_header_t const *header)
{
  return header && header->sh_class->hc_hash == msg_content_id_hash;
}
#else
int msg_is_content_id(msg_header_t const *header);
#endif

#define msg_content_id_p(h) msg_is_content_id((h))

/**Duplicate (deep copy) #msg_content_id_t.
 * 
 * The function msg_content_id_dup() duplicates a header structure @a
 * header. If the header structure @a header contains a reference
 * (@c header->x_next) to a list of headers, all the headers in the
 * list are duplicated, too.
 * 
 * @param home   memory home used to allocate new structure
 * @param header header structure to be duplicated
 * 
 * When duplicating, all parameter lists and non-constant strings
 * attached to the header are copied, too. The function uses given
 * memory @a home to allocate all the memory areas used to copy the
 * header.
 * 
 * @par Example
 * @code
 * 
 *   content_id = msg_content_id_dup(home, msg->msg_content_id);
 * 
 * @endcode
 * 
 * @return
 * The function msg_content_id_dup() returns a pointer to the
 * newly duplicated #msg_content_id_t header structure, or NULL
 * upon an error.
 */
#if SU_HAVE_INLINE
su_inline
#endif
msg_content_id_t *msg_content_id_dup(su_home_t *home, 
				 msg_content_id_t const *header);

#if SU_HAVE_INLINE
su_inline
msg_content_id_t *msg_content_id_dup(su_home_t *home, 
				 msg_content_id_t const *header)
{
  return (msg_content_id_t *)
    msg_header_dup_as(home, msg_content_id_class, (msg_header_t const *)header); 
}
#endif


/**Copy an #msg_content_id_t header structure.
 * 
 * The function msg_content_id_copy() copies a header structure @a
 * header. If the header structure @a header contains a reference
 * (@c header->h_next) to a list of headers, all the headers in that
 * list are copied, too. The function uses given memory @a home to
 * allocate all the memory areas used to copy the header structure
 * @a header.
 * 
 * @param home    memory home used to allocate new structure
 * @param header  pointer to the header structure to be duplicated
 * 
 * When copying, only the header structure and parameter lists
 * attached to it are duplicated. The new header structure retains
 * all the references to the strings within the old @a header,
 * including the encoding of the old header, if present.
 * 
 * @par Example
 * @code
 * 
 *   content_id = msg_content_id_copy(home, msg->msg_content_id);
 * 
 * @endcode
 * 
 * @return
 * The function msg_content_id_copy() returns a pointer to
 * newly copied header structure, or NULL upon an error.
 */
#if SU_HAVE_INLINE
su_inline
#endif
msg_content_id_t *msg_content_id_copy(su_home_t *home, 
				  msg_content_id_t const *header);

#if SU_HAVE_INLINE
su_inline
msg_content_id_t *msg_content_id_copy(su_home_t *home, 
				  msg_content_id_t const *header)
{
  return (msg_content_id_t *)
    msg_header_copy_as(home, msg_content_id_class, (msg_header_t const *)header); 
}
#endif


/**Make a header structure #msg_content_id_t.
 * 
 * The function msg_content_id_make() makes a new #msg_content_id_t header
 * structure. It allocates a new header structure, and decodes the string @a
 * s as the value of the structure.
 * 
 * @param home memory home used to allocate new header structure.
 * @param s    string to be decoded as value of the new header structure
 * 
 * @note This function may be implemented as a macro calling
 * msg_header_make().
 * 
 * @return
 * The function msg_content_id_make() returns a pointer to newly maked
 * #msg_content_id_t header structure, or NULL upon an error.
 */
#if SU_HAVE_INLINE
su_inline msg_content_id_t *msg_content_id_make(su_home_t *home, char const *s)
{
  return (msg_content_id_t*)msg_header_make(home, msg_content_id_class, s);
}
#else
msg_content_id_t *msg_content_id_make(su_home_t *home, char const *s);
#endif


/**Make a Content-ID header from formatting result.
 * 
 * The function msg_content_id_format() makes a new Content-ID header object
 * using snprintf-formatted result as its value. The function first
 * prints the arguments according to the format @a fmt specified. Then it
 * allocates a new header structure, and uses the formatting result as the
 * header value.
 * 
 * @param home   memory home used to allocate new header structure.
 * @param fmt    string used as a printf()-style format
 * @param ...    argument list for format
 * 
 * @note This function may be implemented as a macro calling
 * msg_header_format().
 * 
 * @return
 * The function msg_content_id_format() returns a pointer to newly
 * makes header structure, or NULL upon an error.
 * 
 * @HIDE
 */
#if SU_HAVE_INLINE
su_inline
#endif
msg_content_id_t *msg_content_id_format(su_home_t *home, char const *fmt, ...)
     __attribute__((__format__ (printf, 2, 3)));

#if SU_HAVE_INLINE
su_inline msg_content_id_t *msg_content_id_format(su_home_t *home, char const *fmt, ...)
{
  msg_header_t *h;
  va_list ap;
  
  va_start(ap, fmt);
  h = msg_header_vformat(home, msg_content_id_class, fmt, ap);
  va_end(ap);
 
  return (msg_content_id_t*)h;
}
#endif

/** @} */

/* Declare internal prototypes for Content-Language header */

/**@addtogroup msg_content_language 
 * @{ 
 */

enum { 
  /** Hash of Content-Language header. @internal */
  msg_content_language_hash = 62108 
};

/** Parse a Content-Language header. @internal */
MSG_DLL msg_parse_f msg_content_language_d;

/** Print a Content-Language header. @internal */
MSG_DLL msg_print_f msg_content_language_e;

MSG_DLL msg_xtra_f msg_content_language_dup_xtra;
MSG_DLL msg_dup_f msg_content_language_dup_one;

/**Header class for Content-Language header.
 * 
 * The header class msg_content_language_class defines how a 
 * Content-Language header header is parsed and printed.  It also
 * contains methods used by message parser and other functions
 * to manipulate the #msg_content_language_t header structure.
 * 
 */
#ifndef msg_content_language_class
MSG_DLL extern msg_hclass_t msg_content_language_class[];
#endif

/**Initializer for an #msg_content_language_t structure.
 * 
 * A static msg_content_language_t structure must be initialized
 * with the MSG_CONTENT_LANGUAGE_INIT() macro. For instance,
 * @code 
 * 
 *  msg_content_language_t msg_content_language = MSG_CONTENT_LANGUAGE_INIT;
 * 
 * @endcode
 * @HI
 */
#define MSG_CONTENT_LANGUAGE_INIT() MSG_HDR_INIT(content_language)

/**Initialize an #msg_content_language_t structure.
 * 
 * An #msg_content_language_t structure can be initialized with the
 * msg_content_language_init() function/macro. For instance,
 * @code
 * 
 *  msg_content_language_t msg_content_language;
 * 
 *  msg_content_language_init(&msg_content_language);
 * 
 * @endcode
 * 
 * @param x pointer to #msg_content_language_t structure 
 */
#if SU_HAVE_INLINE
su_inline msg_content_language_t *msg_content_language_init(msg_content_language_t x[1])
{
  return MSG_HEADER_INIT(x, msg_content_language_class, sizeof(msg_content_language_t));
}
#else
#define msg_content_language_init(x) \
  MSG_HEADER_INIT(x, msg_content_language_class, sizeof(msg_content_language_t))
#endif

/**Test if header object is an instance of #msg_content_language_t.
 * 
 * The function msg_is_content_language() returns true (nonzero) if
 * the header class is an instance of Content-Language header
 * object and false (zero) otherwise.
 * 
 * @param header pointer to the header structure to be tested
 * 
 * @return The function msg_is_content_language() returns true (nonzero) if the
 * header object is an instance of header Content-Language header and false (zero)
 * otherwise.
 */
#if SU_HAVE_INLINE
su_inline int msg_is_content_language(msg_header_t const *header)
{
  return header && header->sh_class->hc_hash == msg_content_language_hash;
}
#else
int msg_is_content_language(msg_header_t const *header);
#endif

#define msg_content_language_p(h) msg_is_content_language((h))

/**Duplicate (deep copy) #msg_content_language_t.
 * 
 * The function msg_content_language_dup() duplicates a header structure @a
 * header. If the header structure @a header contains a reference
 * (@c header->x_next) to a list of headers, all the headers in the
 * list are duplicated, too.
 * 
 * @param home   memory home used to allocate new structure
 * @param header header structure to be duplicated
 * 
 * When duplicating, all parameter lists and non-constant strings
 * attached to the header are copied, too. The function uses given
 * memory @a home to allocate all the memory areas used to copy the
 * header.
 * 
 * @par Example
 * @code
 * 
 *   content_language = msg_content_language_dup(home, msg->msg_content_language);
 * 
 * @endcode
 * 
 * @return
 * The function msg_content_language_dup() returns a pointer to the
 * newly duplicated #msg_content_language_t header structure, or NULL
 * upon an error.
 */
#if SU_HAVE_INLINE
su_inline
#endif
msg_content_language_t *msg_content_language_dup(su_home_t *home, 
				 msg_content_language_t const *header);

#if SU_HAVE_INLINE
su_inline
msg_content_language_t *msg_content_language_dup(su_home_t *home, 
				 msg_content_language_t const *header)
{
  return (msg_content_language_t *)
    msg_header_dup_as(home, msg_content_language_class, (msg_header_t const *)header); 
}
#endif


/**Copy an #msg_content_language_t header structure.
 * 
 * The function msg_content_language_copy() copies a header structure @a
 * header. If the header structure @a header contains a reference
 * (@c header->h_next) to a list of headers, all the headers in that
 * list are copied, too. The function uses given memory @a home to
 * allocate all the memory areas used to copy the header structure
 * @a header.
 * 
 * @param home    memory home used to allocate new structure
 * @param header  pointer to the header structure to be duplicated
 * 
 * When copying, only the header structure and parameter lists
 * attached to it are duplicated. The new header structure retains
 * all the references to the strings within the old @a header,
 * including the encoding of the old header, if present.
 * 
 * @par Example
 * @code
 * 
 *   content_language = msg_content_language_copy(home, msg->msg_content_language);
 * 
 * @endcode
 * 
 * @return
 * The function msg_content_language_copy() returns a pointer to
 * newly copied header structure, or NULL upon an error.
 */
#if SU_HAVE_INLINE
su_inline
#endif
msg_content_language_t *msg_content_language_copy(su_home_t *home, 
				  msg_content_language_t const *header);

#if SU_HAVE_INLINE
su_inline
msg_content_language_t *msg_content_language_copy(su_home_t *home, 
				  msg_content_language_t const *header)
{
  return (msg_content_language_t *)
    msg_header_copy_as(home, msg_content_language_class, (msg_header_t const *)header); 
}
#endif


/**Make a header structure #msg_content_language_t.
 * 
 * The function msg_content_language_make() makes a new #msg_content_language_t header
 * structure. It allocates a new header structure, and decodes the string @a
 * s as the value of the structure.
 * 
 * @param home memory home used to allocate new header structure.
 * @param s    string to be decoded as value of the new header structure
 * 
 * @note This function may be implemented as a macro calling
 * msg_header_make().
 * 
 * @return
 * The function msg_content_language_make() returns a pointer to newly maked
 * #msg_content_language_t header structure, or NULL upon an error.
 */
#if SU_HAVE_INLINE
su_inline msg_content_language_t *msg_content_language_make(su_home_t *home, char const *s)
{
  return (msg_content_language_t*)msg_header_make(home, msg_content_language_class, s);
}
#else
msg_content_language_t *msg_content_language_make(su_home_t *home, char const *s);
#endif


/**Make a Content-Language header from formatting result.