Fonctions membres publiques statiques
static	toInteger ($array, $default=null)

static	toObject (array $array, $class='stdClass', $recursive=true)

static	toString (array $array, $innerGlue='=', $outerGlue=' ', $keepOuterKey=false)

static	fromObject ($source, $recurse=true, $regex=null)

static	addColumn (array $array, array $column, $colName, $keyCol=null)

static	dropColumn (array $array, $colName)

static	getColumn (array $array, $valueCol, $keyCol=null)

static	getValue ($array, $name, $default=null, $type='')

static	invert (array $array)

static	isAssociative ($array)

static	pivot (array $source, $key=null)

static	sortObjects (array $a, $k, $direction=1, $caseSensitive=true, $locale=false)

static	arrayUnique (array $array)

static	arraySearch ($needle, array $haystack, $caseSensitive=true)

static	flatten ($array, $separator='.', $prefix='')

Fonctions membres privées
	__construct ()

Fonctions membres privées statiques
static	arrayFromObject ($item, $recurse, $regex)

Description détaillée

ArrayHelper is an array utility class for doing all sorts of odds and ends with arrays.

Depuis: 1.0

Documentation des constructeurs et destructeur

◆ __construct()

__construct ( )

private

Private constructor to prevent instantiation of this class

Depuis: 1.0

Documentation des fonctions membres

◆ addColumn()

static addColumn	(	array	$array,
		array	$column,
			$colName,
			$keyCol = `null`
	)

static

Adds a column to an array of arrays or objects

Paramètres

array	$array	The source array
array	$column	The array to be used as new column
string	$colName	The index of the new column or name of the new object property
string	$keyCol	The index of the column or name of object property to be used for mapping with the new column

Renvoie: array An array with the new column added to the source array

Depuis: 1.5.0

Voir également: https://www.php.net/manual/en/language.types.array.php

Références $i, $item, $subject, $value, et null.

◆ arrayFromObject()

static arrayFromObject	(	$item,
		$recurse,
		$regex
	)

staticprivate

Utility function to map an object or array to an array

Paramètres

mixed	$item	The source object or array
boolean	$recurse	True to recurse through multi-level objects
string	$regex	An optional regular expression to match on field names

Renvoie: array

Depuis: 1.0

Références $item.

◆ arraySearch()

static arraySearch	(		$needle,
		array	$haystack,
			$caseSensitive = `true`
	)

static

An improved array_search that allows for partial matching of strings values in associative arrays.

Paramètres

string	$needle	The text to search for within the array.
array	$haystack	Associative array to search in to find $needle.
boolean	$caseSensitive	True to search case sensitive, false otherwise.

Renvoie: mixed Returns the matching array $key if found, otherwise false.

Depuis: 1.0

Références $key, et $value.

◆ arrayUnique()

static arrayUnique ( array $array )

static

Multidimensional array safe unique test

Paramètres

array $array The array to make unique.

Renvoie: array

Voir également: https://www.php.net/manual/en/function.array-unique.php

Depuis: 1.0

◆ dropColumn()

static dropColumn	(	array	$array,
			$colName
	)

static

Remove a column from an array of arrays or objects

Paramètres

array	$array	The source array
string	$colName	The index of the column or name of object property to be removed

Renvoie: array Column of values from the source array

Depuis: 1.5.0

Voir également: https://www.php.net/manual/en/language.types.array.php

Références $i, $item, et elseif.

Référencé par PlgPrivacyUser\createNotesDomain().

◆ flatten()

static flatten	(	$array,
		$separator = `'.'`,
		$prefix = `''`
	)

static

Method to recursively convert data to a one dimension array.

Paramètres

array \| object	$array	The array or object to convert.
string	$separator	The key separator.
string	$prefix	Last level key prefix.

Renvoie: array

Depuis: 1.3.0

Note: As of 2.0, the result will not include the original array structure

Références $key, $prefix, $separator, et elseif.

◆ fromObject()

static fromObject	(	$source,
		$recurse = `true`,
		$regex = `null`
	)

static

Utility function to map an object to an array

Paramètres

object	$source	The source object
boolean	$recurse	True to recurse through multi-level objects
string	$regex	An optional regular expression to match on field names

Renvoie: array

Depuis: 1.0

Référencé par AssociationExtensionHelper\getAssociationList(), et BaseDatabaseModel\loadHistory().

◆ getColumn()

static getColumn	(	array	$array,
			$valueCol,
			$keyCol = `null`
	)

static

Extracts a column from an array of arrays or objects

Paramètres

array	$array	The source array
string	$valueCol	The index of the column or name of object property to be used as value It may also be NULL to return complete arrays or objects (this is useful together with $keyCol to reindex the array).
string	$keyCol	The index of the column or name of object property to be used as key

Renvoie: array Column of values from the source array

Depuis: 1.0

Voir également: https://www.php.net/manual/en/language.types.array.php; https://www.php.net/manual/en/function.array-column.php

Références $item, $key, $subject, et $value.

Référencé par JAdminCssMenu\check().

◆ getValue()

static getValue	(	$array,
		$name,
		$default = `null`,
		$type = `''`
	)

static

Utility function to return a value from a named array or a specified default

Paramètres

array \| \ArrayAccess	$array	A named array or object that implements ArrayAccess
string	$name	The key to search for (this can be an array index or a dot separated key sequence as in Registry)
mixed	$default	The default value to give if no key found
string	$type	Return type for the variable (INT, FLOAT, STRING, WORD, BOOLEAN, ARRAY)

Renvoie: mixed

Depuis: 1.0

Exceptions

Références $default, $name, $type, elseif, et null.

Référencé par NewsfeedsControllerNewsfeed\allowAdd(), AdminModel\batch(), UsersModelUser\batch(), User\bind(), UsersControllerUsers\changeBlock(), JHtmlContentAdministrator\featured(), ModulesModelModule\getForm(), ConfigModelForm\loadForm(), FormModel\loadForm(), ListModel\loadForm(), PlgUserTerms\onUserAfterSave(), PlgUserTerms\onUserBeforeSave(), InstallerControllerUpdatesites\publish(), AdminController\publish(), MenusControllerItems\publish(), MenusControllerItems\setDefault(), et JHtmlMessages\status().

◆ invert()

static invert ( array $array )

static

Takes an associative array of arrays and inverts the array keys to values using the array values as keys.

Example: $input = array( 'New' => array('1000', '1500', '1750'), 'Used' => array('3000', '4000', '5000', '6000') ); $output = ArrayHelper::invert($input);

Output would be equal to: $output = array( '1000' => 'New', '1500' => 'New', '1750' => 'New', '3000' => 'Used', '4000' => 'Used', '5000' => 'Used', '6000' => 'Used' );

Paramètres

array $array The source array.

Renvoie: array

Depuis: 1.0

Références $base, $key, et $return.

◆ isAssociative()

static isAssociative ( $array )

static

Method to determine if an array is an associative array.

Paramètres

array $array An array to test.

Renvoie: boolean

Depuis: 1.0

Référencé par Form\bindLevel(), et Ini\objectToString().

◆ pivot()

static pivot	(	array	$source,
			$key = `null`
	)

static

Pivots an array to create a reverse lookup of an array of scalars, arrays or objects.

Paramètres

array	$source	The source array.
string	$key	Where the elements of the source array are objects or arrays, the key to pivot on.

Renvoie: array An array of arrays pivoted either on the value of the keys, or an individual key of an object or array.

Depuis: 1.0

Références $counter, $key, $value, et elseif.

Référencé par LanguageHelper\getContentLanguages(), et LanguageHelper\getInstalledLanguages().

◆ sortObjects()

static sortObjects	(	array	$a,
			$k,
			$direction = `1`,
			$caseSensitive = `true`,
			$locale = `false`
	)

static

Utility function to sort an array of objects on a given field

Paramètres

array	$a	An array of objects
mixed	$k	The key (string) or an array of keys to sort on
mixed	$direction	Direction (integer) or an array of direction to sort in [1 = Ascending] [-1 = Descending]
mixed	$caseSensitive	Boolean or array of booleans to let sort occur case sensitive or insensitive
mixed	$locale	Boolean or array of booleans to let sort occur using the locale language or not

Renvoie: array

Depuis: 1.0

Références $b, $count, $direction, $i, $key, et elseif.

Référencé par InstallerModel\_getList(), ModulesModelModules\_getList(), LanguageHelper\getContentLanguages(), LanguageHelper\getInstalledLanguages(), ModulesHelper\getModules(), JFormFieldComponentsCategory\getOptions(), JFormFieldComponents\getOptions(), JFormFieldConfigComponents\getOptions(), JFormFieldContentTypes\getOptions(), JHtmlModules\positions(), et JAdminCssMenu\preprocess().

◆ toInteger()

static toInteger	(	$array,
		$default = `null`
	)

static

Function to convert array to integer values

Paramètres

array	$array	The source array to convert
int \| array	$default	A default value to assign if $array is not an array

Renvoie: array

Depuis: 1.0

Références $default, et null.

Référencé par RedirectModelLink\activate(), AdminModel\batch(), UsersModelUser\batch(), UsersModelUser\batchReset(), UsersModelUser\batchUser(), User\bind(), MenusModelMenu\delete(), ActionlogsModelActionlogs\delete(), RedirectModelLink\duplicateUrls(), Form\filterField(), Access\getGroupsByUser(), FinderModelSuggestions\getListQuery(), NewsfeedsModelNewsfeeds\getListQuery(), ActionlogsModelActionlogs\getLogDataQuery(), TagField\getOptions(), TagsHelper\getTagIds(), TagsHelper\getTagItemsQuery(), TagsHelper\getTagNames(), TagsHelper\getTypes(), Access\getUsersByGroup(), JHtmlTag\options(), UsersModelUsers\populateState(), TagsModelTag\populateState(), UsersTableNote\publish(), MessagesTableMessage\publish(), Extension\publish(), CoreContent\publish(), Nested\publish(), CategoriesModelCategory\save(), AdminModel\save(), MenusModelItem\save(), TagsHelper\searchTags(), UserHelper\setUserGroups(), JHtmlTag\tags(), et TagsHelper\unTagItem().

◆ toObject()

static toObject	(	array	$array,
			$class = `'stdClass'`,
			$recursive = `true`
	)

static

Utility function to map an array to a stdClass object.

Paramètres

array	$array	The array to map.
string	$class	Name of the class to create
boolean	$recursive	Convert also any array inside the main array

Renvoie: object

Depuis: 1.0

Références $class.

Référencé par InstallationModelFtp\detectFtpRoot(), ContentModelForm\getItem(), LanguagesModelLanguage\getItem(), MenusModelMenu\getItem(), TagsModelTag\getItem(), ModulesModelModule\getItem(), AdminModel\getItem(), InstallationModelConfiguration\setup(), et InstallationModelFtp\verifyFtpSettings().

◆ toString()

static toString	(	array	$array,
			$innerGlue = `'='`,
			$outerGlue = `' '`,
			$keepOuterKey = `false`
	)

static

Utility function to map an array to a string.

Paramètres

array	$array	The array to map.
string	$innerGlue	The glue (optional, defaults to '=') between the key and the value.
string	$outerGlue	The glue (optional, defaults to ' ') between array elements.
boolean	$keepOuterKey	True if final key should be kept.

Renvoie: string

Depuis: 1.0

Références $item, $key, et $output.

Référencé par HeadRenderer\fetchHead(), HTMLHelper\iframe(), HTMLHelper\image(), HTMLHelper\link(), et JHtmlForm\token().

La documentation de cette classe a été générée à partir du fichier suivant :

ArrayHelper.php

Fonctions membres publiques statiques

Fonctions membres privées

Fonctions membres privées statiques

Description détaillée

Documentation des constructeurs et destructeur

◆ __construct()

Documentation des fonctions membres

◆ addColumn()

◆ arrayFromObject()

◆ arraySearch()

◆ arrayUnique()

◆ dropColumn()

◆ flatten()

◆ fromObject()

◆ getColumn()

◆ getValue()

◆ invert()

◆ isAssociative()

◆ pivot()

◆ sortObjects()

◆ toInteger()

◆ toObject()

◆ toString()