CIMConstProperty Class Reference

#include <CIMProperty.h>

List of all members.

Public Member Functions

 CIMConstProperty ()
 CIMConstProperty (const CIMConstProperty &x)
 CIMConstProperty (const CIMProperty &x)
 CIMConstProperty (const CIMName &name, const CIMValue &value, Uint32 arraySize=0, const CIMName &referenceClassName=CIMName(), const CIMName &classOrigin=CIMName(), Boolean propagated=false)
 ~CIMConstProperty ()
CIMConstPropertyoperator= (const CIMConstProperty &x)
CIMConstPropertyoperator= (const CIMProperty &x)
const CIMNamegetName () const
const CIMValuegetValue () const
CIMType getType () const
Boolean isArray () const
Uint32 getArraySize () const
const CIMNamegetReferenceClassName () const
const CIMNamegetClassOrigin () const
Boolean getPropagated () const
Uint32 findQualifier (const CIMName &name) const
CIMConstQualifier getQualifier (Uint32 index) const
Uint32 getQualifierCount () const
Boolean identical (const CIMConstProperty &x) const
CIMProperty clone () const
Boolean isUninitialized () const

Detailed Description

The CIMConstProperty class provides a const interface to a CIMProperty object. This class is needed because the shared representation model used by CIMProperty does not prevent modification to a const CIMProperty object. Note that the value of a CIMConstProperty object could still be modified by a CIMProperty object that refers to the same data copy.


Constructor & Destructor Documentation

Constructs an uninitialized CIMConstProperty object. A method invocation on an uninitialized object will result in the throwing of an UninitializedObjectException. An uninitialized object may be converted into an initialized object only by using the assignment operator with an initialized object.

Constructs a CIMConstProperty object from the value of a specified CIMConstProperty object, so that both objects refer to the same data copy.

Parameters:
xThe CIMConstProperty object from which to construct a new CIMConstProperty object.

Constructs a CIMConstProperty object from the value of a specified CIMProperty object, so that both objects refer to the same data copy.

Parameters:
xThe CIMProperty object from which to construct a new CIMConstProperty object.
CIMConstProperty::CIMConstProperty ( const CIMName name,
const CIMValue value,
Uint32  arraySize = 0,
const CIMName referenceClassName = CIMName(),
const CIMName classOrigin = CIMName(),
Boolean  propagated = false 
)

Constructs a CIMConstProperty object with the specified attributes.

Parameters:
nameA CIMName specifying the name of the property.
valueA CIMValue specifying the property value, and implicitly defining the property type and whether the property is an Array property.
arraySizeA Uint32 indicating the size of the Array, if the property is an Array property. The default value of zero indicates a variable size array.
referenceClassNameA CIMName containing the reference class name for this property, if the property is of reference type.
classOriginA CIMName indicating the class in which the property is locally defined (optional).
propagatedA Boolean indicating whether the property is local to the class or instance in which it appears or was propagated (without modification) from other schema.
Exceptions:
TypeMismatchExceptionIf the property is of reference type and referenceClassName is null or if the property is not of reference type and referenceClassName is not null.
TypeMismatchExceptionIf the property is an Array property and arraySize is not zero.
UninitializedObjectExceptionIf the property name is null.

Member Function Documentation

Makes a deep copy of the property. This creates a new copy of all the property attributes including qualifiers.

Returns:
A CIMProperty object with a separate copy of the CIMConstProperty object.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.
Uint32 CIMConstProperty::findQualifier ( const CIMName name) const

Finds a qualifier by name.

Parameters:
nameA CIMName specifying the name of the qualifier to be found.
Returns:
Index of the qualifier if found or PEG_NOT_FOUND if not found.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the array size for the property.

Returns:
Uint32 array size.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the class in which this property is locally defined. This information is normally available with properties that are part of schema returned from a CIM Server.

Returns:
CIMName containing the classOrigin attribute.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the name of the property.

Returns:
A CIMName containing the name of the property.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Tests the propagated attribute of the object. The propagated attribute indicates whether this property was propagated from a higher-level class. Normally this attribute is set as part of defining a property in the context of a schema. It is set in properties retrieved from a CIM Server.

Returns:
True if property is propagated; otherwise, false.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the qualifier at the specified index.

Parameters:
indexThe index of the qualifier to be retrieved.
Returns:
The CIMConstQualifier object at the specified index.
Exceptions:
IndexOutOfBoundsExceptionIf the index is outside the range of qualifiers available for the CIMConstProperty.
UninitializedObjectExceptionIf the object is not initialized.

Gets the number of qualifiers in the property.

Returns:
An integer count of the qualifiers in the CIMConstProperty.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the reference class name for the property.

Returns:
A CIMName containing the reference class name for the property if the property is of reference type, a null CIMName otherwise.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.
CIMType CIMConstProperty::getType ( ) const

Gets the property type.

Returns:
A CIMType containing the property type.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Gets the property value.

Returns:
A CIMValue containing the property value.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.
Boolean CIMConstProperty::identical ( const CIMConstProperty x) const

Compares the property with another property.

Parameters:
xThe CIMConstProperty to be compared.
Returns:
True if this property is identical to the one specified, false otherwise.
Exceptions:
UninitializedObjectExceptionIf either of the objects is not initialized.
Boolean CIMConstProperty::isArray ( ) const

Checks whether the property is an Array property.

Returns:
True if the property is an Array property, false otherwise.
Exceptions:
UninitializedObjectExceptionIf the object is not initialized.

Determines whether the object has been initialized.

Returns:
True if the object has not been initialized, false otherwise.
CIMConstProperty& CIMConstProperty::operator= ( const CIMConstProperty x)

Assigns the value of the specified CIMConstProperty object to this object, so that both objects refer to the same data copy.

Parameters:
xThe CIMConstProperty object from which to assign this CIMConstProperty object.
Returns:
A reference to this CIMConstProperty object.
CIMConstProperty& CIMConstProperty::operator= ( const CIMProperty x)

Assigns the value of the specified CIMProperty object to this object, so that both objects refer to the same data copy.

Parameters:
xThe CIMProperty object from which to assign this CIMConstProperty object.
Returns:
A reference to this CIMConstProperty object.

The documentation for this class was generated from the following file:
  • /srv/build/STABLE_8/pkgs/tog-pegasus/BUILD/pegasus/src/Pegasus/Common/CIMProperty.h