Symbian Developer Library

SYMBIAN OS V6.1 EDITION FOR C++

[Index] [Glossary] [Previous] [Next]



Location: convplug.h

ReplacementForUnconvertibleUnicodeCharacters()

const TDesC8& ReplacementForUnconvertibleUnicodeCharacters();

Support

Supported from 6.0

Description

A function prototype which must be implemented by a character conversion plug-in DLL to return the character (represented by one or more byte values) which is used by default as the replacement for unconvertible Unicode characters. This character is used when converting from Unicode into a foreign character set, if there is no equivalent for the Unicode character in the foreign character set. The default replacement character can be overriden by a call to CCnvCharacterSetConverter::SetReplacementForUnconvertibleUnicodeCharactersL().

This function is exported at ordinal position 1 in the plug-in DLL. It is called by CCnvCharacterSetConverter::PrepareToConvertToOrFromL().

To implement this function, you should #include convgeneratedcpp.h in the cpp file. This gives access to the ReplacementForUnconvertibleUnicodeCharacters_internal() function. This function can then be implemented by calling ReplacementForUnconvertibleUnicodeCharacters_internal().

Return value

const TDesC8&

The single character which is to be used to replace unconvertible characters.