--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/phonesrv_plat/string_parser_api/inc/CPhoneGsmParserBase.h	Tue Feb 02 01:11:09 2010 +0200
@@ -0,0 +1,181 @@
+/*
+* Copyright (c) 2002-2008 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:  It is base class for parsers.
+*
+*/
+
+
+#ifndef CPHONEGSMPARSERBASE_H
+#define CPHONEGSMPARSERBASE_H
+
+// INCLUDES
+#include    <e32base.h>
+
+// MACROS
+
+/**
+* It defines macro that can be used to create a single uid.
+* 
+* Parameters main and sub should be positive integers, range of
+* main is 0..255 and sub is 0..2^16-1. 
+*
+* Macro is equivalent to (main mod 256)*2**16 + sub.
+*/
+#define PHONE_MAKE_UID( main, sub ) (TUint32)((((main) & 0xFF) << 16) + ((sub) & 0xFFFF))
+
+/**
+* Extracts main part from uid.
+*
+* Macro is equivalent to (main / 2**16) mod 256.
+*/
+#define PHONE_EXTRACT_MAIN( uid ) (((uid) >> 16) & 0xFF)
+
+// CONSTANTS
+
+/**
+* ALL MAIN UIDS ARE LISTED HERE.
+*
+* Please, do not change unless you know what you are doing!
+*/
+
+/**
+* Invalid string.
+*/
+const TUint32 KPhoneGsmUidInvalid = 0;
+
+/**
+* Supplementary services.
+*/
+const TUint32 KPhoneGsmUidSupplementaryService = 1;
+
+/**
+* Sim control procedure.
+*/
+const TUint32 KPhoneGsmUidSimControlProcedure = 2;
+
+/**
+* Phone number
+*/
+const TUint32 KPhoneGsmUidDialPhoneNumber = 3;
+
+/**
+* Misc GSM required strings, most notably USSD and IMEI.
+*/
+const TUint32 KPhoneGsmUidMisc = 4;
+
+/**
+* Supplementary service, during calls.
+*/
+const TUint32 KPhoneGsmUidSupplementaryServiceDuringCall = 5;
+
+/**
+* Manufacturer specific codes.
+*/
+const TUint32 KPhoneGsmUidManufacturer = 6;
+
+/**
+* PCN specific codes.
+*/
+const TUint32 KPhoneGsmUidPcnProcedures = 7;
+
+/**
+* Emergency number
+*/
+const TUint32 KPhoneGsmUidDialEmergencyNumber = 8;
+
+/**
+* Voip number
+*/
+const TUint32 KPhoneUidDialVoipyNumber = 9;
+
+/**
+* ALL MISC UIDS:
+*/
+const TUint32 KPhoneUidUnstructuredService = 
+    PHONE_MAKE_UID( KPhoneGsmUidMisc, 0 );
+const TUint32 KPhoneUidIMEI =
+    PHONE_MAKE_UID( KPhoneGsmUidMisc, 1 );
+
+// FORWARD DECLARATIONS
+class CPhoneGsmParserResult;
+class CPhoneGsmOptionContainerBase;
+
+// CLASS DECLARATION
+
+/**
+* It is base class for parsers.
+*
+* @since 1.0
+* @lib phoneparser.lib
+*/
+class CPhoneGsmParserBase 
+    : public CBase
+    {
+    public: // New functions
+        
+        /**
+        * Parses string.
+        *
+        * String must not contain other characters than from set
+        * { 0..9, *, #, +, p, w }. If method leaves, then result
+        * may contain something that is not valid.
+        *
+        * @param aString string to be parsed.
+        * @param aResult It will contain result.
+        * @param aOptions It contains all options related to parsing.
+        * @return It returns boolean value indicating success of parsing.
+        */
+        virtual TBool ParseL( 
+            const TDesC& aString,
+            CPhoneGsmParserResult& aResult,
+            CPhoneGsmOptionContainerBase& aOptions ) = 0;
+
+        // SOME COMMON STATIC FUNCTIONS
+
+        /**
+        * Checks if string is prefix of another.
+        *
+        * @param aString original string.
+        * @param aPrefix possibly prefix of aString.
+        * @return ETrue iff aPrefix is prefix of aString.
+        */
+        static TBool IsPrefixOf( 
+            const TDesC& aString, 
+            const TDesC& aPrefix );
+        
+        /**
+        * Checks if string is postfix of another.
+        *
+        * @param aString original string.
+        * @param aPrefix possibly postfix of aString.
+        * @return ETrue iff aPostfix is postfix of aString.
+        */
+        static TBool IsPostfixOf(
+            const TDesC& aString,
+            const TDesC& aPostfix );
+
+        /**
+        * Extracts sequence of digits.
+        *
+        * @param aString input.
+        * @return sequence of digits, prefix of aString.
+        */
+        static TPtrC ExtractNumber( 
+            const TDesC& aString );
+
+    };
+
+#endif      // CPHONEGSMPARSERBASE_H
+            
+// End of File