CSensrvChannelCondition Class Reference

#include <sensrvchannelcondition.h>

class CSensrvChannelCondition : public CBase

Inherits from

CSensrvChannelCondition

Public Member Functions
	CSensrvChannelCondition()
pure virtual TInt	ConditionItemIndex()
pure virtual TInt	ConditionOperator()
pure virtual TInt	ConditionType()
pure virtual const TDesC8 &	ConditionValue()
pure virtual TInt	GetConditionValue(TDes8 &)
IMPORT_C CSensrvChannelCondition *	NewL(TInt, TInt, TInt, TDesC8 &)
IMPORT_C CSensrvChannelCondition *	NewLC(TInt, TInt, TInt, TDesC8 &)

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()

Detailed Description

CSensrvChannelCondition represents a channel condition item. Channel conditions are added to a channel condition set. A channel condition set is met when all channel conditions are met at the same time, if it is AND-type set, or when single condition is met if it is OR-type set. Only one channel condition can be set for each data item in single channel condition set. Certain condition types (range conditions) require two condition objects (upper and lower limit) in a condition set for the set to be valid. The pair of conditions must both have the same index in the condition set and they are considered a single channel condition.

Each Condition has an ItemIndex associated with it. When a Condition is added to a Condition Set using CSensrvChannelConditionSet::AddChannelConditionL() this index must be different to all other conditions added to the set with the exception of range conditions as described above. If the index supplied already exists and the condition is not part of a range condition then CSensrvChannelConditionSet::AddChannelConditionL() leaves with KErrArgument.

library: sensrvutil.lib

Since: S60 5.0

Constructor & Destructor Documentation

CSensrvChannelCondition ( )

(

TDes8 &

aValue

)

const [pure virtual]

Get condition value.

Parameter	Description
aValue	Value of the condition is copied to the supplied descriptor

Returns: KErrOverflow if aData is the wrong size for data item or one of the system-wide error codes

NewL ( TInt, TInt, TInt, TDesC8 & )

IMPORT_C CSensrvChannelCondition *	NewL	(	TInt	aConditionType,
			TInt	aConditionOperator,
			TInt	aItemIndex,
			TDesC8 &	aValue
		)	[static]

Two-phase constructor

leave: KErrNoMemory

leave: KErrArgument if parameters are invalid or are less than 0

leave: One of the system-wide error codes

Parameter	Description
aConditionType	Defines the type of the condition
aConditionOperator	Defines the operator used in the condition
aItemIndex	Item index to be used in the condition evaluation
aValue	Value to be used in condition evaluation. By default this should be a packaged data object of the channel. See the channel specific headers in . If the channel type requires a different type of value, that must be indicated clearly in the channel specific header defining the channel.

Returns: Pointer to created object

NewLC ( TInt, TInt, TInt, TDesC8 & )

IMPORT_C CSensrvChannelCondition *	NewLC	(	TInt	aConditionType,
			TInt	aConditionOperator,
			TInt	aItemIndex,
			TDesC8 &	aValue
		)	[static]

Two-phase constructor

leave: KErrNoMemory

leave: KErrArgument if parameters are invalid or are less than 0

leave: One of the system-wide error codes

Parameter	Description
aConditionType	Defines the type of the condition
aConditionOperator	Defines the operator used in the condition
aItemIndex	Item index to be used in the condition evaluation
aValue	Value to be used in condition evaluation. By default this should be a packaged data object of the channel. See the channel specific headers in . If the channel type requires a different type of value, that must be indicated clearly in the channel specific header defining the channel.

Returns: Pointer to created object