Changes between Initial Version and Version 1 of code/doc/SubclassIdentifier

Timestamp:

Feb 25, 2008, 12:14:47 AM (17 years ago)

Author:

landauf

Comment:

—

code/doc/SubclassIdentifier

@@ +1 @@
+= !SubclassIdentifier =
+
+== Description ==
+
+The [wiki:SubclassIdentifier] acts like an [wiki:Identifier]. You can assign a [wiki:ClassIdentifier] and compare it with other [wiki:Identifier Identifiers] by using isA(...), isChildOf(...) and other functions.
+
+[wiki:SubclassIdentifier] is a template. The template-class defines the needed base-class of an assigned Identifier. You can only assign [wiki:Identifier Identifiers] representing a class which is derived from the given base-class (or the base-class itself). If you try to assign an Identifier that's not derived from the base-class, you get an error.
+
+== Examples ==
+
+The following examples use the class-tree below.
+
+{{{
+#!cpp
+SubclassIdentifier<A1> myidentifier = Class(A1);             // This works
+SubclassIdentifier<A1> myidentifier = Class(A1B1);           // This works
+SubclassIdentifier<A1> myidentifier = Class(A1B1C1);         // This works
+SubclassIdentifier<A1> myidentifier = Class(BaseObject);     // This doesn't work
+SubclassIdentifier<A1> myidentifier = Class(A3);             // This doesn't work
+
+
+SubclassIdentifier<Interface1> myidentifier = Class(A3);     // This works
+SubclassIdentifier<Interface1> myidentifier = Class(A2B2C1); // This works
+
+
+SubclassIdentifier<A1> myidentifier = Class(A1B1);
+myidentifier.isExactlyA(Class(A1));       // Returns false
+myidentifier.isExactlyA(Class(A1B1));     // Returns true
+(*myidentifier)->getName();               // Returns "A1B1"
+myidentifier->getName();                  // Returns "A1B1" (And yes, the "->" is correct. It's overloaded.)
+
+A1* newobject = myidentifier.fabricate(); // Returns a new instance of A1B1, downcasted to A1
+}}}
+
+[[Image(Core:testclass_interface_tree.gif)]]