TulTextResourceUtils Class Reference

class TulTextResourceUtils

Utility that provides methods to load and format resource strings. String Loader API provides an interface to load and format resource strings that may contain parameter(s) (%U for (unicode) text or or %N for numerical). Resource strings are usually defined in an RSS file.

The API consists of the TulTextResourceUtils class. All methods are static, so there is no need to explicitly allocate memory for the interface class. The implementation needs a CCoeEnv instance to access for example the resource files.

Usage:

Applications load and format resource strings from normal resources with static methods of the TulTextResourceUtils class. The loading is done with the LoadL and LoadLC methods and with the Load method in situations where memory allocation from the heap is not possible. Formatting is done automatically after loading in the LoadL and LoadLC methods, but it can also be done separately with the Format method in situations where memory allocation from the heap is not possible. For reading the resource strings with the Load, LoadL and LoadLC methods, the user should provide a pointer to CCoeEnv for efficiency reasons. If the pointer is not provided, the implementation uses the CCoeEnv::Static method internally to get it.

Different size displays can handle different length strings. To take full advantage of this fact, TulTextResourceUtils supports resource strings with multiple options for strings, separated by the character 0x0001. Each such string can contain the same or different sub string keys (%U and %N). TulTextResourceUtils returns all strings, it is the responsibility of the caller to parse the result and choose the proper string to display.

Setting the maximum sub string length may be done in the text resources. Sub string maximum lengths can be localized separately for every language. The maximum sub string length is of the format: %U[NN] where NN is a number [01..99]. Please note that NN must always consist of two characters, i.e. if the sub string maximum length is eight characters, the value to be used is 08, not plain 8. If the number of characters exceeds the maximum length, the sub string is cut to fit and the last character is replaced with an ellipsis character.

The following examples describe the usage of the String Loader API.

Usage when one TInt is added:

 // In .loc -file
 // #define text_example "You have %N undone tasks."

 // In .rss -file
 // RESOURCE TBUF r_text_example { buf = text_example; }

 // (In the .cpp -file)
 #include <coeutils.h>

 // Get CCoeEnv instance
 CEikonEnv* iEikonEnv = CEikonEnv::Static();

 TInt number(324);

 // Method reads a resource string with memory allocation
 // and replaces the first %N-string in it with replacement TInt.
 // The heap descriptor must be destroyed when it is no longer needed.
 // iEikonEnv is needed for loading the resource string.
 HBufC* stringholder = TulTextResourceUtils::LoadL(R_TEXT_EXAMPLE, number, iEikonEnv);

 // The 'number' is added to the resource string. The result is
 // that stringholder points to a heap descriptor containing string:
 // "You have 324 undone tasks."

 // Delete the heap descriptor
 delete stringholder;

Usage when several strings are added:

An index can be included to parameters. Several parameters can have same index if the same replacement is needed multiple times.

 // In .loc -file
 // #define text_example "I'm %2U%1U %3U%0U fine."

 // In .rss -file
 // RESOURCE TBUF r_text_example { buf = text_example; }

 // In the .cpp -file
 #include <coeutils.h>

 // Get CCoeEnv instance
 CEikonEnv* iEikonEnv = CEikonEnv::Static();

 CDesCArrayFlat* strings = new CDesCArrayFlat(4);
 CleanupStack::PushL(strings);

 strings->AppendL(_L("orking")); //First string

 strings->AppendL(_L("ll")); //Second string

 strings->AppendL(_L("sti")); //Third string

 strings->AppendL(_L("w")); //Fourth string

 // Method reads a resource string with memory allocation and replaces
 // the %(index)U strings in it with replacement strings from an array.
 // The heap descriptor must be destroyed when it is no longer needed.
 // iEikonEnv is needed for loading the resource string.
 HBufC* stringholder = TulTextResourceUtils::LoadL(R_TEXT_EXAMPLE, *strings, iEikonEnv);

 // Four strings are added to the resource string. The result is
 // that stringholder points to a heap descriptor containing string:
 // "I'm still working fine."

 // Pop and delete strings array
 CleanupStack::PopAndDestroy();

 // Delete the heap descriptor
 delete stringholder;

Usage with scalable UI support:

 // In .loc -file
 // #define TEXT_EXAMPLE "You have missed %N messages from %U."<0x0001>"Missed %N msgs from %U."<0x0001>"Missed %N msgs."

 // In .rss -file
 // RESOURCE TBUF R_TEXT_EXAMPLE { buf = TEXT_EXAMPLE; }

 // In the .cpp -file
 #include <coeutils.h>

 // Get CCoeEnv instance
 CEikonEnv* iEikonEnv = CEikonEnv::Static();

 TInt number(12);
 _LIT(name, "John Doe");

 // Method reads a resource string with memory allocation,
 // replaces all %N strings in it with a replacement TInt and
 // all %U strings in it with a replacement string.
 // The heap descriptor must be destroyed  when it is no longer needed.
 // iEikonEnv is needed for loading the resource string.
 HBufC stringholder = TulTextResourceUtils::LoadL(R_TEXT_EXAMPLE, name, number, iEikonEnv);

 // The number and name are added to the resource string. The result is
 // that stringholder points to a heap descriptor containing string:
 // "You have missed 12 messages from John Doe.\001Missed 12 msgs from John
 // Doe.\001Missed 12 msgs."

 // Delete the heap descriptor
 delete stringholder;

Error handling:

The leave mechanism of the Symbian OS environment is used to handle memory exhaustion. The panic mechanism is used to handle programming errors while debugging. TulTextResourceUtils panics for seven different reasons. The panic category is named TulTextResourceUtils. The panic codes are:

ETooFewArguments = 0 (Unsolved parameters in resource string.)
ETooManyArguments = 1 (Already solved all parameters in resource string.)
EKeyStringNotFound = 2 (The key string wasn't found in formatting.)
EInvalidIndex = 3 (Invalid index in Format-method)
EDescriptorTooSmall = 4 (Too small destination descriptor.)
ECCoeEnvNotInitialized = 5 (CCoeEnv is not initialized)
EInvalidSubstitute = 6 (Substituted string contains KSubStringSeparator)

Public Member Functions
IMPORT_C void	Format(TDes &, const TDesC &, TInt, TInt)
IMPORT_C void	Format(TDes &, const TDesC &, TInt, const TDesC &)
IMPORT_C void	Load(TDes &, TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, const TDesC &, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, const TDesC &, TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, const CArrayFix< TInt > &, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, const MDesCArray &, CCoeEnv *)
IMPORT_C HBufC *	LoadL(TInt, const MDesCArray &, const CArrayFix< TInt > &, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, const TDesC &, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, const TDesC &, TInt, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, const CArrayFix< TInt > &, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, const MDesCArray &, CCoeEnv *)
IMPORT_C HBufC *	LoadLC(TInt, const MDesCArray &, const CArrayFix< TInt > &, CCoeEnv *)

Private Member Functions
	TulTextResourceUtils()
	TulTextResourceUtils(const TulTextResourceUtils &)
TBidiText::TDirectionality	DirectionalityL(const TDesC &, TBool *)
void	FormatL(TDes &, const TDesC &, const TDesC &, const TDesC &)
HBufC *	FormatStringL(const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality)
HBufC *	FormatStringL(const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality, TInt &, TInt)
HBufC *	FormatStringL(TDesC &, const CArrayFix< TInt > &, TInt, TBidiText::TDirectionality)
HBufC *	FormatStringL(TDesC &, const MDesCArray &, TInt, TBidiText::TDirectionality)
TInt	Formater(TDes &, const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality)
TInt	GetParamCount(const TDesC &, TInt)
TInt	GetSubStringCount(const TDesC &)
void	KeyStringFormater(TDes &, const TText &, TInt, const TDesC &)
void	RemoveNoDirMarkers(TDes &)
TBidiText::TDirectionality	ResolveDirectionality(TDes &, TBool *)
HBufC *	ResolveSubStringDirsL(TDes &, TInt, TBool *)
HBufC *	ResolveSubStringL(TDes &, TBool *)
TulTextResourceUtils &	operator=(const TulTextResourceUtils &)

Constructor & Destructor Documentation

TulTextResourceUtils()

TulTextResourceUtils

(

)

[private]

TulTextResourceUtils(const TulTextResourceUtils &)

TulTextResourceUtils

(

const TulTextResourceUtils &

)

[private]

Parameters

const TulTextResourceUtils &

Member Functions Documentation

DirectionalityL(const TDesC &, TBool *)

TBidiText::TDirectionality	DirectionalityL	(	const TDesC &	aText,
			TBool *	aFound
		)	[private, static]

Parameters

const TDesC & aText
TBool * aFound

Format(TDes &, const TDesC &, TInt, TInt)

IMPORT_C void	Format	(	TDes &	aDest,
			const TDesC &	aSource,
			TInt	aPosition,
			TInt	aSubs
		)	[static]

Parameters

TDes & aDest
const TDesC & aSource
TInt aPosition
TInt aSubs

Format(TDes &, const TDesC &, TInt, const TDesC &)

IMPORT_C void	Format	(	TDes &	aDest,
			const TDesC &	aSource,
			TInt	aPosition,
			const TDesC &	aSubs
		)	[static]

Formats a resource string without memory allocation. The formatted string is stored in the destination TDes&. Since this method doesn't allocate memory the destination descriptor must be long enough. In aPosition -1 means that there is no index in the key string and all %U-strings in the original string are replaced with aSubs. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

panic

EInvalidIndex In debug build if the index of the key string is invalid.

panic

EDescriptorTooSmall In debug build if the length of the destination descriptor is too small.

panic

EKeyStringNotFound In debug build if the key string 'U' wasn't found, aDest is empty.

One small sample describing the usage of the method.

 // Load example string "%0U %1U" defined in rss- and loc-files.
 // %0U stands for weekday string and %1U for date string.
 HBufC* timeFormat = TulTextResourceUtils::LoadLC(R_TIME_FORMAT, iEikonEnv);

 // The replacing string.
 _LIT(dateString, "02/10/2006");

 TulTextResourceUtils::Format(destBuf, timeFormat, 
                       1, // %1U stands for date string
                       dateString);

 // After returning destBuf contains string "%0U 02/10/2006".

Parameters

TDes & aDest	Reference to the descriptor where the resource string is formatted.
const TDesC & aSource	Reference to the original string.
TInt aPosition	The index of the key string.
const TDesC & aSubs	Reference to the replacing string.

FormatL(TDes &, const TDesC &, const TDesC &, const TDesC &)

void	FormatL	(	TDes &	aDest,
			const TDesC &	aSource,
			const TDesC &	aKeybuf,
			const TDesC &	aSubs
		)	[private, static]

Parameters

TDes & aDest
const TDesC & aSource
const TDesC & aKeybuf
const TDesC & aSubs

FormatStringL(const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality)

HBufC *	FormatStringL	(	const TDesC &	aSource,
			const TDesC &	aKey,
			const TDesC &	aSubs,
			TBidiText::TDirectionality	aDir
		)	[private, static]

Parameters

const TDesC & aSource
const TDesC & aKey
const TDesC & aSubs
TBidiText::TDirectionality aDir

FormatStringL(const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality, TInt &, TInt)

HBufC *	FormatStringL	(	const TDesC &	aSource,
			const TDesC &	aKey,
			const TDesC &	aSubs,
			TBidiText::TDirectionality	aDirectionality,
			TInt &	aParamCount,
			TInt	aSubCount
		)	[private, static]

Parameters

const TDesC & aSource
const TDesC & aKey
const TDesC & aSubs
TBidiText::TDirectionality aDirectionality
TInt & aParamCount
TInt aSubCount

FormatStringL(TDesC &, const CArrayFix< TInt > &, TInt, TBidiText::TDirectionality)

HBufC *	FormatStringL	(	TDesC &	aSource,
			const CArrayFix< TInt > &	aInts,
			TInt	aMax,
			TBidiText::TDirectionality	aDir
		)	[private, static]

Parameters

TDesC & aSource
const CArrayFix< TInt > & aInts
TInt aMax
TBidiText::TDirectionality aDir

FormatStringL(TDesC &, const MDesCArray &, TInt, TBidiText::TDirectionality)

HBufC *	FormatStringL	(	TDesC &	aSource,
			const MDesCArray &	aStrings,
			TInt	aMax,
			TBidiText::TDirectionality	aDir
		)	[private, static]

Parameters

TDesC & aSource
const MDesCArray & aStrings
TInt aMax
TBidiText::TDirectionality aDir

Formater(TDes &, const TDesC &, const TDesC &, const TDesC &, TBidiText::TDirectionality)

TInt	Formater	(	TDes &	aDest,
			const TDesC &	aSource,
			const TDesC &	aKey,
			const TDesC &	aSubs,
			TBidiText::TDirectionality	aDirectionality
		)	[private, static]

Parameters

TDes & aDest
const TDesC & aSource
const TDesC & aKey
const TDesC & aSubs
TBidiText::TDirectionality aDirectionality

GetParamCount(const TDesC &, TInt)

TInt	GetParamCount	(	const TDesC &	aText,
			TInt	aIndex = -1
		)	[private, static]

Parameters

const TDesC & aText
TInt aIndex = -1

GetSubStringCount(const TDesC &)

TInt

GetSubStringCount

(

const TDesC &

aText

)

[private, static]

Parameters

const TDesC & aText

KeyStringFormater(TDes &, const TText &, TInt, const TDesC &)

void	KeyStringFormater	(	TDes &	aDest,
			const TText &	aKey,
			TInt	aPosition,
			const TDesC &	aKeyString
		)	[private, static]

Parameters

TDes & aDest
const TText & aKey
TInt aPosition
const TDesC & aKeyString

Load(TDes &, TInt, CCoeEnv *)

IMPORT_C void	Load	(	TDes &	aDest,
			TInt	aResourceId,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string without memory allocation. The loaded string is stored in the destination TDes&. Because this method doesn't allocate memory the destination descriptor must be long enough.

panic

ECCoeEnvNotInitialized Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TDes & aDest	Reference to the descriptor where the resource string is loaded.
TInt aResourceId	The numeric ID of the resource string to be read.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation.

Pointer to a heap descriptor containing the resource string. The calling program must destroy the heap descriptor when it is no longer needed.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			TInt	aInt,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and replaces the first %N-string in it with replacement TInt. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

EKeyStringNotFound In debug build if the key string 'N' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
TInt aInt	The replacing TInt.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, const TDesC &, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			const TDesC &	aString,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and replaces the first %U-string in it with replacement string. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

EKeyStringNotFound In debug build if the key string 'U' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const TDesC & aString	Reference to the replacing string.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, const TDesC &, TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			const TDesC &	aString,
			TInt	aInt,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the first %N-string in it with replacement TInt and the first %U-string in it with replacement string. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

EKeyStringNotFound In debug build if the key string 'N' or 'U' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const TDesC & aString	Reference to the replacing string.
TInt aInt	The replacing TInt.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, const CArrayFix< TInt > &, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			const CArrayFix< TInt > &	aInts,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and replaces the %(index)N-strings in it with replacement TInts from an array. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

ETooManyArguments In debug build if too many replacing elements in aInts array.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const CArrayFix< TInt > & aInts	Reference to the array including the replacing TInts.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, const MDesCArray &, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			const MDesCArray &	aStrings,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and replaces the %(index)U-strings in it with replacement strings from an array. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

ETooManyArguments In debug build if too many replacing elements in aStrings array.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const MDesCArray & aStrings	Reference to the array including pointers to the replacing strings.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadL(TInt, const MDesCArray &, const CArrayFix< TInt > &, CCoeEnv *)

IMPORT_C HBufC *	LoadL	(	TInt	aResourceId,
			const MDesCArray &	aStrings,
			const CArrayFix< TInt > &	aInts,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and replaces the %(index)U-strings in it with replacement strings from an array and the %(index)N-strings in it with replacement TInts from another array. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. The calling program must destroy the heap descriptor when it is no longer needed.

panic

ETooManyArguments In debug build if too many replacing elements in aStrings and/or aInts arrays.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const MDesCArray & aStrings	Reference to the array including pointers to the replacing strings.
const CArrayFix< TInt > & aInts	Reference to the array including the replacing TInts.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation and pushes the string onto the cleanup stack.

Pointer to a heap descriptor containing the resource string. This pointer is in the cleanup stack. The calling program should pop and destroy the heap descriptor when it is no longer needed.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			TInt	aInt,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the first %N-string in it with replacement TInt and pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

pointer to a heap descriptor containing the formatted resource string. This pointer is in the cleanup stack. The calling program should pop and destroy the heap descriptor when it is no longer needed.

panic

EKeyStringNotFound In debug build if the key string 'N' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
TInt aInt	the replacing TInt.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, const TDesC &, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			const TDesC &	aString,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the first %U-string in it with replacement string and pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

Pointer to a heap descriptor containing the formatted resource string. This pointer is in the cleanup stack. The calling program should pop and destroy the heap descriptor when it is no longer needed.

panic

EKeyStringNotFound In debug build if the key string 'U' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const TDesC & aString	Reference to the replacing string.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, const TDesC &, TInt, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			const TDesC &	aString,
			TInt	aInt,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the first %N-string in it with replacement TInt and the first %U-string in it with replacement string and pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

panic

EKeyStringNotFound In debug build if the key string 'N' or 'U' wasn't found in formatting.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const TDesC & aString	Reference to the replacing string.
TInt aInt	The replacing TInt.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, const CArrayFix< TInt > &, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			const CArrayFix< TInt > &	aInts,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the %(index)N-strings in it with replacement TInts from an array and pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

panic

ETooManyArguments In debug build if too many replacing elements in aInts array.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const CArrayFix< TInt > & aInts	Reference to the array including the replacing TInts.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, const MDesCArray &, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			const MDesCArray &	aStrings,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the %(index)U-strings in it with replacement strings from an array and pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

panic

ETooManyArguments In debug build if too many replacing elements in aStrings array.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const MDesCArray & aStrings	Reference to the array including pointers to the replacing strings.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

LoadLC(TInt, const MDesCArray &, const CArrayFix< TInt > &, CCoeEnv *)

IMPORT_C HBufC *	LoadLC	(	TInt	aResourceId,
			const MDesCArray &	aStrings,
			const CArrayFix< TInt > &	aInts,
			CCoeEnv *	aLoaderEnv = NULL
		)	[static]

Reads a resource string with memory allocation, replaces the %(index)U-strings in it with replacement strings from an array. Replaces the %(index)N-strings with replacement TInts from another array. Pushes the string onto the cleanup stack. In debug builds the Symbian OS panic mechanism is used to notify programming errors.

panic

ETooManyArguments In debug build if too many replacing elements in aStrings and/or aInts arrays.

leave

KErrNotSupported Parameter aLoaderEnv is NULL and CCoeEnv::Static returned NULL.

Parameters

TInt aResourceId	The numeric ID of the resource string to be read.
const MDesCArray & aStrings	Reference to the array including pointers to the replacing strings.
const CArrayFix< TInt > & aInts	Reference to the array including the replacing TInts.
CCoeEnv * aLoaderEnv = NULL	Pointer to the control environment. If user doesn't give this, CCoeEnv::Static is called to get it.

RemoveNoDirMarkers(TDes &)

void

RemoveNoDirMarkers

(

TDes &

aText

)

[private, static]

Parameters

TDes & aText

ResolveDirectionality(TDes &, TBool *)

TBidiText::TDirectionality	ResolveDirectionality	(	TDes &	aText,
			TBool *	aFound
		)	[private, static]

Parameters

TDes & aText
TBool * aFound

ResolveSubStringDirsL(TDes &, TInt, TBool *)

HBufC *	ResolveSubStringDirsL	(	TDes &	aText,
			TInt	aCount,
			TBool *	aMarker
		)	[private, static]

Parameters

TDes & aText
TInt aCount
TBool * aMarker

ResolveSubStringL(TDes &, TBool *)

HBufC *	ResolveSubStringL	(	TDes &	aText,
			TBool *	aMarker
		)	[private, static]

Parameters

TDes & aText
TBool * aMarker

operator=(const TulTextResourceUtils &)

TulTextResourceUtils &

operator=

(

const TulTextResourceUtils &

)

[private]

Parameters

const TulTextResourceUtils &