CParserVCard Class Reference

class CParserVCard : public CVersitParser

A vCard parser.

Adds support for property groups (see CParserGroupedProperty) and agents (see CParserPropertyValueAgent) to the functionality of CVersitParser.

Provides a constructor and overrides CVersitParser::InternalizeL(), ExternalizeL(), RecognizeToken(), ConvertAllPropertyDateTimesToMachineLocalL(), ParsePropertyL() and MakePropertyValueL().

The vCard data is read from or written to a stream or file, using the InternalizeL() and ExternalizeL() functions. Most users of this class will only need to use these functions.

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 information.

Inherits from

CParserVCard
- CVersitParser
  - CBase

Public Member Functions
IMPORT_C void	ConvertAllPropertyDateTimesToMachineLocalL(const TTimeIntervalSeconds &, const CVersitDaylight *)
IMPORT_C void	ConvertDateTimesToMachineLocalAndDeleteTZL()
IMPORT_C void	ExternalizeL(RWriteStream &)
IMPORT_C CArrayPtr< CParserProperty > *	GroupOfPropertiesL(const TDesC8 &)
IMPORT_C void	InternalizeL(RReadStream &)
IMPORT_C CParserVCard *	NewL()
CParserVCard *	NewL(TBool)
IMPORT_C TUid	RecognizeToken(const TDesC8 &)

Protected Member Functions
	CParserVCard()
	CParserVCard(TBool)
IMPORT_C CDesC8Array *	GetGroupNamesL(TPtr8 &)
IMPORT_C CParserPropertyValue *	MakePropertyValueAgentL(TPtr16)
IMPORT_C CParserPropertyValue *	MakePropertyValueL(const TUid &, HBufC16 *&)
IMPORT_C CParserPropertyValue *	MakePropertyValueSoundL(HBufC16 *&)
IMPORT_C void	ParsePropertyL()

Private Member Functions
IMPORT_C void	Reserved1()
IMPORT_C void	Reserved2()

Inherited Functions
	CBase::CBase()
	CBase::Delete(CBase *)
	CBase::Extension_(TUint,TAny &,TAny )
	CBase::operator new(TUint)
	CBase::operator new(TUint,TAny *)
	CBase::operator new(TUint,TLeave)
	CBase::operator new(TUint,TLeave,TUint)
	CBase::operator new(TUint,TUint)
	CBase::~CBase()
	CVersitParser::AddEntityL(CVersitParser *)
	CVersitParser::AddPropertyL(CParserProperty *,TBool)
	CVersitParser::AdjustAllPropertyDateTimesToMachineLocalL()
	CVersitParser::AnalysesEncodingCharset(CArrayPtr< CParserParam > *)
	CVersitParser::AppendBeginL()
	CVersitParser::AppendEndL()
	CVersitParser::AppendEntityNameL()
	CVersitParser::ArrayOfEntities(TBool)
	CVersitParser::ArrayOfProperties(TBool)
	CVersitParser::BufPtr()
	CVersitParser::CVersitParser(TUint)
	CVersitParser::ClearSupportsVersion()
	CVersitParser::ConstructL()
	CVersitParser::ConvertFromUnicodeToISOL(TDes8 &,const TDesC16 &,CCnvCharacterSetConverter *)
	CVersitParser::ConvertToUnicodeFromISOL(TDes16 &,const TDesC8 &,TUint)
	CVersitParser::ConvertToUnicodeL(const TDesC8 &)
	CVersitParser::DecodeDateTimeL(TDes &)const
	CVersitParser::DecodePropertyValueL(const TDesC8 &)
	CVersitParser::DecodePropertyValueL(const TDesC8 &,const TUid &)
	CVersitParser::DecodeTimePeriodL(const TDesC &)const
	CVersitParser::DecodeTimeZoneL(const TDesC &)const
	CVersitParser::DefaultCharSet()const
	CVersitParser::DefaultCharSetId()const
	CVersitParser::DefaultEncoding()const
	CVersitParser::DoAddPropertyL(CParserProperty *)
	CVersitParser::EntityL(const TDesC &,TBool)
	CVersitParser::EntityName()const
	CVersitParser::ExternalizeL(RFile &)
	CVersitParser::FindFirstField(TPtr16 &,TPtr16 &,TBool)
	CVersitParser::FindRemainingField(TPtr16 &,TPtr16 &)
	CVersitParser::GetNumberL(const TDesC &,TInt &)const
	CVersitParser::GetPropertyParamsLC(TPtr8)
	CVersitParser::InternalizeL(HBufC ,CLineReader )
	CVersitParser::InternalizeL(RFile &,TInt &)
	CVersitParser::IsPunctuationToken(TUint)
	CVersitParser::IsValidLabel(const TDesC &,TInt &)
	CVersitParser::IsValidParameterValue(TInt &,const TDesC &)
	CVersitParser::LineCharSet()const
	CVersitParser::LineCharSetId()const
	CVersitParser::LineEncoding()const
	CVersitParser::LineEncodingId()const
	CVersitParser::LoadBinaryValuesFromFilesL()
	CVersitParser::LoadBinaryValuesFromFilesL(RFs &)
	CVersitParser::MakeDefaultPropertyValueL(HBufC16 *&)
	CVersitParser::MakeEntityL(TInt,HBufC *)
	CVersitParser::MakePropertyL(TPtr8 &,TInt)
	CVersitParser::MakePropertyValueCDesCArrayL(TPtr16)
	CVersitParser::MakePropertyValueDaylightL(TPtr16)
	CVersitParser::MakePropertyValueMultiDateTimeL(TPtr16)
	CVersitParser::MapVersitCharsetToCharConvCharset(Versit::TVersitCharSet)
	CVersitParser::MapVersitEncodingToConArcUid(Versit::TVersitEncoding)
	CVersitParser::Observer()
	CVersitParser::ParseBeginL()
	CVersitParser::ParseEndL()
	CVersitParser::ParseEndL(HBufC16 &)
	CVersitParser::ParseEntityL()
	CVersitParser::ParseParamL(CArrayPtr< CParserParam > *,TPtr8)
	CVersitParser::ParsePropertiesL()
	CVersitParser::PlugIn()
	CVersitParser::PropertyL(const TDesC8 &,const TUid &,TBool)const
	CVersitParser::ReadLineAndDecodeParamsLC(TInt &,TInt &)
	CVersitParser::ReadMultiLineValueL(TPtr8 &,TInt,TBool)
	CVersitParser::RecognizeEntityName()const
	CVersitParser::ResetAndDestroyArrayOfDateTimes(TAny *)
	CVersitParser::ResetAndDestroyArrayOfEntities(TAny *)
	CVersitParser::ResetAndDestroyArrayOfParams(TAny *)
	CVersitParser::ResetAndDestroyArrayOfProperties(TAny *)
	CVersitParser::RestoreLineCodingDetailsToDefault()
	CVersitParser::SaveBinaryValuesToFilesL(TInt,const TDesC &)
	CVersitParser::SaveBinaryValuesToFilesL(TInt,const TDesC &,RFs &)
	CVersitParser::SetAutoDetect(TBool,const CArrayFix< CCnvCharacterSetConverter::SCharacterSet > *)
	CVersitParser::SetCharacterConverter(Versit::TEncodingAndCharset &)
	CVersitParser::SetDefaultCharSet(const Versit::TVersitCharSet)
	CVersitParser::SetDefaultCharSetId(TUint)
	CVersitParser::SetDefaultEncoding(const Versit::TVersitEncoding)
	CVersitParser::SetEntityNameL(const TDesC &)
	CVersitParser::SetFlags(TUint)
	CVersitParser::SetLineCharacterSet(Versit::TVersitCharSet)
	CVersitParser::SetLineCharacterSetId(TUint)
	CVersitParser::SetLineCoding(Versit::TVersitCharSet,Versit::TVersitEncoding)
	CVersitParser::SetLineEncoding(TUint)
	CVersitParser::SetLineEncoding(Versit::TVersitEncoding)
	CVersitParser::SetObserver(MVersitObserver *)
	CVersitParser::SetPlugIn(MVersitPlugIn *)
	CVersitParser::SetSupportsVersion()
	CVersitParser::SupportsVersion()const
	CVersitParser::UnicodeUtils()
	CVersitParser::Val(const TDesC &,TInt &)
	CVersitParser::~CVersitParser()

Inherited Enumerations
	CVersitParser:TCharCodes
	CVersitParser:TVersitParserFlags

Private Attributes
TBool	iParsingAgent

Inherited Attributes
	CVersitParser::iArrayOfEntities
	CVersitParser::iArrayOfProperties
	CVersitParser::iAutoDetectCharSets
	CVersitParser::iCurrentProperty
	CVersitParser::iCurrentPropertyCodingDetails
	CVersitParser::iDecodedValue
	CVersitParser::iDefaultCodingDetails
	CVersitParser::iDefaultVersion
	CVersitParser::iEntityName
	CVersitParser::iFlags
	CVersitParser::iLargeDataBuf
	CVersitParser::iLineReader
	CVersitParser::iObserver
	CVersitParser::iOwnedLineReader
	CVersitParser::iPlugIn
	CVersitParser::iStaticUtils
	CVersitParser::iWriteStream

Constructor & Destructor Documentation

CParserVCard()

CParserVCard

(

)

[protected]

CParserVCard(TBool)

CParserVCard

(

TBool

aParsingAgent

)

[protected]

Parameters

TBool aParsingAgent

Member Functions Documentation

ConvertAllPropertyDateTimesToMachineLocalL(const TTimeIntervalSeconds &, const CVersitDaylight *)

IMPORT_C void	ConvertAllPropertyDateTimesToMachineLocalL	(	const TTimeIntervalSeconds &	aIncrement,
			const CVersitDaylight *	aDaylight
		)	[virtual]

Parameters

const TTimeIntervalSeconds & aIncrement
const CVersitDaylight * aDaylight

ConvertDateTimesToMachineLocalAndDeleteTZL()

IMPORT_C void

ConvertDateTimesToMachineLocalAndDeleteTZL

(

)

ExternalizeL(RWriteStream &)

IMPORT_C void

ExternalizeL

(

RWriteStream &

aStream

)

[virtual]

Parameters

RWriteStream & aStream

GetGroupNamesL(TPtr8 &)

IMPORT_C CDesC8Array *

GetGroupNamesL

(

TPtr8 &

aGroupsAndName

)

[protected]

Parameters

TPtr8 & aGroupsAndName

GroupOfPropertiesL(const TDesC8 &)

IMPORT_C CArrayPtr< CParserProperty > *

GroupOfPropertiesL

(

const TDesC8 &

aName

)

const

Parameters

const TDesC8 & aName

InternalizeL(RReadStream &)

IMPORT_C void

InternalizeL

(

RReadStream &

aStream

)

[virtual]

Parameters

RReadStream & aStream

MakePropertyValueAgentL(TPtr16)

IMPORT_C CParserPropertyValue *

MakePropertyValueAgentL

(

TPtr16

aValue

)

[protected, virtual]

Parameters

TPtr16 aValue

MakePropertyValueL(const TUid &, HBufC16 *&)

IMPORT_C CParserPropertyValue *	MakePropertyValueL	(	const TUid &	aPropertyUid,
			HBufC16 *&	aValue
		)	[protected, virtual]

Parameters

const TUid & aPropertyUid
HBufC16 *& aValue

MakePropertyValueSoundL(HBufC16 *&)

IMPORT_C CParserPropertyValue *

MakePropertyValueSoundL

(

HBufC16 *&

aValue

)

[protected]

Parameters

HBufC16 *& aValue

NewL()

IMPORT_C CParserVCard *

NewL

(

)

[static]

NewL(TBool)

CParserVCard *

NewL

(

TBool

aParsingAgent

)

[static]

Parameters

TBool aParsingAgent

ParsePropertyL()

IMPORT_C void

ParsePropertyL

(

)

[protected, virtual]

RecognizeToken(const TDesC8 &)

IMPORT_C TUid

RecognizeToken

(

const TDesC8 &

aToken

)

const [virtual]

Parameters

const TDesC8 & aToken

Reserved1()

IMPORT_C void

Reserved1

(

)

[private, virtual]

Reserved2()

IMPORT_C void

Reserved2

(

)

[private, virtual]

Member Data Documentation

TBool iParsingAgent

TBool

iParsingAgent

[private]