Functions for handling conversations and conversation IDs. More...

Functions
CONVERSATION_ID_T *	conversation_id_create (struct session_s *session)
	Create and allocate a new conversation id for this session.

void	conversation_id_free (CONVERSATION_ID_T *conversation_id)
	Free memory allocated for a conversation id.

CONVERSATION_ID_T *	conversation_id_dup (const CONVERSATION_ID_T *src)
	Create a deep-copy duplicate of a conversation id.

char *	conversation_id_to_string (const CONVERSATION_ID_T conversation_id)
	Take a conversation id and convert it to string representation.

CONVERSATION_ID_T *	conversation_id_create_from_string (const char *str)
	Takes a string representation of a conversation id and creates a CONVERSATION_ID_T structure from it.

Detailed Description

Functions for handling conversations and conversation IDs.

Use is subject to licence terms.

NOTICE: All information contained herein is, and remains the property of DiffusionData. The intellectual and technical concepts contained herein are proprietary to DiffusionData and may be covered by U.S. and Foreign Patents, patents in process, and are protected by trade secret or copyright law.

Function Documentation

◆ conversation_id_create()

CONVERSATION_ID_T * conversation_id_create ( struct session_s * session )

Create and allocate a new conversation id for this session.

Parameters

session The session which this conversation is associated with.

Return values

CONVERSATION_ID_T *	A conversation ID.
NULL	If the conversation ID cannot be created.

◆ conversation_id_create_from_string()

CONVERSATION_ID_T * conversation_id_create_from_string ( const char * str )

Takes a string representation of a conversation id and creates a CONVERSATION_ID_T structure from it.

Parameters

str	The conversation id in string form.

Return values

OCNVERSATION_ID_T *	A conversation id.
NULL	If an error occurs.

◆ conversation_id_dup()

CONVERSATION_ID_T * conversation_id_dup ( const CONVERSATION_ID_T * src )

Create a deep-copy duplicate of a conversation id.

conversation_id_free should be called on the pointer when no longer needed.

Parameters

src	The conversation id to be copied.

Returns: A newly allocated conversation id, or NULL if an error occurred.

◆ conversation_id_free()

void conversation_id_free ( CONVERSATION_ID_T * conversation_id )

Free memory allocated for a conversation id.

Parameters

conversation_id The conversation id to be freed.

◆ conversation_id_to_string()

char * conversation_id_to_string ( const CONVERSATION_ID_T conversation_id )

Take a conversation id and convert it to string representation.

Parameters

conversation_id The conversation id to be converted.

Return values

char *	The conversation id as a string.
NULL	If an error occurs.