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

Frees all resources owned by the object, prior to its destruction.

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() .

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.

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.

Gets the current entity's array of properties.

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.

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

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.

Converts text in a non-Unicode character set into Unicode (UCS-2).

Gets the default character set or transformation format. This may be used to represent property values in Versit objects.

Gets the default character set or transformation format.

This may be used to represent property values in Versit objects.

Gets the parser's default encoding.

This value is initialised on construction, to ENoEncoding.

Gets all sub-entities in the current entity, whose name matches the name specified.

Gets the current entity's name.

If no name has been set, returns an empty descriptor.

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 .

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.

Sets up a pointer to the remaining field. Sets the original remaining field pointers length to 0.

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

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.

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.

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)

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)

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.

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.

Instantiates and gives ownership of a CParserPropertyValueHBufC object.

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.

Gets a pointer to the Versit observer.

Gets a pointer to the Versit plug-in.

Gets all properties in the current entity's array of properties whose name and value match the name and value specified.

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.

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.

Destroys an array of Versit dates and times.

Destroys an array of entities.

Destroys an array of parameters.

Destroys an array of properties.

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.

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.

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.

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.

Sets the default character set or transformation format.

This may be used to represent property values in Versit objects.

Sets the default character set or transformation format.

This may be used to represent property values in Versit objects.

Sets the parser's default encoding to aEncoding.

Sets the name for the current entity to one of: VCARD, VCALENDAR, VEVENT or VTODO.

Sets the Versit observer.

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() ).

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.

Flags that can be specified on construction.