sl@0: /*
sl@0: * Copyright (c) 2002 Nokia Corporation and/or its subsidiary(-ies).
sl@0: * All rights reserved.
sl@0: * This component and the accompanying materials are made available
sl@0: * under the terms of the License "Eclipse Public License v1.0"
sl@0: * which accompanies this distribution, and is available
sl@0: * at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: *
sl@0: * Initial Contributors:
sl@0: * Nokia Corporation - initial contribution.
sl@0: *
sl@0: * Contributors:
sl@0: *
sl@0: * Description: 
sl@0: *    
sl@0: *
sl@0: */
sl@0: 
sl@0: 
sl@0: 
sl@0: #ifndef C_STATE_MACHINE_H
sl@0: #define C_STATE_MACHINE_H
sl@0: 
sl@0: #include "NumberGroupingStd.h"
sl@0: 
sl@0: NONSHARABLE_CLASS(CStateMachine) : public CBase
sl@0: {
sl@0: public:
sl@0: 	static CStateMachine*	NewL(TInt aMaxNumberChars, TInt aMaxNumberStates);
sl@0: 	static CStateMachine*	NewLC(TInt aMaxNumberChars, TInt aMaxNumberStates);
sl@0: 
sl@0: 	virtual ~CStateMachine();
sl@0: 
sl@0: 	void			AddStateTransistionL(TChar aChar, TInt aState, TInt aNextState);
sl@0: 	void			AddStateTransistionL(TInt aDigit, TInt aState, TInt aNextState);
sl@0: 
sl@0: 	TBool			Matches(const TDesC& aString);
sl@0:     
sl@0:     /**
sl@0:     * This routine writes into a client supplied descriptor a string that is a wildcard version
sl@0:     * of the pattern match for this state machine.  It writes characters into the supplied descriptor
sl@0:     * to a length of the maximum number of characters to match. 
sl@0:     * For each character index, if there is only one possible valid character, it puts in that 
sl@0:     * character.  If there are more than one, then the supplied aWildcardChar is written in.
sl@0:     * The character '.' in the state machine is not treated as a single character, but as a range,
sl@0:     * and so the wildcard character is written in for the '.'.
sl@0:     * 
sl@0:     * aWildcardPattern must have MaxLength which is equal or greater than iMaxNumberStates
sl@0:     * 
sl@0:     * @param    aWildcardChar   The character to put in aExamplePattern if there is no single 
sl@0:     *                           valid character at that point
sl@0:     * @param    aWildcardedPattern Descriptor to write the wildcarded number pattern into
sl@0:     */
sl@0:     void            GetWildcardVersionOfPattern( 
sl@0:         TText aWildcardChar, 
sl@0:         TDes& aWildcardedPattern ) const;
sl@0: 
sl@0: private:
sl@0: 	CStateMachine(TInt aMaxNumberChars, TInt aMaxNumberStates);
sl@0: 
sl@0: 	void			ConstructL();
sl@0: 	virtual TInt	MapIndex(TChar aChar, RArray<TInt>& aIndices);
sl@0: 	
sl@0: 	TInt**			iStateTable;
sl@0: 	TInt			iMaxNumberChars;
sl@0: 	TInt			iMaxNumberStates;
sl@0: };
sl@0: 
sl@0: #endif // C_STATE_MACHINE_H
sl@0: // End of File