Text Conversion

Data Structures
struct	ATSCString_s
	Structure to describe an ATSC string. More...
struct	ATSCMultipleStrings_s
	Structure to describe multiple ATSC strings. More...
Typedefs
typedef struct ATSCString_s	ATSCString_t
typedef struct ATSCMultipleStrings_s	ATSCMultipleStrings_t
Functions
ATSCMultipleStrings_t *	ATSCMultipleStringsConvert (uint8_t *data, uint8_t len)
	Converts raw multiple string data into a ATSCMultipleStrings_t structure.
int	ATSCMultipleStringsInit (void)
void	ATSCMultipleStringsDeInit (void)
char *	DVBTextToUTF8 (char *toConvert, size_t toConvertLen)
	Converts the supplied string to UTF-8.

---

Function Documentation

ATSCMultipleStrings_t* ATSCMultipleStringsConvert	(	uint8_t *	data,
		uint8_t	len
	)

Converts raw multiple string data into a ATSCMultipleStrings_t structure.

Parameters:

	data	Raw multiple string data.
	len	Length of the raw data.

Returns:

A pointer to a ATSCMultipleStrings_t or NULL. To free the returned structure ObjectRefDec should be used.

void ATSCMultipleStringsDeInit

(

void

)

For internal use only.

Deinitiaise the ATSC multiple strings module.

int ATSCMultipleStringsInit

(

void

)

For internal use only.

Initialise the ATSC multiple strings module.

Returns:

0 on success.

char* DVBTextToUTF8	(	char *	toConvert,
		size_t	toConvertLen
	)

Converts the supplied string to UTF-8.

The input string should be in DVB format (see ETSI EN 300 468 Annex A2). The returned pointer is to a static buffer that will be reused by future calls to this method so the calling function should copy out the contents before calling this function again.

Parameters:

	toConvert	The string to convert to UTF-8.
	toConvertLen	The length of the string to convert.

Returns:

A pointer to a buffer containing the input string in UTF-8 format, or NULL if the conversion failed.