#ifndef EINA_ABSTRACT_CONTENT_H
#define EINA_ABSTRACT_CONTENT_H


/**
 * @typedef Eina_Content
 * Defines a abstract content segment
 *
 * Each Abstract content contains out of a Eina_Slice of memory. And a type.
 * The type are IANA meme types.
 *
 * @note if the type is a text-style type, the last byte of the slice must be \0
 *
 * @since 1.24
 */
typedef struct _Eina_Content Eina_Content;

/**
 * @typedef Eina_Content_Convertion_Callback
 *
 * Callback called when convertion from one type to another type is requested.
 * The from and to type is specified when the callback is registered.
 * The to type is also passed in the callback here.
 * The type of the from pointer does not need to be checked.
 */
typedef Eina_Content* (*Eina_Content_Conversion_Callback)(Eina_Content *from, const char *to_type);

/**
 * Get the path to a file, containing the slice memory as content.
 *
 * @param[in] content The content that will be in the file.
 *
 * @return The path to the file. Do not free this.
 *
 */
EAPI const char* eina_content_as_file(Eina_Content *content);

/**
 * Convert the content of the object to another type.
 *
 * In case the convertion cannot be performaned, NULL is returned.
 *
 * @param[in] content The content to convert.
 * @param[in] new_type The new type the returned content will have.
 *
 * @return A new content object. The caller of this function is owning this.
 */
EAPI Eina_Content* eina_content_convert(Eina_Content *content, const char *new_type);

/**
 * Get the type of the passed content.
 *
 * @param[in] content The content to fetch the type from.
 *
 * @return The type of this content. Do no free this.
 */
EAPI const char* eina_content_type_get(Eina_Content *content);

/**
 * Get the type of the passed content.
 *
 * @param[in] content The content to fetch the type from.
 *
 * @return The path to the file. Do not free this.
 */
EAPI const Eina_Slice eina_content_data_get(Eina_Content *content);

/**
 * Create a new content object, with the slice of data with a specific type.
 *
 * @param[in] data A slice of memory, the memory is duplicated.
 * @param[in] type The type of memory.
 *
 * @return The new content object. The caller owns this object.
 */
EAPI Eina_Content* eina_content_new(Eina_Slice data, const char *type);

/**
 * Free the content object.
 *
 * @param[in] content The content to free.
 */
EAPI void eina_content_free(Eina_Content *content);

/**
 * Register a new conversion callback.
 *
 * @param[in] from The tyoe you convert from.
 * @param[in] in The type you convert to.
 *
 * @return True on success false otherwise.
 */
EAPI Eina_Bool eina_content_converter_conversion_register(const char *from, const char *to, Eina_Content_Conversion_Callback convertion);

/**
 * Check if a specific convertion can be performanced.
 *
 * A convertion can only be performed if a callback is registered.
 *
 * @param[in] from The type you convert from.
 * @param[in] in The type you convert to.
 *
 * @return True if it can be performed, false if not.
 */
EAPI Eina_Bool eina_content_converter_convert_can(const char *from, const char *to);

/**
 * Returns a iterator that can be used to find all the possible types that can be converted to.
 *
 * @param[in] form The type you convert from
 *
 * @return A Iterator, containing strings, free this via eina_iterator_free.
 */
EAPI Eina_Iterator* eina_content_converter_possible_conversions(const char *from);

EAPI extern const Eina_Value_Type *EINA_VALUE_TYPE_CONTENT;

/**
 * Convert the Eina_Content object to a Eina_Value.
 *
 * @param[in] content The Eina_Content struct that will be converted to a Eina_Value
 *
 * @return A Eina_Value that is allocated, you need to free it.
 */
EAPI Eina_Value* eina_value_content_new(Eina_Content *content);

/**
 * Convert the Eina_Content object to a Eina_Value.
 *
 * @param[in] content The Eina_Content struct that will be converted to a Eina_Value
 *
 * @return A Eina_Value with type EINA_VALUE_TYPE_CONTENT
 */
EAPI Eina_Value eina_value_content_init(Eina_Content *content);

/**
 * Get the content from the Eina_Value
 *
 * If the value is not of the type EINA_VALUE_TYPE_CONTENT, NULL will be returned and a error will be printed.
 *
 * @param[in] value The value to get the content from
 *
 * @return A allocated Eina_Content, you need to free it.
 */
EAPI Eina_Content* eina_value_to_content(const Eina_Value *value);


static inline Eina_Iterator*
eina_content_possible_conversions(Eina_Content *content)
{
   return eina_content_converter_possible_conversions(eina_content_type_get(content));
}

#endif