+ $this->setGenericArrayKey('registry', 'instance', $instanceKey, $objectInstance);
+ }
+
+ /**
+ * Getter for whole instance registry
+ *
+ * @return $instanceRegistry The whole instance registry array
+ */
+ public final function getInstanceRegistry () {
+ return $this->getGenericSubArray('registry', 'instance');
+ }
+
+ /**
+ * Adds a new entry to the given list name. If you want to add objects
+ * please use addInstance() and getInstance() instead.
+ *
+ * @param $key The key to identify the whole list
+ * @param $value The value to be stored
+ * @return void
+ */
+ public final function addEntry ($key, $value) {
+ // Key must not be an array
+ assert(!is_array($key));
+
+ // Push it
+ $this->pushValueToGenericArrayKey('raw', 'generic', $key, $value);
+ }
+
+ /**
+ * Getter for entries or "sub entries"
+ *
+ * @return $entries An array with entries from this registry
+ */
+ public final function getEntries ($key = NULL) {
+ // Key must not be an array
+ assert(!is_array($key));
+
+ // Default is whole array
+ $entries = $this->getGenericArray('raw');
+
+ // Is $key set?
+ if (!is_null($key)) {
+ // Then use this entry
+ $entries = $this->getGenericArrayKey('raw', 'generic', $key);
+ } // END - if
+
+ // Return the array
+ return $entries;
+ }
+
+ /**
+ * "Getter" for an array of all entries for given key
+ *
+ * @param $arrayKey The array (key) to look in
+ * @param $lookFor The key to look for
+ * @return $entry An array with all keys
+ */
+ public function getArrayFromKey ($arrayKey, $lookFor) {
+ // Key must not be an array
+ assert(!is_array($arrayKey));
+
+ // Init array
+ $entry = array();
+
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Checking arrayKey=' . $arrayKey . ',lookFor=' . $lookFor);
+
+ // "Walk" over all entries
+ foreach ($this->getEntries($arrayKey) as $key => $value) {
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Checking key=' . $key . ',value=' . $value . ',lookFor=' . $lookFor);
+
+ // If $value matches the $lookFor, we need to look for more entries for this!
+ if ($lookFor == $value) {
+ // Look for more entries
+ foreach ($this->getEntries() as $key2 => $value2) {
+ // Now "walk" through all entries, if an array is returned
+ if (is_array($value2)) {
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Checking key2=' . $key2 . ',value2()=' . count($value2) . ',lookFor=' . $lookFor);
+
+ // "Walk" through all of them
+ foreach ($value2 as $key3 => $value3) {
+ // $value3 needs to be an array
+ assert(is_array($value3));
+
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Checking key=' . $key . ',key3=' . $key3 . ',isset()=' . isset($value3[$key]) . ' ...');
+
+ // Both keys must match!
+ if (($key == $key3) || (isset($value3[$key]))) {
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Adding ' . $value3[$key] . ' ...');
+
+ // Then add it
+ $entry[$key3] = $value3[$key];
+ } // END - if
+ } // END - foreach
+ } // END - if
+ } // END - foreach
+
+ // Skip further lookups
+ break;
+ } // END - if
+ } // END - foreach
+
+ // Debug message
+ //* DEBUG: */ self::createDebugInstance(__CLASS__)->debugOutput('REGISTRY[' . __METHOD__ . ':' . __LINE__ . ']: Returning entry(' . count($entry) . ')=' . print_r($entry, TRUE));
+
+ // Return it
+ return $entry;