EPOC   SDK Home Glossary Indexes Previous Next Up

CParserVCard class


Contents


CParserVCard class — vCard parser

Section Contents


Overview

Compatibility

Applications that use this class will not work correctly on a version of EPOC earlier than ER5.

Derivation

CBase

Abstract: CBase behaviour.

CVersitParser

Generic parser base class.

Defined in

vcard.h

Link against

versit.lib

Description

This class encapsulates a vCard parser. In addition to the functions inherited from CVersitParser, it provides support for property groups and agents.


Construction


CParserVCard() — Trivial default C++ constructor

CParserVCard();

Description

The default C++ constructor constructs a vCard parser.


Stream persistence


ExternalizeL() — Externalize to a stream

void ExternalizeL(RWriteStream& aStream);

Description

Use this function to externalize a vCard entity to a write stream. The presence of this function means that the standard templated operator<<() (defined in s32strm.h) is available to externalize objects of this class. The entity name is set to vCard.

Arguments

RWriteStream& aStream

Stream to which the vCard entity should be externalized.


InternalizeL() — Internalize from a stream

void InternalizeL(RReadStream& aStream);

Description

Use this function to internalize a vCard entity from a read stream. The presence of this function means that the standard templated operator>>() (defined in s32strm.h) is available to internalize objects of this class.

As part of the process, all date/time property values contained in the vCard entity are converted into machine local date/time values.

Arguments

RReadStream& aStream

Stream from which the vCard entity should be internalized.


Properties


ConvertAllPropertyDateTimesToMachineLocalL() — Convert all date/time property values to machine local

void ConvertAllPropertyDateTimesToMachineLocalL(const TTimeIntervalSeconds& aIncrement,const CVersitDaylight* aDaylight);

Description

This function calls the overridden base class function. Additionally, this function converts all date/time values contained in any agent properties within the vCard to machine local date/times.

Arguments

const TTimeIntervalSeconds& aIncrement

A time interval in seconds to add to the date/time.

const CVersitDaylight* aDaylight

The specification for daylight saving. If a date/time value is within the period for daylight saving, the date/time is modified by the daylight saving offset.


GroupOfPropertiesL() — Get property group

CArrayPtr<CParserProperty>* GroupOfPropertiesL(const TDesC& aGroupName) const;

Description

The function retrieves the named property group from the vCard entity.

Arguments

const TDesC& aGroupName

The name of the property group of interest.

Return value

CArrayPtr<CParserProperty>*

Array of pointers to the properties contained in the named group. NULL if no matching property group was found.

EPOC       SDK Home Glossary Indexes Previous Next Up