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

Diff for /pegasus/src/Pegasus/Common/CIMName.h between version 1.22 and 1.23

version 1.22, 2003/03/12 21:02:53 version 1.23, 2003/10/04 21:10:11
Line 53 
Line 53 
     CIM names. A CIM name must match the following regular     CIM names. A CIM name must match the following regular
     expression:     expression:
     <PRE>     <PRE>
   
         [A-Z-a-z_][A-Za-z_0-9]*         [A-Z-a-z_][A-Za-z_0-9]*
     </PRE>     </PRE>
       <B>Examples:</B>
       <ul>
       <li>name - legal name
       <li>Type - legal name
       <li>3types - Illegal CIMName.
       </ul>
       The CIMName object includes the attribute Null which is required
       by the DMTF operations definitions.  Note that this and the regular
       expression limits on CIMName are what separate this from the String
       class. This allows the names in CIM operations such as getClass to
       provide pattern matching tests for the classname parameter as well as
       separate the concept of empty from Null.
   
 */ */
 class PEGASUS_COMMON_LINKAGE CIMName class PEGASUS_COMMON_LINKAGE CIMName
 { {
 public: public:
  
     ///      /** Default constructor (sets isNull to true).
       */
     CIMName();     CIMName();
     ///  
           /** Constructor creates a new CIMName object from
               the String provided as input. The String must
               be a legal name.
               @param String defining the CIMName
               @Exception InvalidNameException if the input String is
               not a legal CIMName
       */
     CIMName(const String& name);     CIMName(const String& name);
     ///      /**
           Constructor creates a new CIMName object from
                           the String provided as input. The String must
                           be a legal name.
                           @param char* defining the CIMName text.
                           @Exception InvalidNameException if the input String is
                           not a legal CIMName
           */
     CIMName(const char* name);     CIMName(const char* name);
  
     ///      /** Copy Constructor for CIMName object
           */
     CIMName& operator=(const CIMName& name);     CIMName& operator=(const CIMName& name);
     ///      /** Copy constructor String object. Allows copying
               String value into a CIMName.
               @param String to be copied into CIMName
               @exception InvalidNameException if the input String
               is not a legal CIMName
               <pre>
                           CIMName n;
                           String type = "type";
                           n = type;
               </pre>
           */
     CIMName& operator=(const String& name);     CIMName& operator=(const String& name);
  
 #ifndef PEGASUS_REMOVE_DEPRECATED #ifndef PEGASUS_REMOVE_DEPRECATED
     CIMName& operator=(const char* name);     CIMName& operator=(const char* name);
 #endif #endif
  
     ///      /** Extracts the String value of the CIMName
               from the CIMName object.
               @return String containing the name.
               <pre>
                           CIMName n("name");
                           String s = n.getString();
               </pre>
           */
     const String& getString() const;     const String& getString() const;
  
 #ifndef PEGASUS_REMOVE_DEPRECATED #ifndef PEGASUS_REMOVE_DEPRECATED
     operator String() const;     operator String() const;
 #endif #endif
  
     ///      /** Tests the CIMName for NULL attribute.
               @return true if Null or false if not Null.
               <pre>
                           CIMName n;
                           assert(n.isNull());
                           n = "name";
                           assert(!n.isNull());
               </pre>
           */
     Boolean isNull() const;     Boolean isNull() const;
  
     ///      /** Clears the CIMName and sets it to Null.
               <pre>
                   CIMMame n("name");
                   n.clear();
                   assert(n.isNull());
               </pre>
           */
     void clear();     void clear();
  
     /** Compares two names.      /** Compares the CIMName object against another CIMName object for equality.
               @param CIMName to compare.
         @return true if the name passed is equal to the name in this         @return true if the name passed is equal to the name in this
         class. CIM names are case insensitive and so is this method.         class. CIM names are case insensitive and so is this method.
               <pre>
               CIMName n1 = "name";
               CIMName n2 = "InstanceID";
               if( n1.equal(n2) )
                       ...                                         // Should never get here
               else
                       ...
               </pre>
     */     */
     Boolean equal(const CIMName& name) const;     Boolean equal(const CIMName& name) const;
  
     /** Determines if the name string input is legal as     /** Determines if the name string input is legal as
         defnined in the CIMName class definition.                  defined in the CIMName class definition. This is a static
                   method used to test String values to determine if they are
                   legal names.
         @param name String to test for legality.         @param name String to test for legality.
         @return true if the given name is legal, false otherwise.         @return true if the given name is legal, false otherwise.
           <pre>
               assert(CIMName::legal("name"));
               assert(!CIMName::legal("3types"));
           </pre>
     */     */
     static Boolean legal(const String& name);     static Boolean legal(const String& name);
  
Line 127 
Line 201 
     <p>     <p>
     A CIM namespace name must match the following expression:     A CIM namespace name must match the following expression:
     <PRE>     <PRE>
         &ltCIMName&gt[/&ltCIMName&gt]...          &ltCIMName&gt[ / &ltCIMName&gt]*
     </PRE>     </PRE>
     </p>     </p>
       <B>Examples</B>
       <UL>
       <LI>root
       <LI>root/test
       </UL>
       NOTE: Pegasus uses namespaces starting with the top level name (ex. root).  It does
       not use the form /root/test with a leading slash.  The legal test in this class
       allows that form as a legal entity however.
 */ */
 class PEGASUS_COMMON_LINKAGE CIMNamespaceName class PEGASUS_COMMON_LINKAGE CIMNamespaceName
 { {
 public: public:
  
     ///      /** Default constructor sets object Null. The Null state
               indicates that there is no name assigned to this object.
               The Null state can be tested with the isNull() method and
               set with the clear() method.
           */
     CIMNamespaceName();     CIMNamespaceName();
     ///  
       /** Constructor builds namespace from input String.
               The String input must be a legal namespace name.
               @param String from which the namespace object is built.
               This must be a legal namespace name.
               @exeception InvalidNamespaceName exception thrown if
               the namespace name input is illegal.
           */
     CIMNamespaceName(const String& name);     CIMNamespaceName(const String& name);
     ///  
       /** Constructor builds namespace from input char*.
               The String input must be a legal namespace name.
               @param char* from which the namespace object is built.
               This must be a legal namespace name.
               @exeception InvalidNamespaceName exception thrown if
               the namespace name input parameter is illegal.
           */
     CIMNamespaceName(const char* name);     CIMNamespaceName(const char* name);
  
     ///      /** Assign one namespace object to another.
                   @param CIMNamespaceName to assign to the object.
           */
     CIMNamespaceName& operator=(const CIMNamespaceName& name);     CIMNamespaceName& operator=(const CIMNamespaceName& name);
     ///  
       /** Assign a String object to a CIMNamespaceName object.
                   @param CIMNamespaceName to assign
                   @exeception InvalidNamespaceName exception thrown if
                   the namespace name input parameter is illegal.
               <pre>
                           String s = "root/test";
                           CIMNamespacename ns;
                           ns = s;
               </pre>
           */
     CIMNamespaceName& operator=(const String& name);     CIMNamespaceName& operator=(const String& name);
  
 #ifndef PEGASUS_REMOVE_DEPRECATED #ifndef PEGASUS_REMOVE_DEPRECATED
     CIMNamespaceName& operator=(const char* name);     CIMNamespaceName& operator=(const char* name);
 #endif #endif
  
     ///      /** Extracts the String value of the CIMNamespaceName
               from the object.
               @return String containing the name.
               <pre>
                           CIMNamespaceName ns("root/test");
                           String s = ns.getString();
               </pre>
           */
     const String& getString() const;     const String& getString() const;
  
 #ifndef PEGASUS_REMOVE_DEPRECATED #ifndef PEGASUS_REMOVE_DEPRECATED
     operator String() const;     operator String() const;
 #endif #endif
  
     ///      /** Tests the CIMNamespaceName for NULL attribute. Returns
               true if Null.  New objects without parameter and objects
               set with clear() are Null.  When a name is set into the
               object is is set to nonnull.  When the object is Null, it
               returns empty string.
               @return true if Null or false if not Null.
               <pre>
                           CIMName n;
                           assert(n.isNull());
                           n = "name";
                           assert(!n.isNull());
               </pre>
           */
     Boolean isNull() const;     Boolean isNull() const;
  
     ///      /** Clears the CIMNamespaceName and sets it to Null. A Null
               object contains no name so that accessing it with getString
               should return an empty String
               <pre>
                           CIMMamespaceName ns("root/test");
                           ns.clear();
                           assert(ns.isNull());
               </pre>
           */
     void clear();     void clear();
  
     /** Compares two names.      /** Compares two CIMNamespace objects for equality.
         @return true if the name passed is equal to the name in this         @return true if the name passed is equal to the name in this
         class. CIM names are case insensitive and so is this method.         class. CIM names are case insensitive and so is this method.
                   <pre>
                   CIMMamespaceName ns("root/test");
                   CIMMamespaceName ns1("root/test");
                   assert( ns.equal(ns1);
               </pre>
     */     */
     Boolean equal(const CIMNamespaceName& name) const;     Boolean equal(const CIMNamespaceName& name) const;
  
     /** Determines if the name string input is legal as     /** Determines if the name string input is legal as
         defnined in the CIMNamespaceName class definition.          defined in the CIMNamespaceName class definition.
         @param name String to test for legality.         @param name String to test for legality.
         @return true if the given name is legal, false otherwise.         @return true if the given name is legal, false otherwise.
           <pre>
                   assert(CIMNamespaceName::legal("root/test"));
           </pre>
     */     */
     static Boolean legal(const String& name);     static Boolean legal(const String& name);
  

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