--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/epoc32/include/app/VPbkUtils.h	Wed Mar 31 12:33:34 2010 +0100
@@ -0,0 +1,108 @@
+/*
+* Copyright (c) 2005-2007 Nokia Corporation and/or its subsidiary(-ies).
+* All rights reserved.
+* This component and the accompanying materials are made available
+* under the terms of "Eclipse Public License v1.0"
+* which accompanies this distribution, and is available
+* at the URL "http://www.eclipse.org/legal/epl-v10.html".
+*
+* Initial Contributors:
+* Nokia Corporation - initial contribution.
+*
+* Contributors:
+*
+* Description:  Utilities for contact management.
+*
+*/
+
+
+#ifndef VPBKUTILS_H
+#define VPBKUTILS_H
+
+// INCLUDES
+#include <e32def.h>
+
+
+// FORWARD DECLARATIONS
+class MVPbkFieldType;
+class MVPbkFieldTypeList;
+class MVPbkBaseContactField;
+class TResourceReader;
+class MVPbkBaseContact;
+class RFs;
+class MVPbkStoreContact;
+
+
+/**
+ * Utilities for contact management.
+ */
+namespace VPbkUtils
+{
+
+/**
+ * Returns the field type if aField matches one of the aFieldTypeList
+ * elements otherwise returns NULL.
+ *
+ * @param aFieldTypeList The field type list to use.
+ * @param aField The field whose type to match.
+ * @return The matched field type.
+ */
+IMPORT_C const MVPbkFieldType* MatchFieldType(
+    const MVPbkFieldTypeList& aFieldTypeList,
+    const MVPbkBaseContactField& aField);
+    
+/**
+ * Checks if aField matches the required field type from aFieldTypeList
+ * and the field type of aField matches to field type selector.
+ *
+ * @param aFieldTypeList A field type list for matching aField.
+ * @param aField The field whose type to check.
+ * @param aResourceReader A reader to VPBK_FIELD_TYPE_SELECTOR in
+ *                        VPbkFieldType.rh.
+ * @return ETrue If field type is included.
+ */
+IMPORT_C TBool IsFieldTypeIncludedL(
+    const MVPbkFieldTypeList& aFieldTypeList,
+    const MVPbkBaseContactField& aField,
+    TResourceReader& aResourceReader);
+
+/**
+ * Checks whether the contact contains a field that matches
+ * to given field type selector.
+ *
+ * @param aFieldTypeList A field type list for matching aField.
+ * @param aContact The contact whose fields are cheked.
+ * @param aResourceReader A reader to VPBK_FIELD_TYPE_SELECTOR in
+ *                        VPbkFieldType.rh.
+ * @return ETrue If field type is included.
+ */
+IMPORT_C TBool IsFieldTypeIncludedInContactL(
+    const MVPbkFieldTypeList& aFieldTypeList,
+    const MVPbkBaseContact& aContact,
+    TResourceReader& aResourceReader);
+
+/**
+ * Verifies the existance of the syncronization field.
+ *
+ * The data for the fields are defined in VPbkSyncConstants.h.
+ * Adds the field with the default value if not present.
+ * If the syncronization field is empty assigns a default value.
+ * If field contains invalid data default value is assigned.
+ *
+ * @param aFs A handle to an open file handle.
+ * @param aSupportedFieldTypeList Field types supported by the store. See
+ *                                MVPbkContactStoreProperties::SupportedFields.
+ * @param aContact A contact whose syncronization field and content is verified.
+ */
+IMPORT_C TBool VerifySyncronizationFieldL(
+        RFs& aFs,
+        const MVPbkFieldTypeList& aSupportedFieldTypeList,
+        MVPbkStoreContact& aContact);
+
+
+} // namespace VPbkUtils
+
+#endif // VPBKUTILS_H
+
+//End of file
+