(file) Return to CIMValue.h CVS log (file) (dir) Up to [Pegasus] / pegasus / src / Pegasus / Common

Diff for /pegasus/src/Pegasus/Common/CIMValue.h between version 1.11.2.3 and 1.58

version 1.11.2.3, 2001/11/15 20:15:24 version 1.58, 2012/01/11 23:58:57
Line 1 
Line 1 
 //%/////////////////////////////////////////////////////////////////////////////  //%LICENSE////////////////////////////////////////////////////////////////
 //  
 // Copyright (c) 2000, 2001 The Open group, BMC Software, Tivoli Systems, IBM  
 // //
 // Permission is hereby granted, free of charge, to any person obtaining a copy  // Licensed to The Open Group (TOG) under one or more contributor license
 // of this software and associated documentation files (the "Software"), to  // agreements.  Refer to the OpenPegasusNOTICE.txt file distributed with
 // deal in the Software without restriction, including without limitation the  // this work for additional information regarding copyright ownership.
 // rights to use, copy, modify, merge, publish, distribute, sublicense, and/or  // Each contributor licenses this file to you under the OpenPegasus Open
 // sell copies of the Software, and to permit persons to whom the Software is  // Source License; you may not use this file except in compliance with the
 // furnished to do so, subject to the following conditions:  // License.
 // //
 // THE ABOVE COPYRIGHT NOTICE AND THIS PERMISSION NOTICE SHALL BE INCLUDED IN  // Permission is hereby granted, free of charge, to any person obtaining a
 // ALL COPIES OR SUBSTANTIAL PORTIONS OF THE SOFTWARE. THE SOFTWARE IS PROVIDED  // copy of this software and associated documentation files (the "Software"),
 // "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT  // to deal in the Software without restriction, including without limitation
 // LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR  // the rights to use, copy, modify, merge, publish, distribute, sublicense,
 // PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT  // and/or sell copies of the Software, and to permit persons to whom the
 // HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN  // Software is furnished to do so, subject to the following conditions:
 // ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION  
 // WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.  
 // //
 //==============================================================================  // The above copyright notice and this permission notice shall be included
   // in all copies or substantial portions of the Software.
 // //
 // Author: Mike Brasher (mbrasher@bmc.com)  // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
   // OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
   // MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
   // IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
   // CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
   // TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
   // SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 // //
 // Modified By:  //////////////////////////////////////////////////////////////////////////
 // //
 //%///////////////////////////////////////////////////////////////////////////// //%/////////////////////////////////////////////////////////////////////////////
  
Line 32 
Line 35 
 #include <Pegasus/Common/String.h> #include <Pegasus/Common/String.h>
 #include <Pegasus/Common/Config.h> #include <Pegasus/Common/Config.h>
 #include <Pegasus/Common/CIMType.h> #include <Pegasus/Common/CIMType.h>
   #include <Pegasus/Common/CIMObjectPath.h>
   #include <Pegasus/Common/CIMObject.h>
 #include <Pegasus/Common/CIMDateTime.h> #include <Pegasus/Common/CIMDateTime.h>
 #include <Pegasus/Common/Union.h>  #include <Pegasus/Common/Exception.h>
 #include <Pegasus/Common/Array.h> #include <Pegasus/Common/Array.h>
   #include <Pegasus/Common/Linkage.h>
  
 PEGASUS_NAMESPACE_BEGIN PEGASUS_NAMESPACE_BEGIN
  
   class CIMValueRep;
   class CIMObject;
   class CIMInstance;
   
 /** /**
     The CIMValue class represents a value of any of the CIM data types      The CIMValue class represents a value of any of the CIM data types.
     (see CIMType.h for a list of valid CIM data types). This class      This class encapsulates a union which holds value of any CIMType.
     encapsulates a union which holds the current value. The class also      A type field indicates the type of the value.
     has a type field indicating the type of that value.  
 */ */
 class PEGASUS_COMMON_LINKAGE CIMValue class PEGASUS_COMMON_LINKAGE CIMValue
 { {
 public: public:
     /// Constructor      /**
           Constructs a null CIMValue with type Boolean and isArray=false.
       */
     CIMValue();     CIMValue();
  
     /// Constructor      /**
     CIMValue(Boolean x) { _init(); set(x); }          Constructs a null CIMValue object with the specified type and
           array indicator.
           @param type The CIMType of the value
           @param isArray A Boolean indicating whether the value is of array type
           @param arraySize An integer specifying the size of the array, if the
               CIMValue is for an array of a fixed size.  This value is ignored
               if the isArray argument is false.
       */
       CIMValue(CIMType type, Boolean isArray, Uint32 arraySize = 0);
  
     /// Constructor      /**
     CIMValue(Uint8 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Boolean value to assign
       */
       CIMValue(Boolean x);
  
     /// Constructor      /**
     CIMValue(Sint8 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint8 value to assign
       */
       CIMValue(Uint8 x);
  
     /// Constructor      /**
     CIMValue(Uint16 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint8 value to assign
       */
       CIMValue(Sint8 x);
  
     /// Constructor      /**
     CIMValue(Sint16 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint16 value to assign
       */
       CIMValue(Uint16 x);
  
     /// Constructor      /**
     CIMValue(Uint32 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint16 value to assign
       */
       CIMValue(Sint16 x);
  
     /// Constructor      /**
     CIMValue(Sint32 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint32 value to assign
       */
       CIMValue(Uint32 x);
  
     /// Constructor      /**
     CIMValue(Uint64 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint32 value to assign
       */
       CIMValue(Sint32 x);
  
     /// Constructor      /**
     CIMValue(Sint64 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint64 value to assign
       */
       CIMValue(Uint64 x);
  
     /// Constructor      /**
     CIMValue(Real32 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint64 value to assign
       */
       CIMValue(Sint64 x);
  
     /// Constructor      /**
     CIMValue(Real64 x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Real32 value to assign
       */
       CIMValue(Real32 x);
  
     /// Constructor      /**
     CIMValue(const Char16& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Real64 value to assign
       */
       CIMValue(Real64 x);
  
     /// Constructor      /**
     CIMValue(const String& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Char16 value to assign
       */
       CIMValue(const Char16& x);
  
     /// Constructor      /**
     CIMValue(const char* x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The String value to assign
       */
       CIMValue(const String& x);
  
     /// Constructor      /**
     CIMValue(const CIMDateTime& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The CIMDateTime value to assign
       */
       CIMValue(const CIMDateTime& x);
  
     /// Constructor      /**
     CIMValue(const CIMReference& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The CIMObjectPath value to assign
       */
       CIMValue(const CIMObjectPath& x);
   
       /**
           Constructs a CIMValue with the specified value and inferred type.
           Note: The CIMObject argument is cloned to prevent subsequent
           modification through the shared representation model.
           @param x The CIMObject value to assign
           @exception UninitializedObjectException If the CIMObject is
               uninitialized.
       */
       CIMValue(const CIMObject& x);
   
       /**
           Constructs a CIMValue with the specified value and inferred type.
           Note: The CIMInstance argument is cloned to prevent subsequent
           modification through the shared representation model.
           @param x The CIMInstance value to assign
           @exception UninitializedObjectException If the CIMInstance is
               uninitialized.
       */
       CIMValue(const CIMInstance& x);
   
       /**
           Constructs a CIMValue with the specified value and inferred type.
           @param x The Boolean Array value to assign
       */
       CIMValue(const Array<Boolean>& x);
   
       /**
           Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint8 Array value to assign
       */
       CIMValue(const Array<Uint8>& x);
   
       /**
           Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint8 Array value to assign
       */
       CIMValue(const Array<Sint8>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Boolean>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint16 Array value to assign
       */
       CIMValue(const Array<Uint16>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Uint8>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint16 Array value to assign
       */
       CIMValue(const Array<Sint16>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Sint8>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint32 Array value to assign
       */
       CIMValue(const Array<Uint32>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Uint16>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint32 Array value to assign
       */
       CIMValue(const Array<Sint32>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Sint16>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Uint64 Array value to assign
       */
       CIMValue(const Array<Uint64>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Uint32>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Sint64 Array value to assign
       */
       CIMValue(const Array<Sint64>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Sint32>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Real32 Array value to assign
       */
       CIMValue(const Array<Real32>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Uint64>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Real64 Array value to assign
       */
       CIMValue(const Array<Real64>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Sint64>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The Char16 Array value to assign
       */
       CIMValue(const Array<Char16>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Real32>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The String Array value to assign
       */
       CIMValue(const Array<String>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Real64>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The CIMDateTime Array value to assign
       */
       CIMValue(const Array<CIMDateTime>& x);
  
     /// Constructor      /**
     CIMValue(const Array<Char16>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           @param x The CIMObjectPath Array value to assign
       */
       CIMValue(const Array<CIMObjectPath>& x);
  
     /// Constructor      /**
     CIMValue(const Array<String>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           Note: The CIMObjects in the Array argument are cloned to prevent
           subsequent modification through the shared representation model.
           @param x The CIMObject Array value to assign
           @exception UninitializedObjectException If any of the CIMObjects in the
               Array are uninitialized.
       */
       CIMValue(const Array<CIMObject>& x);
  
     /// Constructor      /**
     CIMValue(const Array<CIMDateTime>& x) { _init(); set(x); }          Constructs a CIMValue with the specified value and inferred type.
           Note: The CIMInstances in the Array argument are cloned to prevent
           subsequent modification through the shared representation model.
           @param x The CIMInstance Array value to assign
           @exception UninitializedObjectException If any of the CIMInstances in
               the Array are uninitialized.
       */
       CIMValue(const Array<CIMInstance>& x);
  
     /// Constructor      /**
           Constructs a CIMValue by copying another CIMValue object.
           Note: If the specified CIMValue contains CIMObject or CIMInstance
           objects, they are cloned to prevent subsequent modification through
           the shared representation model.
           @param x The CIMValue object to copy
       */
     CIMValue(const CIMValue& x);     CIMValue(const CIMValue& x);
  
     /// Destrustructor      /**
           Destructs a CIMValue object.
       */
     ~CIMValue();     ~CIMValue();
  
     /// Operator =      /**
     CIMValue& operator=(const CIMValue& x)          Assigns the value from a specified CIMValue object.
     {          Note: If the specified CIMValue contains CIMObject or CIMInstance
         assign(x); return *this;          objects, they are cloned to prevent subsequent modification through
     }          the shared representation model.
           @param x The CIMValue object to copy
           @return A reference to this CIMValue object with the new assignment
       */
       CIMValue& operator=(const CIMValue& x);
  
     /// CIMMethod assign      /**
           Assigns the value from a specified CIMValue object.
           Note: If the specified CIMValue contains CIMObject or CIMInstance
           objects, they are cloned to prevent subsequent modification through
           the shared representation model.
           @param x The CIMValue object to copy
       */
     void assign(const CIMValue& x);     void assign(const CIMValue& x);
  
     /// CIMMethod clear      /**
           Resets to a null value with type Boolean and isArray=false.
       */
     void clear();     void clear();
  
     /** CIMMethod typeCompatible - Compares the types of two values.      /**
         @return true if compatible.          Compares the type and isArray attributes with a specified CIMValue.
           @param x The CIMValue object with which to compare
           @return A Boolean indicating whether the CIMValue objects have the same
               type and isArray attribute value.
     */     */
     Boolean typeCompatible(const CIMValue& x) const      Boolean typeCompatible(const CIMValue& x) const;
     {  
         return _type == x._type && _isArray == x._isArray;  
     }  
  
     /** CIMMethod isArray - Determines if the value is an array      /**
         @return TRUE if the value is an array          Indicates whether the value is an array.
           @return A Boolean indicating whether the value is an array.
     */     */
     Boolean isArray() const { return _isArray; }      Boolean isArray() const;
  
     /** Returns whether the CIMvalue object is null.      /**
         Null is the specific condition where no value has          Indicates whether the value is null.  A null CIMValue has a type, but
         yet been set into the value.          no value can be retrieved from it.
         If a CIMValue object is Null, any get on that object          @return A Boolean indicating whether the value is null.
         will create an exception.  
         @return Returns True if the CIMValue object is Null  
     */     */
     Boolean isNull() const { return _isNull; }      Boolean isNull() const;
  
     /** CIMMethod getArraySize      /**
         @return The number of entries in the array          Gets the fixed array size of a CIMValue.  This value is undefined for
           non-array values.  A value of 0 is given for variable size arrays.
           @return An integer indicating the array size.
     */     */
     Uint32 getArraySize() const;     Uint32 getArraySize() const;
  
     CIMType getType() const      /**
     {          Gets the value type.
         return CIMType(_type);          @return A CIMType indicating the type of the value.
     }      */
       CIMType getType() const;
  
     /// method setNullvalue - ATTN:      /**
           Sets the value to null with the specified type and array indicator.
           @param type The CIMType of the value
           @param isArray A Boolean indicating whether the value is of array type
           @param arraySize An integer specifying the size of the array, if the
               CIMValue is for an array of a fixed size.  This value is ignored
               if the isArray argument is false.
       */
     void setNullValue(CIMType type, Boolean isArray, Uint32 arraySize = 0);     void setNullValue(CIMType type, Boolean isArray, Uint32 arraySize = 0);
  
     /// method set - ATTN:      /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Boolean value to assign
       */
     void set(Boolean x);     void set(Boolean x);
  
     /// CIMMethod Set      /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint8 value to assign
       */
     void set(Uint8 x);     void set(Uint8 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint8 value to assign
       */
     void set(Sint8 x);     void set(Sint8 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint16 value to assign
       */
     void set(Uint16 x);     void set(Uint16 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint16 value to assign
       */
     void set(Sint16 x);     void set(Sint16 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint32 value to assign
       */
     void set(Uint32 x);     void set(Uint32 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint32 value to assign
       */
     void set(Sint32 x);     void set(Sint32 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint64 value to assign
       */
     void set(Uint64 x);     void set(Uint64 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint64 value to assign
       */
     void set(Sint64 x);     void set(Sint64 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Real32 value to assign
       */
     void set(Real32 x);     void set(Real32 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Real64 value to assign
       */
     void set(Real64 x);     void set(Real64 x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Char16 value to assign
       */
     void set(const Char16& x);     void set(const Char16& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The String value to assign
       */
     void set(const String& x);     void set(const String& x);
  
     void set(const char* x);      /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The CIMDateTime value to assign
       */
     void set(const CIMDateTime& x);     void set(const CIMDateTime& x);
  
     void set(const CIMReference& x);      /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The CIMObjectPath value to assign
       */
       void set(const CIMObjectPath& x);
   
       /**
           Sets the CIMValue to the specified value and inferred type.
           Note: The CIMObject argument is cloned to prevent subsequent
           modification through the shared representation model.
           @param x The CIMObject value to assign
           @exception UninitializedObjectException If the CIMObject is
               uninitialized.
       */
       void set(const CIMObject& x);
   
       /**
           Sets the CIMValue to the specified value and inferred type.
           Note: The CIMInstance argument is cloned to prevent subsequent
           modification through the shared representation model.
           @param x The CIMInstance value to assign
           @exception UninitializedObjectException If the CIMInstance is
               uninitialized.
       */
       void set(const CIMInstance& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Boolean Array value to assign
       */
     void set(const Array<Boolean>& x);     void set(const Array<Boolean>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint8 Array value to assign
       */
     void set(const Array<Uint8>& x);     void set(const Array<Uint8>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint8 Array value to assign
       */
     void set(const Array<Sint8>& x);     void set(const Array<Sint8>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint16 Array value to assign
       */
     void set(const Array<Uint16>& x);     void set(const Array<Uint16>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint16 Array value to assign
       */
     void set(const Array<Sint16>& x);     void set(const Array<Sint16>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint32 Array value to assign
       */
     void set(const Array<Uint32>& x);     void set(const Array<Uint32>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint32 Array value to assign
       */
     void set(const Array<Sint32>& x);     void set(const Array<Sint32>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Uint64 Array value to assign
       */
     void set(const Array<Uint64>& x);     void set(const Array<Uint64>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Sint64 Array value to assign
       */
     void set(const Array<Sint64>& x);     void set(const Array<Sint64>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Real32 Array value to assign
       */
     void set(const Array<Real32>& x);     void set(const Array<Real32>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Real64 Array value to assign
       */
     void set(const Array<Real64>& x);     void set(const Array<Real64>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The Char16 Array value to assign
       */
     void set(const Array<Char16>& x);     void set(const Array<Char16>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The String Array value to assign
       */
     void set(const Array<String>& x);     void set(const Array<String>& x);
  
       /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The CIMDateTime Array value to assign
       */
     void set(const Array<CIMDateTime>& x);     void set(const Array<CIMDateTime>& x);
  
     /// CIMMethod get - ATTN      /**
           Sets the CIMValue to the specified value and inferred type.
           @param x The CIMObjectPath Array value to assign
       */
       void set(const Array<CIMObjectPath>& x);
   
       /**
           Sets the CIMValue to the specified value and inferred type.
           Note: The CIMObjects in the Array argument are cloned to prevent
           subsequent modification through the shared representation model.
           @param x The CIMObject Array value to assign
           @exception UninitializedObjectException If any of the CIMObjects in the
               Array are uninitialized.
       */
       void set(const Array<CIMObject>& x);
   
       /**
           Sets the CIMValue to the specified value and inferred type.
           Note: The CIMInstances in the Array argument are cloned to prevent
           subsequent modification through the shared representation model.
           @param x The CIMInstance Array value to assign
           @exception UninitializedObjectException If any of the CIMInstances in
               the Array are uninitialized.
       */
       void set(const Array<CIMInstance>& x);
   
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           <pre>
               // get with complete checking on type and nullness
               Boolean v;
               CIMValue value = property.getValue();
               if ((value.getType() == CIMTYPE_BOOLEAN) && (!value.isNull()))
                   value.get(v);
               or
               // Set the value from property into v if the value is
               // of Boolean type and !isNull(). If type incorrect, generates
               // an exception.  If CIMValue is null, leaves v false. Else
               // sets Boolean value from property into v.
               Boolean v = false;
               property.getValue().get(v);
           </pre>
           @param x Output Boolean into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Boolean& x) const;     void get(Boolean& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
   
           @param x Output Uint8 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Uint8& x) const;     void get(Uint8& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint8 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Sint8& x) const;     void get(Sint8& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Uint16 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Uint16& x) const;     void get(Uint16& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint16 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Sint16& x) const;     void get(Sint16& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           <pre>
               Uint32 v;
               CIMValue value = property.getValue();
               if ((value.getType() == CIMTYPE_SINT32) && (!value.isNull()))
                   value.get(v);
           </pre>
           @param x Output Uint32 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Uint32& x) const;     void get(Uint32& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint32 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Sint32& x) const;     void get(Sint32& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Uint64 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Uint64& x) const;     void get(Uint64& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint64 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Sint64& x) const;     void get(Sint64& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Real32 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Real32& x) const;     void get(Real32& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Real64 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Real64& x) const;     void get(Real64& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Char16 into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Char16& x) const;     void get(Char16& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output String into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(String& x) const;     void get(String& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output CIMDateTime into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(CIMDateTime& x) const;     void get(CIMDateTime& x) const;
  
     void get(CIMReference& x) const;      /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).).
           @param x Output CIMObjectPath into which the value is stored if
               CIMValue state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
       void get(CIMObjectPath& x) const;
   
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output CIMObject into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
       void get(CIMObject& x) const;
   
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output CIMInstance into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
       void get(CIMInstance& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Boolean Array into which the value is stored if
               CIMValue state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Boolean>& x) const;     void get(Array<Boolean>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Uint8 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Uint8>& x) const;     void get(Array<Uint8>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint8 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Sint8>& x) const;     void get(Array<Sint8>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).).
           @param x Output Uint16 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Uint16>& x) const;     void get(Array<Uint16>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint16 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Sint16>& x) const;     void get(Array<Sint16>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Uint32 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Uint32>& x) const;     void get(Array<Uint32>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint32 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Sint32>& x) const;     void get(Array<Sint32>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Uint64 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Uint64>& x) const;     void get(Array<Uint64>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Sint64 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Sint64>& x) const;     void get(Array<Sint64>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Real32 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Real32>& x) const;     void get(Array<Real32>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Real64 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Real64>& x) const;     void get(Array<Real64>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output Char16 Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<Char16>& x) const;     void get(Array<Char16>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output String Array into which the value is stored if CIMValue
               state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<String>& x) const;     void get(Array<String>& x) const;
  
       /**
           Gets the value of the CIMValue.  The caller should first verify that
           the value is not null and may verify type to avoid the possibility of
           the TypeMismatchException.  The output parameter x is NOT
           updated if the value is null (isNull() == true).
           @param x Output CIMDateTime Array into which the value is stored if
               CIMValue state is not null.
           @exception TypeMismatchException If the value type does not match the
               output parameter.
       */
     void get(Array<CIMDateTime>& x) const;     void get(Array<CIMDateTime>& x) const;
  
     /** toXML - Converts a CIMValue object to XML.      /**
         @out Sint8 Array to hold the XML representation          Gets the value of the CIMValue.  The caller should first verify that
         @return Returns the XML representation of the CIMValue          the value is not null and may verify type to avoid the possibility of
         object in the input parameter out.          the TypeMismatchException.  The output parameter x is NOT
     */          updated if the value is null (isNull() == true).
     void toXml(Array<Sint8>& out) const;          @param x Output CIMObjectPath Array into which the value is stored if
               CIMValue state is not null.
     /** toXML - Converts a CIMValue object to XML.          @exception TypeMismatchException If the value type does not match the
         @return Returns the XML representation of the CIMValue              output parameter.
         object in String form.      */
     */      void get(Array<CIMObjectPath>& x) const;
     String toXml() const;  
       /**
     /** CIMMethod print - Format and print the Value to std output          Gets the value of the CIMValue.  The caller should first verify that
         stream          the value is not null and may verify type to avoid the possibility of
         @return None          the TypeMismatchException.  The output parameter x is NOT
         <PRE>          updated if the value is null (isNull() == true).
         Example:          @param x Output CIMObject Array into which the value is stored if
             CIMValue value(Boolean(true));              CIMValue state is not null.
             value.print();        // Prints "true"          @exception TypeMismatchException If the value type does not match the
         </PRE>              output parameter.
     */      */
     void print(PEGASUS_STD(ostream) &o=PEGASUS_STD(cout)) const;      void get(Array<CIMObject>& x) const;
   
     /** toMof - Converts a CIMValueObject to Mof.      /**
         @out Sint8 Array to hold the Mof representation          Gets the value of the CIMValue.  The caller should first verify that
         @return Returns the Mof representation of the CIMValue          the value is not null and may verify type to avoid the possibility of
         object in the input parameter out.          the TypeMismatchException.  The output parameter x is NOT
     */          updated if the value is null (isNull() == true).
     void toMof(Array<Sint8>& out) const;          @param x Output CIMInstance Array into which the value is stored if
               CIMValue state is not null.
           @exception TypeMismatchException If the value type does not match the
     /** toString - Converts the CIMvalue to a string.  Should only be              output parameter.
             used for output purposes.  To get an actual String value, use      */
             get(String &).      void get(Array<CIMInstance>& x) const;
         @return - String output for CIMValue.  
         <PRE>      /**
         Example:          Compares with another CIMValue object for equality.
             String test;          @param x The CIMValue with which to compare
             CIMValue value(Boolean(true));          @return A Boolean indicating whether they are identical in type,
             test = value.toString();      // puts "TRUE" into test              array attributes, and value.
         </PRE>      */
       Boolean equal(const CIMValue& x) const;
   
       /**
           Converts a CIMValue to a String.  This method should only be
           used for diagnostic output purposes.  To get an actual String value,
           use get(String &).
           @return A String representation of the value.
         */         */
     String toString() const;     String toString() const;
  
   #ifdef PEGASUS_USE_DEPRECATED_INTERFACES
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Constructs a CIMValue with the specified value and type Sint8.
           (Note: This constructor exists solely to support binary compatibility
           with a previous definition of the Sint8 type.)
           @param x The Sint8 value to assign
       */
       CIMValue(char x);
   
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Constructs a CIMValue with the specified value and type Sint8 Array.
           (Note: This constructor exists solely to support binary compatibility
           with a previous definition of the Sint8 type.)
           @param x The Sint8 Array value to assign
       */
       CIMValue(const Array<char>& x);
   
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Sets the CIMValue to the specified value and type Sint8.
           (Note: This method exists solely to support binary compatibility with
           a previous definition of the Sint8 type.)
           @param x The value to assign
       */
       void set(char x);
   
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Sets the CIMValue to the specified value and type Sint8 Array.
           (Note: This method exists solely to support binary compatibility with
           a previous definition of the Sint8 type.)
           @param x The Array value to assign
       */
       void set(const Array<char>& x);
   
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Gets the Sint8 value of the CIMValue.  The caller should first verify
           that the value is of the expected type and is not null.  The output
           parameter x is not updated if the value is null (isNull() == true).
           (Note: This method exists solely to support binary compatibility with
           a previous definition of the Sint8 type.)
           @param x Output variable into which the value is stored.
       */
       void get(char& x) const;
   
       /**
           <I><B>Deprecated Interface</B></I><BR>
           Gets the Sint8 Array value of the CIMValue.  The caller should first
           verify that the value is of the expected type and is not null.  The
           output parameter x is not updated if the value is null
           (isNull() == true).
           (Note: This method exists solely to support binary compatibility with
           a previous definition of the Sint8 type.)
           @param x Output Array variable into which the value is stored.
       */
       void get(Array<char>& x) const;
   #endif
   
 private: private:
  
     void _init();      void _get(const String*& data, Uint32& size) const;
  
     CIMType _type;      CIMValueRep* _rep;
     Boolean _isArray;  
     Boolean _isNull;  
     Union _u;  
  
     friend class CIMMethodRep;     friend class CIMMethodRep;
     friend class CIMParameterRep;     friend class CIMParameterRep;
     friend class CIMPropertyRep;     friend class CIMPropertyRep;
     friend class CIMQualifierRep;     friend class CIMQualifierRep;
     friend class CIMQualifierDeclRep;     friend class CIMQualifierDeclRep;
     PEGASUS_COMMON_LINKAGE friend Boolean operator==(      friend class BinaryStreamer;
         const CIMValue& x,      friend class XmlWriter;
         const CIMValue& y);      friend class SCMOClass;
       friend class SCMOInstance;
 }; };
  
   /**
       Compares two CIMValue objects for equality.
       @param x First CIMValue to compare
       @param y Second CIMValue to compare
       @return A Boolean indicating whether they are identical in type, array
           attributes, and value.
   */
 PEGASUS_COMMON_LINKAGE Boolean operator==(const CIMValue& x, const CIMValue& y); PEGASUS_COMMON_LINKAGE Boolean operator==(const CIMValue& x, const CIMValue& y);
  
 inline Boolean operator!=(const CIMValue& x, const CIMValue& y)  /**
 {      Compares two CIMValue objects for inequality.
     return !operator==(x, y);      @param x First CIMValue to compare
 }      @param y Second CIMValue to compare
       @return A Boolean indicating whether they are NOT identical in type, array
           attributes, and value.
   */
   PEGASUS_COMMON_LINKAGE Boolean operator!=(const CIMValue& x, const CIMValue& y);
  
 #define PEGASUS_ARRAY_T CIMValue #define PEGASUS_ARRAY_T CIMValue
 # include "ArrayInter.h"  # include <Pegasus/Common/ArrayInter.h>
 #undef PEGASUS_ARRAY_T #undef PEGASUS_ARRAY_T
  
 PEGASUS_NAMESPACE_END PEGASUS_NAMESPACE_END
  
   #ifdef PEGASUS_INTERNALONLY
   #include <Pegasus/Common/CIMValueInline.h>
   #endif
   
 #endif /* Pegasus_Value_h */ #endif /* Pegasus_Value_h */

Legend:
Removed from v.1.11.2.3  
changed lines
  Added in v.1.58
No CVS admin address has been configured
 Powered by
ViewCVS 0.9.2