pegasus/src/Pegasus/Common/CIMScope.h - diff

Return to CIMScope.h CVS log

Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/CIMScope.h between version 1.12 and 1.23

version 1.12, 2002/07/26 20:01:19

version 1.23, 2006/01/30 16:16:47

Line 1

//%/////////////////////////////////////////////////////////////////////////////

//%2006////////////////////////////////////////////////////////////////////////

// The Open Group, Tivoli Systems

// Company, L.P.; IBM Corp.; The Open Group; Tivoli Systems.

// IBM Corp.; EMC Corporation, The Open Group.

// IBM Corp.; EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; VERITAS Software Corporation; The Open Group.

// EMC Corporation; Symantec Corporation; The Open Group.

// Permission is hereby granted, free of charge, to any person obtaining a copy

// of this software and associated documentation files (the "Software"), to

Line 21

Line 29

//==============================================================================

// Author: Mike Brasher (mbrasher@bmc.com)

// Modified By:

//%/////////////////////////////////////////////////////////////////////////////

#ifndef Pegasus_Scope_h

#define Pegasus_Scope_h

#include <Pegasus/Common/Config.h>

#include <Pegasus/Common/Array.h>

#include <Pegasus/Common/String.h>

#include <Pegasus/Common/Linkage.h>

PEGASUS_NAMESPACE_BEGIN

/**

The CIMQualifier Scopes are as follows:

The CIMScope class implements the concept of the scope of a CIM qualifier

NONE, Class, ASSOCIATION,INDICATION,PROPERTY, REFERENCE, METHOD,

object. The scope of a qualifier defines the set of types of CIM objects

PARAMETER, ANY

with which the qualifier may be used. The possible values are:

NONE, CLASS, ASSOCIATION, INDICATION, PROPERTY, REFERENCE, METHOD,

PARAMETER, ANY.

The scope is a set of one or more of these possible values.

The value "NONE" implies a CIMScope object that has not yet been assigned a

value (uninitialized). It is not a valid value for the scope of a

qualifier object.

The value "ANY" means that the qualifier may be used with any of the CIM

object types, and is equivalent to listing each of the object types in the

scope.

struct PEGASUS_COMMON_LINKAGE CIMScope

class PEGASUS_COMMON_LINKAGE CIMScope

{

static const Uint32 NONE;

public:

static const Uint32 CLASS;

static const Uint32 ASSOCIATION;

/** Constructs a CIMScope object with no value set (default constructor).

static const Uint32 INDICATION;

The values are null.

static const Uint32 PROPERTY;

static const Uint32 REFERENCE;

CIMScope ();

static const Uint32 METHOD;

static const Uint32 PARAMETER;

/** Constructs a CIMScope object from an existing CIMScope object (copy

static const Uint32 ANY;

constructor).

};

@param scope Specifies an instance of CIMScope object.

CIMScope (const CIMScope & scope);

/** Assigns the value of one CIMScope object to another (assignment

operator).

@param scope Specifies the name of a CIMScope object that contains

the values that you want to assign to another CIMScope object.

@return The CIMScope object with the values of the specified CIMScope

object. For example:

<pre>

CIMScope s0;

CIMScope s1(s0);

</pre>

The values in CIMScope s0 are assigned to the CIMScope s1 instance.

CIMScope & operator= (const CIMScope & scope);

/** Determines if every value in the specified CIMScope object is included

in this CIMScope object.

@param scope - Specifies a name of a CIMScope object.

@return True if every value in the specified CIMScope object is

included in the CIMScope object; otherwise, false.

Boolean hasScope (const CIMScope & scope) const;

/** Adds the specified scope value to the CIMScope object.

@param scope - Specifies a scope value. For example:

<pre>

CIMScope s0;

s0.addScope (CIMScope::INDICATION);

if(s0.hasScope (CIMScope::INDICATION))

... ..

</pre>

void addScope (const CIMScope & scope);

/** Compares two CIMScope objects.

@param scope - Specifies a CIMScope object.

@return True if the two CIMScope objects are equal; otherwise, false.

For example,

<pre>

CIMScope s0;

s0.addScope (CIMScope::CLASS + CIMScope::PARAMETER);

if(s0.hasScope (CIMScope::CLASS))

... ..

</pre>

Boolean equal (const CIMScope & scope) const;

/** Combines two CIMScope objects.

@param scope - Specifies a CIMScope object to add.

@return A new CIMScope object that represents the combination of this

scope object with the specified scope object.

<pre>

CIMScope s0(CIMScope::CLASS);

CIMScope s1(CIMScope::PARAMETER);

CIMScope s3 = s0 + S1;

</pre>

CIMScope operator+ (const CIMScope & scope) const;

/** Returns a String representation of the CIMScope object.

This method is for diagnostic purposes. The format of the output

is subject to change.

String toString () const;

/** Indicates that the CIMScope object has no value (is uninitialized).

static const CIMScope NONE;

/** Indicates that the qualifier may be used with classes.

static const CIMScope CLASS;

/** Indicates that the qualifier may be used with associations.

static const CIMScope ASSOCIATION;

/** Indicates that the qualifier may be used with indications.

static const CIMScope INDICATION;

/** Indicates that the qualifier may be used with properties.

static const CIMScope PROPERTY;

/** Indicates that the qualifier may be used with references.

static const CIMScope REFERENCE;

/** The behavior of this method is undefined and is subject to change */

/** Indicates that the qualifier may be used with methods.

PEGASUS_COMMON_LINKAGE String ScopeToString(Uint32 scope);

static const CIMScope METHOD;

/** Indicates that the qualifier may be used with parameters.

static const CIMScope PARAMETER;

/** Indicates that the qualifier may be used with any of the types

of objects (classes, associations, indications, properties, references,

methods, parameters).

static const CIMScope ANY;

private:

CIMScope (const Uint32 scope);

// Private member for storing he CIMScope

Uint32 cimScope;

friend class BinaryStreamer;

};

PEGASUS_NAMESPACE_END

Legend:

Removed from v.1.12
changed lines
	Added in v.1.23

No CVS admin address has been configured