epoc32/include/convdata.h
author William Roberts <williamr@symbian.org>
Wed, 31 Mar 2010 12:33:34 +0100
branchSymbian3
changeset 4 837f303aceeb
parent 2 2fe1408b6811
permissions -rw-r--r--
Current Symbian^3 public API header files (from PDK 3.0.h)
This is the epoc32/include tree with the "platform" subtrees removed, and
all but a selected few mbg and rsg files removed.
williamr@4
     1
/*
williamr@4
     2
* Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
williamr@4
     3
* All rights reserved.
williamr@4
     4
* This component and the accompanying materials are made available
williamr@4
     5
* under the terms of "Eclipse Public License v1.0"
williamr@4
     6
* which accompanies this distribution, and is available
williamr@4
     7
* at the URL "http://www.eclipse.org/legal/epl-v10.html".
williamr@4
     8
*
williamr@4
     9
* Initial Contributors:
williamr@4
    10
* Nokia Corporation - initial contribution.
williamr@4
    11
*
williamr@4
    12
* Contributors:
williamr@4
    13
*
williamr@4
    14
* Description: 
williamr@4
    15
*
williamr@4
    16
*/
williamr@4
    17
williamr@2
    18
williamr@2
    19
#if !defined(__CONVDATA_H__)
williamr@2
    20
#define __CONVDATA_H__
williamr@2
    21
williamr@2
    22
/**
williamr@4
    23
This structure doesn't intend to be used by external developers.
williamr@4
    24
For plugin creators, all they need is to include this header file in order to compile. All the plugin data are generated from provided perl scripts. 
williamr@4
    25
 
williamr@4
    26
Any use of this structure externally are not proved to be compatible in future. 
williamr@2
    27
@internalComponent
williamr@2
    28
*/
williamr@2
    29
struct SCnvConversionData
williamr@2
    30
	{
williamr@2
    31
/** Specifies the default endian-ness of the current character set. Used by SetDefaultEndiannessOfForeignCharacters(). */
williamr@2
    32
	enum TEndianness // the values of these *must not* change they are used hard-coded in CNVTOOL.PL
williamr@2
    33
		{
williamr@2
    34
		EUnspecified		=0,
williamr@2
    35
		EFixedLittleEndian	=1,
williamr@2
    36
		EFixedBigEndian		=2
williamr@2
    37
		};
williamr@2
    38
	struct SVariableByteData
williamr@2
    39
		{
williamr@2
    40
		struct SRange
williamr@2
    41
			{
williamr@2
    42
			TUint8 iFirstInitialByteValueInRange;
williamr@2
    43
			TUint8 iLastInitialByteValueInRange;
williamr@2
    44
			TUint8 iNumberOfSubsequentBytes;
williamr@2
    45
			TUint8 iSpare;
williamr@2
    46
			};
williamr@2
    47
		TInt iNumberOfRanges;
williamr@2
    48
		const SRange* iRangeArray;
williamr@2
    49
		};
williamr@2
    50
	struct SOneDirectionData
williamr@2
    51
		{
williamr@2
    52
		struct SRange
williamr@2
    53
			{
williamr@2
    54
			enum TAlgorithm
williamr@2
    55
				{
williamr@2
    56
				// each of these, with the exception of EDirect, has a corresponding member of UData
williamr@2
    57
				EDirect,
williamr@2
    58
				EOffset,
williamr@2
    59
				EIndexedTable16,
williamr@2
    60
				EKeyedTable1616,
williamr@4
    61
				EKeyedTable16OfIndexedTables16,
williamr@4
    62
				EIndexedTable32,
williamr@4
    63
				EKeyedTable3232,
williamr@4
    64
				EKeyedTable32OfIndexedTables32
williamr@2
    65
				};
williamr@2
    66
			union UData
williamr@2
    67
				{
williamr@2
    68
				struct SIndexedTable16
williamr@2
    69
					{
williamr@2
    70
					struct SEntry
williamr@2
    71
						{
williamr@2
    72
						TUint16 iOutputCharacterCode;
williamr@2
    73
						};
williamr@2
    74
					const SEntry* iEntryArray;
williamr@2
    75
					};
williamr@2
    76
				struct SKeyedTable1616
williamr@2
    77
					{
williamr@2
    78
					struct SEntry
williamr@2
    79
						{
williamr@2
    80
						TUint16 iKey;
williamr@2
    81
						TUint16 iOutputCharacterCode;
williamr@2
    82
						};
williamr@2
    83
					TInt iNumberOfEntries;
williamr@2
    84
					const SEntry* iEntryArray;
williamr@2
    85
					};
williamr@2
    86
				struct SKeyedTable16OfIndexedTables16
williamr@2
    87
					{
williamr@2
    88
					struct SKeyedEntry
williamr@2
    89
						{
williamr@2
    90
						TUint16 iFirstInputCharacterCodeInIndexedTable;
williamr@2
    91
						TUint16 iLastInputCharacterCodeInIndexedTable;
williamr@2
    92
						const TUint16* iIndexedEntryArray;
williamr@2
    93
						};
williamr@2
    94
					TInt iNumberOfKeyedEntries;
williamr@2
    95
					const SKeyedEntry* iKeyedEntryArray;
williamr@2
    96
					};
williamr@4
    97
				struct SIndexedTable32
williamr@4
    98
					{
williamr@4
    99
					struct SEntry
williamr@4
   100
						{
williamr@4
   101
						TUint32 iOutputCharacterCode;
williamr@4
   102
						};
williamr@4
   103
					const SEntry* iEntryArray;
williamr@4
   104
					};
williamr@4
   105
				struct SKeyedTable3232
williamr@4
   106
					{
williamr@4
   107
					struct SEntry
williamr@4
   108
						{
williamr@4
   109
						TUint32 iKey;
williamr@4
   110
						TUint32 iOutputCharacterCode;
williamr@4
   111
						};
williamr@4
   112
					TInt iNumberOfEntries;
williamr@4
   113
					const SEntry* iEntryArray;
williamr@4
   114
					};
williamr@4
   115
				struct SKeyedTable32OfIndexedTables32
williamr@4
   116
					{
williamr@4
   117
					struct SKeyedEntry
williamr@4
   118
						{
williamr@4
   119
						TUint32 iFirstInputCharacterCodeInIndexedTable;
williamr@4
   120
						TUint32 iLastInputCharacterCodeInIndexedTable;
williamr@4
   121
						const TUint32* iIndexedEntryArray;
williamr@4
   122
						};
williamr@4
   123
					TInt iNumberOfKeyedEntries;
williamr@4
   124
					const SKeyedEntry* iKeyedEntryArray;
williamr@4
   125
					};
williamr@2
   126
				TInt iOffset;
williamr@2
   127
				SIndexedTable16 iIndexedTable16;
williamr@2
   128
				SKeyedTable1616 iKeyedTable1616;
williamr@2
   129
				SKeyedTable16OfIndexedTables16 iKeyedTable16OfIndexedTables16;
williamr@4
   130
				SIndexedTable32 iIndexedTable32;
williamr@4
   131
				SKeyedTable3232 iKeyedTable3232;
williamr@4
   132
				SKeyedTable32OfIndexedTables32 iKeyedTable32OfIndexedTables32;
williamr@2
   133
				};
williamr@2
   134
			TUint iFirstInputCharacterCodeInRange;
williamr@2
   135
			TUint iLastInputCharacterCodeInRange;
williamr@2
   136
			TUint8 iAlgorithm; // one of the TAlgorithm values
williamr@2
   137
			TUint8 iSizeOfOutputCharacterCodeInBytesIfForeign; // only used in SCnvConversionData::iUnicodeToForeignData
williamr@2
   138
			TUint16 iSpare;
williamr@2
   139
#if defined(CONST_STATIC_UNIONS_ARE_POSSIBLE)
williamr@2
   140
			UData iData;
williamr@2
   141
#else
williamr@2
   142
			struct
williamr@2
   143
				{
williamr@2
   144
				TUint iWord1;
williamr@2
   145
				TUint iWord2;
williamr@2
   146
				} iData;
williamr@2
   147
#endif
williamr@2
   148
			};
williamr@2
   149
		TInt iNumberOfRanges;
williamr@2
   150
		const SRange* iRangeArray;
williamr@2
   151
		};
williamr@2
   152
	TEndianness iEndiannessOfForeignCharacters;
williamr@2
   153
	SVariableByteData iForeignVariableByteData;
williamr@2
   154
	SOneDirectionData iForeignToUnicodeData;
williamr@2
   155
	SOneDirectionData iUnicodeToForeignData;
williamr@2
   156
	TAny* iSpareForFutureUse_1;
williamr@2
   157
	TAny* iSpareForFutureUse_2;
williamr@2
   158
	};
williamr@2
   159
williamr@2
   160
/**
williamr@2
   161
@internalComponent
williamr@2
   162
*/
williamr@2
   163
#define UData_SIndexedTable16(a) \
williamr@2
   164
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SIndexedTable16::SEntry*>(a)) 
williamr@2
   165
/**
williamr@2
   166
@internalComponent
williamr@2
   167
*/
williamr@2
   168
#define UData_SKeyedTable1616(a) \
williamr@2
   169
	static_cast<TUint>ARRAY_LENGTH(a), \
williamr@2
   170
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SKeyedTable1616::SEntry*>(a))
williamr@2
   171
/**
williamr@2
   172
@internalComponent
williamr@2
   173
*/
williamr@2
   174
#define UData_SKeyedTable16OfIndexedTables16(a)	\
williamr@2
   175
	static_cast<TUint>ARRAY_LENGTH(a), \
williamr@2
   176
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SKeyedTable16OfIndexedTables16::SKeyedEntry *>(a)) 
williamr@4
   177
/**
williamr@4
   178
@internalComponent
williamr@4
   179
*/
williamr@4
   180
#define UData_SIndexedTable32(a) \
williamr@4
   181
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SIndexedTable32::SEntry*>(a)) 
williamr@4
   182
/**
williamr@4
   183
@internalComponent
williamr@4
   184
*/
williamr@4
   185
#define UData_SKeyedTable3232(a) \
williamr@4
   186
	static_cast<TUint>ARRAY_LENGTH(a), \
williamr@4
   187
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SKeyedTable3232::SEntry*>(a))
williamr@4
   188
/**
williamr@4
   189
@internalComponent
williamr@4
   190
*/
williamr@4
   191
#define UData_SKeyedTable32OfIndexedTables32(a)	\
williamr@4
   192
	static_cast<TUint>ARRAY_LENGTH(a), \
williamr@4
   193
	reinterpret_cast<TUint>(const_cast<SCnvConversionData::SOneDirectionData::SRange::UData::SKeyedTable32OfIndexedTables32::SKeyedEntry *>(a)) 
williamr@4
   194
#endif
williamr@2
   195