summaryrefslogtreecommitdiffstats
path: root/user_guide_src/source/helpers/array_helper.rst
diff options
context:
space:
mode:
Diffstat (limited to 'user_guide_src/source/helpers/array_helper.rst')
-rw-r--r--user_guide_src/source/helpers/array_helper.rst133
1 files changed, 0 insertions, 133 deletions
diff --git a/user_guide_src/source/helpers/array_helper.rst b/user_guide_src/source/helpers/array_helper.rst
deleted file mode 100644
index d6b48773f..000000000
--- a/user_guide_src/source/helpers/array_helper.rst
+++ /dev/null
@@ -1,133 +0,0 @@
-############
-Array Helper
-############
-
-The Array Helper file contains functions that assist in working with
-arrays.
-
-.. contents::
- :local:
-
-.. raw:: html
-
- <div class="custom-index container"></div>
-
-Loading this Helper
-===================
-
-This helper is loaded using the following code::
-
- $this->load->helper('array');
-
-
-Available Functions
-===================
-
-The following functions are available:
-
-
-.. php:function:: element($item, $array[, $default = NULL])
-
- :param string $item: Item to fetch from the array
- :param array $array: Input array
- :param bool $default: What to return if the array isn't valid
- :returns: NULL on failure or the array item.
- :rtype: mixed
-
- Lets you fetch an item from an array. The function tests whether the
- array index is set and whether it has a value. If a value exists it is
- returned. If a value does not exist it returns NULL, or whatever you've
- specified as the default value via the third parameter.
-
- Example::
-
- $array = array(
- 'color' => 'red',
- 'shape' => 'round',
- 'size' => ''
- );
-
- echo element('color', $array); // returns "red"
- echo element('size', $array, 'foobar'); // returns "foobar"
-
-
-.. php:function:: elements($items, $array[, $default = NULL])
-
- :param string $item: Item to fetch from the array
- :param array $array: Input array
- :param bool $default: What to return if the array isn't valid
- :returns: NULL on failure or the array item.
- :rtype: mixed
-
- Lets you fetch a number of items from an array. The function tests
- whether each of the array indices is set. If an index does not exist it
- is set to NULL, or whatever you've specified as the default value via
- the third parameter.
-
- Example::
-
- $array = array(
- 'color' => 'red',
- 'shape' => 'round',
- 'radius' => '10',
- 'diameter' => '20'
- );
-
- $my_shape = elements(array('color', 'shape', 'height'), $array);
-
- The above will return the following array::
-
- array(
- 'color' => 'red',
- 'shape' => 'round',
- 'height' => NULL
- );
-
- You can set the third parameter to any default value you like.
- ::
-
- $my_shape = elements(array('color', 'shape', 'height'), $array, 'foobar');
-
- The above will return the following array::
-
- array(     
- 'color' => 'red',
- 'shape' => 'round',
- 'height' => 'foobar'
- );
-
- This is useful when sending the ``$_POST`` array to one of your Models.
- This prevents users from sending additional POST data to be entered into
- your tables.
-
- ::
-
- $this->load->model('post_model');
- $this->post_model->update(
- elements(array('id', 'title', 'content'), $_POST)
- );
-
- This ensures that only the id, title and content fields are sent to be
- updated.
-
-
-.. php:function:: random_element($array)
-
- :param array $array: Input array
- :returns: A random element from the array
- :rtype: mixed
-
- Takes an array as input and returns a random element from it.
-
- Usage example::
-
- $quotes = array(
- "I find that the harder I work, the more luck I seem to have. - Thomas Jefferson",
- "Don't stay in bed, unless you can make money in bed. - George Burns",
- "We didn't lose the game; we just ran out of time. - Vince Lombardi",
- "If everything seems under control, you're not going fast enough. - Mario Andretti",
- "Reality is merely an illusion, albeit a very persistent one. - Albert Einstein",
- "Chance favors the prepared mind - Louis Pasteur"
- );
-
- echo random_element($quotes); \ No newline at end of file