--- a/epoc32/include/vtoken.h Tue Nov 24 13:55:44 2009 +0000
+++ b/epoc32/include/vtoken.h Tue Mar 16 16:12:26 2010 +0000
@@ -1,1 +1,366 @@
-vtoken.h
+// Copyright (c) 1997-2009 Nokia Corporation and/or its subsidiary(-ies).
+// All rights reserved.
+// This component and the accompanying materials are made available
+// under the terms of the License "Symbian Foundation License v1.0" to Symbian Foundation members and "Symbian Foundation End User License Agreement v1.0" to non-members
+// which accompanies this distribution, and is available
+// at the URL "http://www.symbianfoundation.org/legal/licencesv10.html".
+//
+// Initial Contributors:
+// Nokia Corporation - initial contribution.
+//
+// Contributors:
+//
+// Description:
+//
+
+
+
+/**
+ @file
+ @publishedAll
+ @released
+*/
+
+#ifndef __VTOKEN_H__
+#define __VTOKEN_H__
+
+#include <e32base.h>
+
+#define KMaxExternalizedTokenLength 70
+#define KMinLineLengthToWriteTo 1
+
+/** A colon string. */
+_LIT8(KVersitTokenColon, ":");
+/** A Unicode colon string. */
+_LIT(KVersitTokenColonUnicode, ":");
+/** A semi-colon string. */
+_LIT8(KVersitTokenSemiColon, ";");
+/** A Unicode semi-colon string. */
+_LIT(KVersitTokenSemiColonUnicode, ";");
+/** A backslash string (escaped). */
+_LIT8(KVersitBackSlash, "\\");
+/** An escaped semi-colon string. */
+_LIT8(KVersitEscapedSemiColon, "\\;");
+/** An escaped Unicode semi-colon string. */
+_LIT(KVersitEscapedSemiColonUnicode, "\\;");
+/** An equals sign string. */
+_LIT8(KVersitTokenEquals, "=");
+/** A full stop string. */
+_LIT8(KVersitTokenPeriod, ".");
+/** A space string. */
+_LIT8(KVersitTokenSpace, " ");
+/** A minus sign string. */
+_LIT8(KVersitTokenMinus, "-");
+/** A plus sign string. */
+_LIT8(KVersitTokenPlus, "+");
+/** A line break string. */
+_LIT8(KVersitLineBreak, "\r\n ");
+/** The string used at the start of a time interval string. */
+_LIT8(KVersitTimePeriodBegin, "P");
+/** The string appended to the number of years when encoding a time interval. */
+_LIT8(KVersitTimePeriodYear, "Y");
+/** The string appended to the number of months when encoding a time interval. */
+_LIT8(KVersitTimePeriodMonth, "M");
+/** Not used. */
+_LIT8(KVersitTimePeriodWeek, "W"); //unused
+/** The string appended to the number of days when encoding a time interval. */
+_LIT8(KVersitTimePeriodDay, "D");
+/** The string added before the time of day when encoding a Versit date/time.
+
+Also the string added before the time of day when encoding a time interval. */
+_LIT8(KVersitTimePeriodTime, "T");
+/** The string appended to the hour value when encoding a time interval. */
+_LIT8(KVersitTimePeriodHour, "H");
+/** The string appended to the minutes value when encoding a time interval. */
+_LIT8(KVersitTimePeriodMinute, "M");
+/** The string appended to the seconds value when encoding a time interval. */
+_LIT8(KVersitTimePeriodSecond, "S");
+/** The string appended to a date/time when encoding a Versit
+date/time, if the value is in universal time. */
+_LIT8(KVersitTokenUniversalTime, "Z");
+
+/** A colon character. */
+const TUint KVersitTokenColonVal =':';
+/** A semi-colon character. */
+const TUint KVersitTokenSemiColonVal =';';
+/** A backslash character. */
+const TUint KVersitTokenBackslashVal ='\\';
+/** An equals sign character. */
+const TUint KVersitTokenEqualsVal ='=';
+/** A full stop character. */
+const TUint KVersitTokenPeriodVal ='.';
+/** A comma character. */
+const TUint KVersitTokenCommaVal =',';
+/** A left square bracket character. */
+const TUint KVersitTokenLSquareBracketVal ='[';
+/** A right square bracket character. */
+const TUint KVersitTokenRSquareBracketVal =']';
+/** A minus sign character. */
+const TUint KVersitTokenMinusVal ='-';
+/** A plus sign character. */
+const TUint KVersitTokenPlusVal ='+';
+/** A Yen character: the escape character for the 'ShiftJis' character set. */
+const TUint KVersitTokenYenVal =0xa5;
+/** The character at the beginning of a time interval string. */
+const TUint KVersitTimePeriodBeginVal ='P';
+/** The character following the number of years in a time interval string. */
+const TUint KVersitTimePeriodYearVal ='Y';
+/** The character following the number of months in a time interval string. */
+const TUint KVersitTimePeriodMonthVal ='M';
+/** The character following the number of weeks in a time interval string. */
+const TUint KVersitTimePeriodWeekVal ='W';
+/** The character following the number of days in a time interval string. */
+const TUint KVersitTimePeriodDayVal ='D';
+/** The character preceding a length of day (hours,minutes and seconds) in a time
+interval string.
+
+Also the character preceding the time of day in a date/time string. */
+const TUint KVersitTimePeriodTimeVal ='T';
+/** The character following the number of hours in a time interval string. */
+const TUint KVersitTimePeriodHourVal ='H';
+/** The character following the number of minutes in a time interval string. */
+const TUint KVersitTimePeriodMinuteVal ='M';
+/** The character following the number of seconds in a time interval string. */
+const TUint KVersitTimePeriodSecondVal ='S';
+/** The character at the end of a universal date/time string. */
+const TUint KVersitTokenUniversalTimeVal ='Z';
+/** The character at the start of a daily recurring entity string. */
+const TUint KVersitRecurrenceDailyVal ='D';
+/** The character at the start of a weekly recurring entity string. */
+const TUint KVersitRecurrenceWeeklyVal ='W';
+/** The character which precedes the number of recurrences, when specified, in
+a recurring entity. */
+const TUint KVersitRecurrenceNumberOfVal ='#';
+/** The string at the beginning of a 'monthly by position' recurring entity
+(see CVersitRecurrenceMonthlyByPos). Used when internalising. */
+_LIT(KVersitRecurrenceMonthlyByPos, "MP");
+/** Not used. */
+_LIT(KVersitRecurrenceMonthlyByDay, "MD");
+/** Not used. */
+_LIT(KVersitRecurrenceYearlyByMonth, "YM");
+/** The string at the beginning of a 'yearly by day' recurring entity,
+(see CVersitRecurrenceYearlyByDay). Used when internalising. */
+_LIT(KVersitRecurrenceYearlyByDay, "YD");
+/** A string in the date list (if a date list is defined) of an entity
+that recurs either weekly or 'monthly by position' on Mondays. Used when
+internalising. */
+_LIT(KVersitRecurrenceMonday, "MO");
+/** A string in the date list (if a date list is defined) of an entity
+that recurs either weekly or 'monthly by position' on Tuesdays. Used when internalising. */
+_LIT(KVersitRecurrenceTuesday, "TU");
+/** A string in the date list (if a date list is defined) of an entity
+that recurs either weekly or 'monthly by position' on Wednesdays. Used when internalising. */
+_LIT(KVersitRecurrenceWednesday, "WE");
+/** A string in the date list (if a date list is defined) of an entity that
+recurs either weekly or 'monthly by position' on Thursdays. Used when internalising. */
+_LIT(KVersitRecurrenceThursday, "TH");
+/** A string in the date list (if a date list is defined) of an entity that
+recurs either weekly or 'monthly by position' on Fridays. Used when internalising. */
+_LIT(KVersitRecurrenceFriday, "FR");
+/** A string in the date list (if a date list is defined) of an entity that
+recurs either weekly or 'monthly by position' on Saturdays. Used when internalising. */
+_LIT(KVersitRecurrenceSaturday, "SA");
+/** A string in the date list (if a date list is defined) of an entity that
+recurs either weekly or 'monthly by position' on Sundays. Used when internalising. */
+_LIT(KVersitRecurrenceSunday, "SU");
+/** The string appended to the 'occurrence list' section of an entity that
+recurs on the last day of the month. Used when internalising. */
+_LIT(KVersitRecurrenceLastDay, "LD");
+
+/** The string used at the start of a daily recurring entity. */
+_LIT8(KVersitRecurrenceDaily, "D");
+/** The string used at the start of a weekly recurring entity. */
+_LIT8(KVersitRecurrenceWeekly, "W");
+/** The string appended just before the number of occurrences, when encoding a recurring
+entity as a descriptor. */
+_LIT8(KVersitRecurrenceNumberOf, "#");
+/** The string used at the start of a 'monthly by position' recurring entity,
+(see CVersitRecurrenceMonthlyByPos). Used when externalising. */
+_LIT8(KVersitRecurrenceMonthlyByPos8, "MP");
+/** Not used. */
+_LIT8(KVersitRecurrenceMonthlyByDay8, "MD");
+/** Not used. */
+_LIT8(KVersitRecurrenceYearlyByMonth8, "YM");
+/** The string used at the start of a 'yearly by day' recurring entity,
+(see CVersitRecurrenceYearlyByDay). Used when externalising. */
+_LIT8(KVersitRecurrenceYearlyByDay8, "YD");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Mondays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceMonday8, "MO");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Tuesdays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceTuesday8, "TU");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Wednesdays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceWednesday8, "WE");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Thursdays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceThursday8, "TH");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Fridays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceFriday8, "FR");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Saturdays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceSaturday8, "SA");
+/** The string appended to the 'occurrence list' section of an entity that recurs on Sundays.
+Used when externalising. */
+_LIT8(KVersitRecurrenceSunday8, "SU");
+/** The string appended to the 'occurrence list' section of an entity that recurs on the last day of
+the month. Used when externalising. */
+_LIT8(KVersitRecurrenceLastDay8, "LD");
+/** The string at the start of an entity encoded in a stream.
+
+This is implemented as the name of a property, but this property is not stored in the entity's array
+of properties. */
+_LIT8(KVersitTokenBEGIN, "BEGIN");
+/** The string at the start of an agent vCard entity encoded in a stream.
+
+The reason for needing a Unicode version, is that the agent vCard is held in a
+property value in the parent vCard, and all property values are converted
+to Unicode when they are internalised, in order to make them character set-independent.
+
+This is implemented as the name of a property, but this property is not stored in the
+entity's array of properties. */
+_LIT(KVersitVarTokenBEGIN, "BEGIN");
+/** The string which follows the body of data of a vCard/vCalendar encoded in a stream.
+It is followed only by the entity name.
+
+This is implemented as the name of a property, but this property is not stored in the
+entity's array of properties. */
+_LIT8(KVersitTokenEND, "END");
+/** A carriage return and line feed */
+_LIT8(KVersitTokenCRLF, "\r\n"); // carriage return, line feed
+/** A boolean true value. Not used. */
+_LIT8(KVersitTokenTRUE, "TRUE");
+/** A boolean true value. */
+_LIT(KVersitVarTokenTRUE, "TRUE");
+/** A boolean false value. Not used. */
+_LIT8(KVersitTokenFALSE, "FALSE");
+/** A boolean false value. */
+_LIT(KVersitVarTokenFALSE, "FALSE");
+/** The symbol added to the beginning of an unrecognised property name while
+internalising from a stream. */
+_LIT8(KVersitTokenXDashEPOC, "X-EPOC");
+_LIT8(KVersitTokenXDash, "X-");
+/** An empty string. */
+_LIT8(KVersitTokenEmptyNarrow, "");
+/** An empty string. */
+_LIT(KVersitTokenEmpty, "");
+
+//The following names should not be used, versit now uses CharConv character set names.
+// params
+_LIT8(KVersitTokenENCODING, "ENCODING");
+_LIT8(KVersitTokenBASE64, "BASE64");
+_LIT8(KVersitTokenQUOTEDPRINTABLE, "QUOTED-PRINTABLE");
+_LIT8(KVersitToken8BIT, "8-BIT");
+_LIT8(KVersitTokenCHARSET, "CHARSET");
+_LIT8(KVersitTokenUTF8, "UTF-8");
+_LIT8(KVersitTokenUTF7, "UTF-7");
+_LIT8(KVersitTokenISO1, "ISO-8859-1");
+_LIT8(KVersitTokenISO2, "ISO-8859-2");
+_LIT8(KVersitTokenISO4, "ISO-8859-4");
+_LIT8(KVersitTokenISO5, "ISO-8859-5");
+_LIT8(KVersitTokenISO7, "ISO-8859-7");
+_LIT8(KVersitTokenISO9, "ISO-8859-9");
+_LIT8(KVersitTokenTYPE, "TYPE"); //used for photo format type
+
+// parameters for the X-EPOCALARM
+_LIT8(KVersitTokenVALUE, "VALUE");
+_LIT8(KVersitTokenCONTENTTYPE, "X-CONTENTTYPE");
+_LIT8(KVersitTokenINLINE, "INLINE");
+_LIT8(KVersitTokenBINARY, "BINARY");
+
+// additional character sets
+_LIT8(KVersitTokenISO3, "ISO-8859-3");
+_LIT8(KVersitTokenISO10, "ISO-8859-10");
+_LIT8(KVersitTokenShiftJIS, "SHIFT_JIS");
+_LIT8(KVersitTokenGB2312, "GB 2312-80"); //This and the following contain the wrong name.
+_LIT8(KVersitTokenGBK, "GBK");
+_LIT8(KVersitTokenBIG5, "BIG5 level 1 and 2");
+_LIT8(KVersitTokenISO2022JP, "ISO 2022-JP");
+_LIT8(KVersitTokenEUCJP, "EUC-JP");
+_LIT8(KVersitTokenJIS, "JIS");
+
+
+// entities
+_LIT8(KVersitTokenVCALENDAR, "VCALENDAR");
+_LIT8(KVersitTokenVCARD, "VCARD");
+_LIT(KVersitVarTokenVCALENDAR, "VCALENDAR");
+_LIT(KVersitVarTokenVCARD, "VCARD");
+_LIT(KVersitVarTokenVEVENT, "VEVENT");
+_LIT(KVersitVarTokenVTODO, "VTODO");
+
+// properties
+_LIT8(KVersitTokenXALARM, "X-EPOCALARM");
+_LIT8(KVersitTokenAALARM, "AALARM");
+_LIT8(KVersitTokenDALARM, "DALARM");
+_LIT8(KVersitTokenPALARM, "PALARM");
+_LIT8(KVersitTokenMALARM, "MALARM");
+_LIT8(KVersitTokenDAYLIGHT, "DAYLIGHT");
+_LIT(KVersitVarTokenDAYLIGHT, "DAYLIGHT");
+_LIT8(KVersitTokenVERSION, "VERSION");
+_LIT8(KVersitTokenCATEGORIES, "CATEGORIES");
+_LIT8(KVersitTokenRESOURCES, "RESOURCES");
+_LIT8(KVersitTokenDCREATED, "DCREATED");
+_LIT8(KVersitTokenDTSTART, "DTSTART");
+_LIT8(KVersitTokenDTEND, "DTEND");
+_LIT8(KVersitTokenLASTMODIFIED, "LAST-MODIFIED");
+_LIT8(KVersitTokenCOMPLETED, "COMPLETED");
+_LIT8(KVersitTokenDUE, "DUE");
+_LIT8(KVersitTokenEXDATE, "EXDATE");
+_LIT8(KVersitTokenEXRULE, "EXRULE");
+_LIT8(KVersitTokenRDATE, "RDATE");
+_LIT8(KVersitTokenRRULE, "RRULE");
+_LIT8(KVersitTokenRNUM, "RNUM");
+_LIT8(KVersitTokenPRIORITY, "PRIORITY");
+_LIT8(KVersitTokenSEQUENCE, "SEQUENCE");
+_LIT8(KVersitTokenTRANSP, "TRANSP");
+_LIT8(KVersitTokenBDAY, "BDAY");
+_LIT8(KVersitTokenAGENT, "AGENT");
+_LIT8(KVersitTokenLABEL, "LABEL");
+_LIT8(KVersitTokenPHOTO, "PHOTO");
+_LIT8(KVersitTokenEMAIL, "EMAIL");
+_LIT8(KVersitTokenINTERNET, "INTERNET");
+_LIT8(KVersitTokenTITLE, "TITLE");
+_LIT8(KVersitTokenROLE, "ROLE");
+_LIT8(KVersitTokenLOGO, "LOGO");
+_LIT8(KVersitTokenNOTE, "NOTE");
+_LIT8(KVersitTokenSOUND, "SOUND");
+_LIT8(KVersitTokenMAILER, "MAILER");
+_LIT8(KVersitTokenPRODID, "PRODID");
+_LIT8(KVersitTokenATTACH, "ATTACH");
+_LIT8(KVersitTokenATTENDEE, "ATTENDEE");
+_LIT8(KVersitTokenCLASS, "CLASS");
+_LIT8(KVersitTokenDESCRIPTION, "DESCRIPTION");
+_LIT8(KVersitTokenLOCATION, "LOCATION");
+_LIT8(KVersitTokenRELATEDTO, "RELATED-TO");
+_LIT8(KVersitTokenSTATUS, "STATUS");
+_LIT8(KVersitTokenSUMMARY, "SUMMARY");
+_LIT8(KVersitTokenN, "N");
+_LIT8(KVersitTokenTZ, "TZ");
+_LIT8(KVersitTokenADR, "ADR");
+_LIT8(KVersitTokenORG, "ORG");
+_LIT8(KVersitTokenREV, "REV");
+_LIT8(KVersitTokenFN, "FN");
+_LIT8(KVersitTokenTEL, "TEL");
+_LIT8(KVersitTokenURL, "URL");
+_LIT8(KVersitTokenGEO, "GEO");
+_LIT8(KVersitTokenUID, "UID");
+_LIT8(KVersitTokenKEY, "KEY");
+_LIT8(KVersitTokenSECONDNAME, "X-EPOCSECONDNAME");
+_LIT8(KVersitTokenXMETHOD, "X-METHOD"); // For Group Scheduling
+_LIT8(KVersitTokenXRECURRENCEID, "X-RECURRENCE-ID"); // For Group Scheduling
+_LIT8(KVersitTokenXLOCALUID, "X-SYMBIAN-LUID");
+_LIT8(KVersitTokenXDTSTAMP, "X-SYMBIAN-DTSTAMP");
+_LIT(KVersitVarTokenINTERNET, "INTERNET"); //Used by Jave Phone and not by versit
+_LIT8(KVersitTokenAssistant, "X-ASSISTANT");
+_LIT8(KVersitTokenAssistantTel, "X-ASSISTANT-TEL");
+_LIT8(KVersitTokenAnniversary, "X-ANNIVERSARY");
+_LIT8(KVersitTokenSpouse, "X-SPOUSE");
+_LIT8(KVersitTokenChildren, "X-CHILDREN");
+_LIT8(KVersitTokenClass, "X-CLASS");
+_LIT8(KVersitAttachLabel, "X-NAME");
+_LIT8(KVersitAttachMimeType, "X-FMTTYPE");
+_LIT8(KVersitXUserIntType, "X-SYMBIAN-USERINT");
+
+#endif