version 1.14.2.1, 2002/10/28 15:43:21
|
version 1.18, 2003/10/27 19:48:06
|
|
|
//%///////////////////////////////////////////////////////////////////////////// |
//%2003//////////////////////////////////////////////////////////////////////// |
// | // |
// Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Company, IBM, |
// Copyright (c) 2000, 2001, 2002 BMC Software, Hewlett-Packard Development |
// The Open Group, Tivoli Systems |
// Company, L. P., IBM Corp., The Open Group, Tivoli Systems. |
|
// Copyright (c) 2003 BMC Software; Hewlett-Packard Development Company, L. P.; |
|
// IBM Corp.; EMC Corporation, The Open Group. |
// | // |
// Permission is hereby granted, free of charge, to any person obtaining a copy | // Permission is hereby granted, free of charge, to any person obtaining a copy |
// of this software and associated documentation files (the "Software"), to | // of this software and associated documentation files (the "Software"), to |
|
|
// | // |
// Author: Mike Brasher (mbrasher@bmc.com) | // Author: Mike Brasher (mbrasher@bmc.com) |
// | // |
// Modified By: |
// Modified By: Carol Ann Krug Graves, Hewlett-Packard Company |
|
// (carolann_graves@hp.com) |
|
// Roger Kumpf, Hewlett-Packard Company (roger_kumpf@hp.com) |
// | // |
//%///////////////////////////////////////////////////////////////////////////// | //%///////////////////////////////////////////////////////////////////////////// |
| |
|
|
#define Pegasus_Scope_h | #define Pegasus_Scope_h |
| |
#include <Pegasus/Common/Config.h> | #include <Pegasus/Common/Config.h> |
#include <Pegasus/Common/Array.h> |
|
#include <Pegasus/Common/String.h> | #include <Pegasus/Common/String.h> |
#include <Pegasus/Common/Linkage.h> | #include <Pegasus/Common/Linkage.h> |
| |
PEGASUS_NAMESPACE_BEGIN | 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; |
| |
/** The behavior of this method is undefined and is subject to change */ |
/** Indicates that the qualifier may be used with classes. |
PEGASUS_COMMON_LINKAGE String ScopeToString(Uint32 scope); |
*/ |
|
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; |
|
|
|
/** Indicates that the qualifier may be used with methods. |
|
*/ |
|
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; |
|
}; |
| |
PEGASUS_NAMESPACE_END | PEGASUS_NAMESPACE_END |
| |