Changeset 1664 for trunk/system/libraries/URI.php

Timestamp:

01/02/2008 04:32:55 PM (12 months ago)

Author:

gregmac

Message:

Add argument(), argument_array(), total_arguments() methods to URI

Files:

• trunk/system/libraries/URI.php (modified) (3 diffs)

trunk/system/libraries/URI.php

@@ -69 +69 @@
                 return isset(self::$rsegments[$index]) ? self::$rsegments[$index] : $default;
         }
+        
+        /**
+         * Method: argument
+         *  Retrieve a specific URI argument. This is the part of the segments that does not indicate controller
+         *  or method
+         *
+         * Parameters:
+         *  index   - argument number or label
+         *  default - default value returned if segment does not exist
+         *
+         * Returns:
+         *   Value of segment
+         */
+        public function argument($index = 1, $default = FALSE)
+        {
+                if (is_string($index))
+                {
+                        if (($key = array_search($index, self::$arguments)) === FALSE)
+                                return $default;
+
+                        $index = $key + 2;
+                }
+
+                $index = (int) $index - 1;
+
+                return isset(self::$arguments[$index]) ? self::$arguments[$index] : $default;
+        }
 
         /**
@@ -129 +156 @@
                 return $segment_array_assoc;
         }
-
+        
+        /**
+         * Method: argument_array
+         *  Returns an array containing all the URI arguments.
+         *
+         * Parameters:
+         *  offset      - segment offset
+         *  associative - return an associative array
+         *
+         * Returns:
+         *   Array of URI segment arguments
+         */
+        public function argument_array($offset = 0, $associative = FALSE)
+        {
+                $argument_array = self::$arguments;
+                array_unshift($argument_array, 0);
+                $argument_array = array_slice($argument_array, $offset + 1, $this->total_arguments(), TRUE);
+
+                if ( ! $associative)
+                        return $argument_array;
+
+                $argument_array_assoc = array();
+
+                foreach (array_chunk($argument_array, 2) as $pair)
+                {
+                        $argument_array_assoc[$pair[0]] = isset($pair[1]) ? $pair[1] : '';
+                }
+
+                return $argument_array_assoc;
+        }
+        
         /**
          * Method: string
@@ -176 +233 @@
         {
                 return count(self::$rsegments);
+        }
+        
+        /**
+         * Method: total_arguments
+         *  Returns the total number of URI arguments.
+         *
+         * Returns:
+         *   Total number of URI arguments
+         */
+        public function total_arguments()
+        {
+                return count(self::$arguments);
         }