| class CVersitParser : public CBase |
A generic Versit parser.
Provides generic functions which implement behaviour common to both vCalendar and vCard parsers. For instance:
InternalizeL() and ExternalizeL() functions, for writing and reading data from a stream or file.
adding/retrieving properties and sub-entities to/from an existing entity.
encoding and character set conversion capabilities.
Although this is not an abstract class, in practice you would create and use objects of a derived class instead (CParserVCal or CParserVCard), as these provide additional functionality needed for parsing vCalendars and vCards.
Note: a flag used in the class constructor indicates whether the entity needs a version property. The version property will be inserted at the start of the array of properties for the entity, and specifies the version of the vCard/vCalendar specification used by the data of this particular vCard/vCalendar. The versions that are currently supported are vCard v2.1 and vCalendar v1.0.
A typical vCard looks like this:
BEGIN VCARD
VERSION 2.1 ...
END VCARD
Note: if you are sequentially creating and destroying multiple parsers, a major performance improvement may be achieved by using thread local storage to store an instance of CVersitUnicodeUtils which persists and can be used by all of the parsers.
See CVersitTlsData for more details.
| Private Member Functions | |
|---|---|
| void | ConvertAllUTCDateTimesToMachineLocalL(const TTimeIntervalSeconds &, const CVersitDaylight *) |
| void | ConvertUTCDateTimeToMachineLocal(TVersitDateTime *, const TTimeIntervalSeconds &, const CVersitDaylight *) |
| void | DoInternalizeL() |
| IMPORT_C void | Reserved1() |
| IMPORT_C void | Reserved2() |
| void | SetLineCharsetDetailsToDefault() |
| void | SetLineEncodingDetailsToDefault() |
| Public Member Enumerations | |
|---|---|
| enum | TCharCodes { ESpace = ' ', EHTab = 9, ELineFeed = 10, ECarriageReturn = 13, EColon = ':' } |
| enum | TVersitParserFlags { ENoVersionProperty = 0, ESupportsVersion = 0x01, EImportSyncML = 0x1000, EUseAutoDetection = 0x4000, ECharSetIdentified = 0x8000, EUseDefaultCharSetForAllProperties = 0x2000 } |
| Private Attributes | |
|---|---|
| TInt | iParseBegin |
| TInt | iReserved2 |
| IMPORT_C | CVersitParser | ( | TUint | aFlags | ) |
The first phase constructor for a Versit parser.
Sets the default encoding to Versit::ENoEncoding and the default character set to Versit::EUSAsciiCharSet.
Note: this function is called by the CParserVCal and CParserVCard constructors. It should only be called directly by a user if creating a new parser
| TUint aFlags | The flag to indicate whether this entity needs a version property. The possible values for this flag are given in the TVersitParserFlags enumeration. If a version property is needed, one will be created and appended to the start of the array of properties. |
| IMPORT_C | ~CVersitParser | ( | ) |
Frees all resources owned by the object, prior to its destruction.
| IMPORT_C void | AddEntityL | ( | CVersitParser * | aEntity | ) |
Adds a sub-entity (e.g. a to-do, event or a nested vCard) to the current entity.
Sets the default encoding and character set to the default ones of the current Versit parser, then adds the entity to the array of entities owned by the parser.
Note: This function may be used when building up a Versit parser object from a client application.
Called by ParseEntityL().
| CVersitParser * aEntity | The entity to be added into the array of entities. Ownership of aEntity is taken at beginning of the function. |
| IMPORT_C void | AddPropertyL | ( | CParserProperty * | aProperty, |
| TBool | aInternalizing = EFalse | |||
| ) | ||||
Appends a property to the current entity's array of properties.
This function may be used when building up a Versit parser object from a client application. It is not called internally.
| CParserProperty * aProperty | Pointer to the property to add to the entity. |
| TBool aInternalizing = EFalse | This parameter is used to distinguish between reading an entity from a stream or file (i.e. internalising), in which case the argument should have a value of ETrue, and building an entity "by hand" (e.g. creating a vCard in the Contacts application), in which case the argument should have a value of EFalse. |
| IMPORT_C void | AdjustAllPropertyDateTimesToMachineLocalL | ( | ) |
| IMPORT_C void | AnalysesEncodingCharset | ( | CArrayPtr< CParserParam > * | aArrayOfParams | ) | [protected] |
| CArrayPtr< CParserParam > * aArrayOfParams |
| IMPORT_C CArrayPtr< CVersitParser > * | ArrayOfEntities | ( | TBool | aTakeOwnership = ETrue | ) |
Gets the current entity's array of sub-entities.
Note: the current entity may be a top level entity, or may itself be a sub-entity.
| TBool aTakeOwnership = ETrue | If ETrue, the calling code takes ownership of the array; the array of entities owned by the current entity is then deleted. If EFalse, ownership remains with the Versit parser. |
| IMPORT_C CArrayPtr< CParserProperty > * | ArrayOfProperties | ( | TBool | aTakeOwnership = ETrue | ) |
Gets the current entity's array of properties.
| TBool aTakeOwnership = ETrue | If ETrue, the calling code takes ownership of the array; the entity's array of properties is then deleted . If EFalse, ownership remains with the entity. |
| IMPORT_C void | ConstructL | ( | ) |
The second phase constructor for a Versit parser.
Stores a pointer to a CVersitTlsData (thread local storage data class). This is used to allow an instance of CVersitUnicodeUtils to be shared by all co-existing parsers, which provides a major performance improvement.
Called by the CParserVCal and CParserVCard constructors.
Should only be called directly by a user if creating a new parser.
| IMPORT_C void | ConvertAllPropertyDateTimesToMachineLocalL | ( | const TTimeIntervalSeconds & | aIncrement, |
| const CVersitDaylight * | aDaylight | |||
| ) | [virtual] | |||
Converts all date/time property values contained in the current entity's array of properties into machine local values.
This conversion is needed because of differences in universal and local times due to time zones and daylight savings (seasonal time shifts).
First, all of the date/times are converted to universal time, if they are not already:
If daylight saving is in effect then the daylight savings rule (held in the aDaylight parameter) will be used to compensate for differences between universal and local times due to both time zones and the daylight saving. Otherwise, the aIncrement parameter is used to compensate for any difference due to time zones alone.
Then, these universal time values are converted into machine local times by adding the universal time offset for the machine's locale.
since 9.1
| const TTimeIntervalSeconds & aIncrement | A time interval in seconds which represents the negative of the time zone of the originating machine. For instance, if the time zone is +04:30, aIncrement should be set to -04:30. |
| const CVersitDaylight * aDaylight | Pointer to the specification for daylight saving. If the date/time value is within the period for daylight saving, the value is modified by the daylight saving offset (which accounts for both the time zone and daylight saving rule). |
| void | ConvertAllUTCDateTimesToMachineLocalL | ( | const TTimeIntervalSeconds & | aIncrement, |
| const CVersitDaylight * | aDaylight | |||
| ) | [private] | |||
| const TTimeIntervalSeconds & aIncrement | |
| const CVersitDaylight * aDaylight |
| IMPORT_C TInt | ConvertFromUnicodeToISOL | ( | TDes8 & | aIso, |
| const TDesC16 & | aUnicode, | |||
| CCnvCharacterSetConverter * | aConverter | |||
| ) | [static] | |||
Converts text in the Unicode character set (UCS-2) into a non-unicode (International Standards Organisation) character set.
Which ISO character set the string is converted to is determined by the value of the character set identifier in the aConverter parameter.
| TDes8 & aIso | On return, the converted text string in the specified ISO character set. |
| const TDesC16 & aUnicode | The Unicode text string to be converted. |
| CCnvCharacterSetConverter * aConverter | The character set converter. |
| IMPORT_C TInt | ConvertToUnicodeFromISOL | ( | TDes16 & | aUnicode, |
| const TDesC8 & | aIso, | |||
| TUint | aCharacterSet | |||
| ) | [protected] | |||
Converts text in a non-Unicode character set into Unicode (UCS-2).
| HBufC * | ConvertToUnicodeL | ( | const TDesC8 & | aValue | ) | [protected] |
| const TDesC8 & aValue |
| void | ConvertUTCDateTimeToMachineLocal | ( | TVersitDateTime * | aDateTime, |
| const TTimeIntervalSeconds & | aIncrement, | |||
| const CVersitDaylight * | aDaylight | |||
| ) | [private] | |||
| TVersitDateTime * aDateTime | |
| const TTimeIntervalSeconds & aIncrement | |
| const CVersitDaylight * aDaylight |
| IMPORT_C TVersitDateTime * | DecodeDateTimeL | ( | TDes & | aToken | ) | const |
| TDes & aToken |
| IMPORT_C HBufC * | DecodePropertyValueL | ( | const TDesC8 & | aValue | ) | [protected] |
| const TDesC8 & aValue |
| IMPORT_C void | DecodePropertyValueL | ( | const TDesC8 & | aValue, |
| const TUid & | aEncodingUid | |||
| ) | [protected] | |||
| IMPORT_C TTime * | DecodeTimePeriodL | ( | const TDesC & | aToken | ) | const [protected] |
| const TDesC & aToken |
| IMPORT_C TTimeIntervalSeconds | DecodeTimeZoneL | ( | const TDesC & | aToken | ) | const [protected] |
| const TDesC & aToken |
| IMPORT_C Versit::TVersitCharSet | DefaultCharSet | ( | ) | const |
Gets the default character set or transformation format. This may be used to represent property values in Versit objects.
| IMPORT_C TUint | DefaultCharSetId | ( | ) | const |
Gets the default character set or transformation format.
This may be used to represent property values in Versit objects.
| IMPORT_C Versit::TVersitEncoding | DefaultEncoding | ( | ) | const |
Gets the parser's default encoding.
This value is initialised on construction, to ENoEncoding.
| IMPORT_C void | DoAddPropertyL | ( | CParserProperty * | aProperty | ) | [protected] |
| CParserProperty * aProperty |
| IMPORT_C CArrayPtr< CVersitParser > * | EntityL | ( | const TDesC & | aEntityName, |
| TBool | aTakeOwnership = ETrue | |||
| ) | ||||
Gets all sub-entities in the current entity, whose name matches the name specified.
| const TDesC & aEntityName | The sub-entity name of interest, e.g. KVersitVarTokenVEVENT or KVersitVarTokenVTODO. All sub-entities which match this name are returned in the array of pointers. |
| TBool aTakeOwnership = ETrue | If ETrue, the calling code takes ownership of each matching sub-entity, in which case the sub-entities are deleted from the current object's array of entities. If EFalse, ownership remains with the Versit parser. |
| IMPORT_C TPtrC | EntityName | ( | ) | const |
Gets the current entity's name.
If no name has been set, returns an empty descriptor.
| IMPORT_C void | ExternalizeL | ( | RFile & | aOutputFile | ) |
Externalises a Versit entity (vCard or vCalendar) and all of its sub-entities and properties to a file.
Adds a version property to the start of the current entity's array of properties if the entity supports this.
This is a thin layer over the CVersitParser::ExternalizeL(RWriteStream& aStream) function to enable a versit entity to be externalised into an RFile.
| RFile & aOutputFile | The file to which to write the entity. |
| IMPORT_C void | ExternalizeL | ( | RWriteStream & | aStream | ) | [virtual] |
Externalises a Versit entity (vCard or vCalendar) and all of its sub-entities and properties to a write stream.
Adds a version property to the start of the current entity's array of properties if the entity supports this. (If there isn't an array of properties then one is made).
The presence of this function means that the standard templated operator<<() (defined in s32strm.h) is available to externalise objects of this class.
This virtual function serves as a base function for derived classes to externalise an entity.
| RWriteStream & aStream | Stream to which the entity should be externalised. |
| IMPORT_C TBool | FindFirstField | ( | TPtr16 & | aField, |
| TPtr16 & | aRemaining, | |||
| TBool | aTrimSpace = ETrue | |||
| ) | [protected] | |||
| IMPORT_C void | FindRemainingField | ( | TPtr16 & | aField, |
| TPtr16 & | aRemaining | |||
| ) | [protected] | |||
Sets up a pointer to the remaining field. Sets the original remaining field pointers length to 0.
| IMPORT_C TInt | GetNumberL | ( | const TDesC & | aToken, |
| TInt & | aNumChars | |||
| ) | const [protected] | |||
| IMPORT_C CArrayPtr< CParserParam > * | GetPropertyParamsLC | ( | TPtr8 | aParams | ) | [protected] |
| TPtr8 aParams |
| IMPORT_C void | InternalizeL | ( | RFile & | aInputFile, |
| TInt & | aBytesThroughFile | |||
| ) | ||||
Internalises a versit entity (vCard or vCalendar) and all of its sub-entities and properties from a file.
Stores all date/time in same format as received
| IMPORT_C void | InternalizeL | ( | RReadStream & | aStream | ) | [virtual] |
Internalises a Versit entity (vCard or vCalendar) contained in the incoming stream and parses it, breaking it down into its constituent sub-entities (e.g. to-dos, events, and nested vCards) and properties.
The presence of this function means that the standard templated operator>>() (defined in s32strm.h) is available to internalise objects of this class.
This virtual function serves as a base function for derived classes to internalise an entity.
| RReadStream & aStream | Stream from which the vCalendar should be internalised. |
| IMPORT_C void | InternalizeL | ( | HBufC * | aEntityName, |
| CLineReader * | aLineReader | |||
| ) | [virtual] | |||
Internalises a vCalendar or vCard sub-entity.
(Assumes "BEGIN : <EntityName> CRLF" has been parsed).
This virtual function serves as a base function for derived classes to parse a sub-entity.
| HBufC * aEntityName | The entity name to be parsed. Ownership of aEntityName is taken by the parser. |
| CLineReader * aLineReader | Pointer to a line reader which is used by the super-entity. |
| TBool | IsPunctuationToken | ( | TUint | aChar | ) | [protected, static] |
| TUint aChar |
| IMPORT_C TBool | IsValidLabel | ( | const TDesC & | aLabel, |
| TInt & | aPos | |||
| ) | [static] | |||
Tests whether a property name is valid.
The property name is invalid if it contains any of the following characters:-
[] (left or right square bracket)
= (equals sign)
: (colon)
. (dot)
, (comma)
| IMPORT_C TBool | IsValidParameterValue | ( | TInt & | aPos, |
| const TDesC & | aParamValue | |||
| ) | [static] | |||
Tests whether a property parameter name or value is valid.
If the string aParamValue contains any punctuation characters, the string is invalid. Otherwise, it is valid. Punctuation characters are defined as any of the following:-
[] (left or right square bracket)
= (equals sign)
: (colon)
; (semi colon)
. (dot)
, (comma)
| IMPORT_C TInt | LoadBinaryValuesFromFilesL | ( | ) |
Loads all files represented by URI property values and sets the binary data contained in the files to be the property values instead of the URIs.
For every property in the parser, if its value is a URI containing file:// followed by a path and filename, then the file is opened and the binary data it contains is read into a CParserPropertyValueBinary object. This replaces the URI as the property value. The function also operates on any agents in the vCard that contain URI property values.
The function creates its own file server session, which is needed to open the files. It leaves if there is a problem opening any of the files.
| IMPORT_C TInt | LoadBinaryValuesFromFilesL | ( | RFs & | aFileSession | ) |
Loads all files represented by URI property values and sets the binary data contained in the files to be the property values instead of the URIs.
For every property in the parser, if its value is a URI containing file:// followed by a path and filename, then the file is opened and the binary data it contains is read into a CParserPropertyValueBinary object. This replaces the URI as the property value. The function also operates on any agents in the vCard that contain URI property values.
The function uses the file server session supplied, which is needed to open the files. It leaves if there is a problem opening any of the files.
| RFs & aFileSession | The file server session used to open the files. |
| CParserPropertyValueHBufC * | MakeDefaultPropertyValueL | ( | HBufC16 *& | aValue | ) | [protected] |
Instantiates and gives ownership of a CParserPropertyValueHBufC object.
| HBufC16 *& aValue |
| IMPORT_C CVersitParser * | MakeEntityL | ( | TInt | aEntityUid, |
| HBufC * | aEntityName | |||
| ) | [protected, virtual] | |||
| IMPORT_C void | MakePropertyL | ( | TPtr8 & | aPropName, |
| TInt | aValueStart | |||
| ) | [protected] | |||
| IMPORT_C CDesCArray * | MakePropertyValueCDesCArrayL | ( | TPtr16 | aStringValue | ) | [protected] |
Parses a compound property value string.
The sub-values found are appended to an array, after removal of escape characters. The array is returned, and ownership is transferred to the caller.
| TPtr16 aStringValue | Compound property value string. |
| IMPORT_C CVersitDaylight * | MakePropertyValueDaylightL | ( | TPtr16 | aDaylightValue | ) | [protected] |
| TPtr16 aDaylightValue |
| IMPORT_C CParserPropertyValue * | MakePropertyValueL | ( | const TUid & | aPropertyUid, |
| HBufC16 *& | aValue | |||
| ) | [protected, virtual] | |||
| IMPORT_C CArrayPtr< TVersitDateTime > * | MakePropertyValueMultiDateTimeL | ( | TPtr16 | aDateTimeGroup | ) | [protected] |
| TPtr16 aDateTimeGroup |
| TUint | MapVersitCharsetToCharConvCharset | ( | Versit::TVersitCharSet | aVersitSet | ) | [static] |
| Versit::TVersitCharSet aVersitSet |
| TUint | MapVersitEncodingToConArcUid | ( | Versit::TVersitEncoding | aVersitEncoding | ) | [static] |
| Versit::TVersitEncoding aVersitEncoding |
| IMPORT_C void | ParseParamL | ( | CArrayPtr< CParserParam > * | aArray, |
| TPtr8 | aParam | |||
| ) | [protected] | |||
| CArrayPtr< CParserParam > * aArray | |
| TPtr8 aParam |
| IMPORT_C CArrayPtr< CParserProperty > * | PropertyL | ( | const TDesC8 & | aPropertyName, |
| const TUid & | aPropertyUid, | |||
| TBool | aTakeOwnership = ETrue | |||
| ) | const | |||
Gets all properties in the current entity's array of properties whose name and value match the name and value specified.
| const TDesC8 & aPropertyName | The property name of interest. Property names are defined in vtoken.h. |
| const TUid & aPropertyUid | The ID of the property value of interest (which has the format "K<Versit/Card/Cal>Property<Type>Uid"). The values are defined in file vuid.h. |
| TBool aTakeOwnership = ETrue | If ETrue, the calling code takes ownership of each matching property; the property is then deleted from the current entity's array. If EFalse, ownership remains with the entity. |
| IMPORT_C CArrayPtr< CParserParam > * | ReadLineAndDecodeParamsLC | ( | TInt & | aValueStart, |
| TInt & | aNameLen | |||
| ) | [protected] | |||
| IMPORT_C void | ReadMultiLineValueL | ( | TPtr8 & | aValue, |
| TInt | aValueStart, | |||
| TBool | aBinaryData | |||
| ) | [protected] | |||
| IMPORT_C TInt | RecognizeEntityName | ( | ) | const [virtual] |
Tests the current entity to see if it is a vEvent or vTodo.
This function is virtual. Actual testing only occurs in derived classes which implement this function.
| IMPORT_C TUid | RecognizeToken | ( | const TDesC8 & | aToken | ) | const [virtual] |
Returns a UID for the specified token.
This function only recognizes generic Versit tokens. For example, if aToken contains the property name KVersitTokenBEGIN, the function returns KVersitTokenBeginUid. More specific recognition should occur in derived classes which implement this function, using this as the base recogniser.
| const TDesC8 & aToken | The token to be recognized. |
| IMPORT_C void | ResetAndDestroyArrayOfDateTimes | ( | TAny * | aObject | ) | [static] |
Destroys an array of Versit dates and times.
| TAny * aObject | Pointer to the array of Versit dates and times to be destroyed. |
| IMPORT_C void | ResetAndDestroyArrayOfEntities | ( | TAny * | aObject | ) | [static] |
Destroys an array of entities.
| TAny * aObject | Pointer to the array of entities to be destroyed. |
| IMPORT_C void | ResetAndDestroyArrayOfParams | ( | TAny * | aObject | ) | [static] |
Destroys an array of parameters.
| TAny * aObject | Pointer to the array of parameters to be destroyed. |
| IMPORT_C void | ResetAndDestroyArrayOfProperties | ( | TAny * | aObject | ) | [static] |
Destroys an array of properties.
| TAny * aObject | Pointer to the array of properties to be destroyed. |
| IMPORT_C TInt | SaveBinaryValuesToFilesL | ( | TInt | aSizeThreshold, |
| const TDesC & | aPath | |||
| ) | ||||
Saves all binary property values larger than a specified threshold to files, and sets each property value to be a URI representing the file, rather than the binary data iself.
The files are created in the folder identified by aPath, and are assigned unique filenames that consist of the property name and some random numbers.
Each new URI property value is prefixed with file:// and contains the path and filename of the file created.
If a vCard contains any agent property values and if they contain binary data whose size exceeds the threshold, these property values are replaced with URI property values.
The function sets up its own file server session, which is needed to create the files. It leaves if there is a problem creating any of the files.
| TInt aSizeThreshold | The threshold number of bytes for the binary data, above which the binary data is stored in a file. |
| const TDesC & aPath | The path identifying the location in which the files are created. This must not be greater than 240 characters long or the function leaves with KErrArgument. If it doesn't end in a slash, then one is appended. |
| IMPORT_C TInt | SaveBinaryValuesToFilesL | ( | TInt | aSizeThreshold, |
| const TDesC & | aPath, | |||
| RFs & | aFileSession | |||
| ) | ||||
Saves all binary property values larger than a specified threshold to files, and sets each property value to be a URI representing the file rather than the binary data iself.
The files are created in the folder identified by aPath, and are assigned unique filenames that consist of the property name and some random numbers.
Each new URI property value is prefixed with file:// and contains the path and filename of the file created.
If a vCard contains any agent property values and if they contain binary data whose size exceeds the threshold, these property values are replaced with URI property values.
The function uses the file server session supplied, which is needed to create the files. It leaves if there is a problem creating any of the files.
| TInt aSizeThreshold | The threshold number of bytes for the binary data, above which the binary data is stored in a file. |
| const TDesC & aPath | The path identifying the location in which the files are created. This must not be greater than 240 characters long or the function leaves with KErrArgument. If it doesn't end in a slash, then one is appended. |
| RFs & aFileSession | The file server session used to create the files. |
| IMPORT_C void | SetAutoDetect | ( | TBool | aOn, |
| const CArrayFix< CCnvCharacterSetConverter::SCharacterSet > * | aAutoDetectCharSets = NULL | |||
| ) | ||||
Turns auto detection of character sets on or off.
If a property does not specify a character set, then it is possible to guess its character set. This function turns this behaviour on or off. When the behaviour is on, it also lets the caller specify a restricted set of character sets to be considered.
Auto-detection of character sets is used (if auto detection is on) when converting a property value to Unicode while internalising a stream.
| TBool aOn | If ETrue, auto detection is turned on; if EFalse (the default value), auto detection is turned off |
| const CArrayFix< CCnvCharacterSetConverter::SCharacterSet > * aAutoDetectCharSets = NULL | If specified then auto detection will only consider the character sets listed. If NULL, all available character sets are considered. |
| IMPORT_C void | SetCharacterConverter | ( | Versit::TEncodingAndCharset & | encodingAndCharset | ) |
Sets a character converter suitable for converting strings between Unicode and the specified character set.
The function finds a suitable converter for the character set specified in aEncodingAndCharset.iCharSetId, if one is available, and assigns it to aEncodingAndCharset.iConverter.
If there is no converter available for the specified character set then iConverter is set to NULL.
This function is only of use if executing a major change to the externalisation behaviour, particularly if overriding CParserProperty::ExternalizeL() - the function from which this function is called.
| Versit::TEncodingAndCharset & encodingAndCharset | A utility class from which the character set information is extracted (from its member iCharSetId) and to which the suitable character converter is set (to its member iConverter). |
| IMPORT_C void | SetDefaultCharSet | ( | const Versit::TVersitCharSet | aCharSet | ) |
Sets the default character set or transformation format.
This may be used to represent property values in Versit objects.
| const Versit::TVersitCharSet aCharSet | The default character set. |
| IMPORT_C void | SetDefaultCharSetId | ( | TUint | aCharSetId | ) |
Sets the default character set or transformation format.
This may be used to represent property values in Versit objects.
| TUint aCharSetId | The UID for the character set. These are defined in charconv.h. |
| IMPORT_C void | SetDefaultEncoding | ( | const Versit::TVersitEncoding | aEncoding | ) |
Sets the parser's default encoding to aEncoding.
| const Versit::TVersitEncoding aEncoding | An encoding. Cannot be 8-bit. |
| IMPORT_C void | SetEntityNameL | ( | const TDesC & | aEntityName | ) |
Sets the name for the current entity to one of: VCARD, VCALENDAR, VEVENT or VTODO.
| const TDesC & aEntityName | The new name for the current parser entity. Any existing name is first deleted. |
| IMPORT_C void | SetLineCharacterSet | ( | Versit::TVersitCharSet | aLineCharSet | ) | [protected] |
| Versit::TVersitCharSet aLineCharSet |
| IMPORT_C void | SetLineCharacterSetId | ( | TUint | aLineCharSetId | ) | [protected] |
| TUint aLineCharSetId |
| IMPORT_C void | SetLineCoding | ( | Versit::TVersitCharSet | aLineCharSet, |
| Versit::TVersitEncoding | aLineEncoding | |||
| ) | [protected] | |||
| Versit::TVersitCharSet aLineCharSet | |
| Versit::TVersitEncoding aLineEncoding |
| IMPORT_C void | SetLineEncoding | ( | Versit::TVersitEncoding | aLineEncoding | ) | [protected] |
| Versit::TVersitEncoding aLineEncoding |
| IMPORT_C void | SetLineEncoding | ( | TUint | aVersitEncodingUid | ) | [protected] |
| TUint aVersitEncodingUid |
| void | SetObserver | ( | MVersitObserver * | aObserver | ) | [inline] |
Sets the Versit observer.
| MVersitObserver * aObserver | A pointer to the observer. |
| void | SetPlugIn | ( | MVersitPlugIn * | aPlugIn | ) | [inline] |
Sets the Versit plug-in.
If there is one, the Versit plug-in needs to be set before any properties are added to the parser. This is done for you when internalising (using InternalizeL()) or adding properties (using AddPropertyL()).
| MVersitPlugIn * aPlugIn | A pointer to the plug in. |
| IMPORT_C TInt | Val | ( | const TDesC & | aString, |
| TInt & | aNumber | |||
| ) | [static] | |||
Converts a string into an integer, for example, it converts "438" to 438.
White space character codes: used while analysing the syntax of the received data and while externalising data.
| ESpace = ' ' |
' ' |
| EHTab = 9 |
9 |
| ELineFeed = 10 |
10 |
| ECarriageReturn = 13 |
13 |
| EColon = ':' |
':' |
Flags that can be specified on construction.
| ENoVersionProperty = 0 |
This entity does not need a version property. |
| ESupportsVersion = 0x01 |
This entity should have a version property. |
| EImportSyncML = 0x1000 | |
| EUseAutoDetection = 0x4000 |
Indicates whether the parser should use auto-detection of character sets when one has not been explicitly specified. |
| ECharSetIdentified = 0x8000 |
The current property has specified a character set. |
| EUseDefaultCharSetForAllProperties = 0x2000 |
If the charset is not explicitly specified, the default charset will be used instead of US-ASCII as required by the Versit specification . |
| CArrayPtr< CVersitParser > * | iArrayOfEntities | [protected] |
| CArrayPtr< CParserProperty > * | iArrayOfProperties | [protected] |
| const CArrayFix< CCnvCharacterSetConverter::SCharacterSet > * | iAutoDetectCharSets | [protected] |
| TParserCodingDetails | iCurrentPropertyCodingDetails | [protected] |
| TBuf< KVersitMaxVersionLength > | iDefaultVersion | [protected] |
Copyright ©2010 Nokia Corporation and/or its subsidiary(-ies).
All rights
reserved. Unless otherwise stated, these materials are provided under the terms of the Eclipse Public License
v1.0.