diff --git a/reference/array/functions/array-change-key-case.xml b/reference/array/functions/array-change-key-case.xml new file mode 100644 index 000000000..ebc254ecb --- /dev/null +++ b/reference/array/functions/array-change-key-case.xml @@ -0,0 +1,71 @@ + + + + + + array_change_key_case + Возвращает массив, символьные ключи которого преобразованы в верхний или нижний регистр символов + + + Описание + + массивarray_change_key_case + массивисходный_массив + целоерегистр_символов + + + Функция array_change_key_case преобразует + ключи массива исходный_массив в верхний или + нижний регистр символов. Тип преобразования зависит от + последнего опционального параметра регистр_символов. + В качестве этого параметра вы можете передать + одну из двух констант: + CASE_UPPER и + CASE_LOWER. По умолчанию используется + CASE_LOWER. Эта функция не изменяет + ключи, состоящие из чисел. + + + Пример использования <function>array_change_key_case</function> + + 1, "SecOnd" => 4); +print_r(array_change_key_case($input_array, CASE_UPPER)); +]]> + + + Результатом выполнения вышеприведенной программы будет: + + 1 + [SECOND] => 2 +) +]]> + + + + + + + diff --git a/reference/array/functions/array-chunk.xml b/reference/array/functions/array-chunk.xml new file mode 100644 index 000000000..d20b822b2 --- /dev/null +++ b/reference/array/functions/array-chunk.xml @@ -0,0 +1,112 @@ + + + + + + array_chunk + Разбить массив на части + + + Описание + + массивarray_chunk + массивисходный_массив + целоеразмер + логическоесохранять_ключи + + + Функция array_chunk разбивает массив + на несколько массивов размером размер значений. + Последний массив из полученных может содержать меньшее + количество значений, чем указано. В качестве результата + функция возвращает многоразмерный массив с индексами, начинающимися + с нуля и элементами, которыми являются массивы, полученные в + результате разбивки. + + + Если вы передадите значение &true; в качестве необязательного параметра + preserve_keys, PHP сохранит ключи из + исходного массива. Если значение этого параметра равно &false;, + элементы результирующих массивов будут проиндексированы + числами, начиная с нуля. По умолчанию используется значение &false;. + + + Пример использования <function>array_chunk</function> + + + + + Результатом выполнения вышеприведенной программы будет: + + Array + ( + [0] => a + [1] => b + ) + + [1] => Array + ( + [0] => c + [1] => d + ) + + [2] => Array + ( + [0] => e + ) + +) +Array +( + [0] => Array + ( + [0] => a + [1] => b + ) + + [1] => Array + ( + [2] => c + [3] => d + ) + + [2] => Array + ( + [4] => e + ) + +) +]]> + + + + + + + diff --git a/reference/array/functions/array-count-values.xml b/reference/array/functions/array-count-values.xml new file mode 100644 index 000000000..e2ae4c000 --- /dev/null +++ b/reference/array/functions/array-count-values.xml @@ -0,0 +1,66 @@ + + + + + + array_count_values + Подсчитать количество всех значений массива + + + Описание + + массивarray_count_values + массивисходный_массив + + + Функция array_count_values возвращает массив, + ключами которого являются значения массива исходный_массив, + а значениями - частота повторения этих значений. + + + + Пример использования <function>array_count_values</function> + + + + + Результатом вышеприведенной программы будет: + + 2 + [hello] => 2 + [world] => 1 +) +]]> + + + + + + + + diff --git a/reference/array/functions/array-diff.xml b/reference/array/functions/array-diff.xml new file mode 100644 index 000000000..3d667322b --- /dev/null +++ b/reference/array/functions/array-diff.xml @@ -0,0 +1,92 @@ + + + + + + array_diff + Вычислить расхождение в массивах + + + Описание + + массивarray_diff + массивмассив_1 + массивмассив_2 + массив ... + + + Функция array_diff возвращает массив, + состоящий из значений массива массив_1, + которые отсутствуют в любом другом массиве, перечисленном + в последующих аргументах. Обратите внимание, что ключи + массивов сохраняются. + + + + Пример использования <function>array_diff</function> + + "green", "red", "blue", "red"); +$array2 = array ("b" => "green", "yellow", "red"); +$result = array_diff ($array1, $array2); +]]> + + + + + В результате выполнения этой программы переменная + $result будет содержать + array ("blue");. Повторения одного + и того же значения в $array1 обрабатываются как одно значение. + + + + Два элемента считаются одинаковыми если и только если + (string) $elem1 === (string) $elem2. Другими словами, + когда их строковое представление идентично. + + + + + + Обратите внимание, что эта функция обрабатывает только одно измерение + n-размерного массива. Естественно, вы можете обрабатывать и более + глубокие уровни вложенности, например, используя + array_diff($array1[0], $array2[0]);. + + + + + + + + + + См.также array_intersect. + + + + + diff --git a/reference/array/functions/array-fill.xml b/reference/array/functions/array-fill.xml new file mode 100644 index 000000000..fe4db21eb --- /dev/null +++ b/reference/array/functions/array-fill.xml @@ -0,0 +1,71 @@ + + + + + + array_fill + Заполнить массив определенным значением + + + Описание + + массивarray_fill + целоеначальный_индекс + целоеколичество + смешанноезначение + + + Функция array_fill возвращает массив, + содержащий количество элементов, имеющих + значение параметра значение. Нумерация ключей элементов + массива начинаются со значения параметра начальный_индекс parameter. + + + + Пример использования <function>array_fill</function> + + + + + Переменная $a теперь содержит следующие значения (вывод функции print_r): + + banana + [6] => banana + [7] => banana + [8] => banana + [9] => banana + [10] => banana +) +]]> + + + + + + + + diff --git a/reference/array/functions/array-filter.xml b/reference/array/functions/array-filter.xml new file mode 100644 index 000000000..3937da18c --- /dev/null +++ b/reference/array/functions/array-filter.xml @@ -0,0 +1,106 @@ + + + + + + array_filter + + Применяет фильтр к массиву, используя функцию обратного вызова + + + + Описание + + массивarray_filter + массивисходный_массив + смешанноефункция + + + Функция array_filter возвращает массив, + содержащий значения массива исходный_массив, + отфильтрованные в соответствии с результатом функции обратного вызова. + Если исходный_массив является ассоциативным + массивом, его ключи сохраняются. + + + + Пример использования <function>array_filter</function> + +1, "b"=>2, "c"=>3, "d"=>4, "e"=>5); +$array2 = array (6, 7, 8, 9, 10, 11, 12); + +echo "Нечетные :\n"; +print_r(array_filter($array1, "odd")); +echo "Четные :\n"; +print_r(array_filter($array2, "even")); +]]> + + + Результатом выполнения вышеприведенной программы будет: + + 1 + [c] => 3 + [e] => 5 +) +Четные : +Array +( + [0] => 6 + [2] => 8 + [4] => 10 + [6] => 12 +) +]]> + + + + + ¬e.func-callback; + + Пользователи не должны изменять массив в результате + его обработки функцией обратного вызова, например, + добавлять или удалять элемент или обнулять массив, + обрабатываемый функцией array_filter. Если + массив подвергается изменениям, поведение этой функции + становится неопределенным. + + + См.также array_map и + array_reduce. + + + + + diff --git a/reference/array/functions/array-flip.xml b/reference/array/functions/array-flip.xml new file mode 100644 index 000000000..d3a593029 --- /dev/null +++ b/reference/array/functions/array-flip.xml @@ -0,0 +1,93 @@ + + + + + + array_flip + Поменять местами значения массива + + + Описание + + массивarray_flip + массивисходный_массив + + + Функция array_flip возвращает массив в + обратном порядке, то есть ключи массива исходный_массив становятся значениями, + а значения массива исходный_массик становятся ключами. + + + Обратите внимание, что значения массива исходный_массив + должны быть корректными ключами, то есть они должны иметь тип + целое или строка. + Если значение имеет неверный тип, будет выдано предупреждение + и пара ключ/значение не будет обработана. + + + Если значение встречается несколько раз, для обработки + будет использоваться последний встреченный ключ, а + все остальные будут потеряны. + + + Функция array_flip возвращает &false;, + если обработка массива вызвала ошибку. + + + + Пример использования <function>array_flip</function> + + + + + + + + Пример использования <function>array_flip</function>: многократное повторение значения + + 1, "b" => 1, "c" => 2); +$trans = array_flip ($trans); +print_r($trans); +]]> + + + теперь $trans содержит: + + b + [2] => c +) +]]> + + + + + + + + diff --git a/reference/array/functions/array-intersect.xml b/reference/array/functions/array-intersect.xml new file mode 100644 index 000000000..79af69aa5 --- /dev/null +++ b/reference/array/functions/array-intersect.xml @@ -0,0 +1,89 @@ + + + + + + array_intersect + Вычислить схождение массивов + + + Описание + + массивarray_intersect + массивмассив_1 + массивмассив_2 + array ... + + + Функция array_intersect возвращает массив, + содержащий значения массива массив_1, + которые содержат все перечисленные в аргументах массивы. + Обратите внимание, что ключи сохраняются. + + + + Пример использования <function>array_intersect</function> + + "green", "red", "blue"); +$array2 = array ("b" => "green", "yellow", "red"); +$result = array_intersect ($array1, $array2); +]]> + + + В результате выполнения переменная $result будет содержать + + green + [0] => red +) +]]> + + + + + + + Два элемента считаются одинаковыми тогда и только тогда, когда + (string) $elem1 === (string) $elem2. Другими словами, + когда их строковые представления идентичны. + + + + + + + + + + + См.также array_diff. + + + + + diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml new file mode 100644 index 000000000..33c690b60 --- /dev/null +++ b/reference/array/functions/array-key-exists.xml @@ -0,0 +1,65 @@ + + + + + + array_key_exists + Проверить, присутствует ли в массиве указанный ключ или индекс + + + Описание + + логическоеarray_key_exists + смешанноеключ + массивисходный_массив + + + Функция array_key_exists возвращает &true;, если + в массиве присутствует указанное значение ключ. + Параметр ключ может быть любым значением, + которое подходит для описания индекса массива. + + + + Пример использования <function>array_key_exists</function> + + 1, "second" => 4); +if (array_key_exists("first", $search_array)) { + echo "The 'first' element is in the array"; +} +]]> + + + + + + В PHP версии 4.0.6 название этой функции - key_exists. + + + + См.также isset. + + + + + diff --git a/reference/array/functions/array-keys.xml b/reference/array/functions/array-keys.xml new file mode 100644 index 000000000..3cbe35d0e --- /dev/null +++ b/reference/array/functions/array-keys.xml @@ -0,0 +1,117 @@ + + + + + + array_keys + Выбрать все ключи массива + + + Описание + + массивarray_keys + массивисходный_массив + смешанное + значение_для_поиска + + + + Функция array_keys возвращает числовые и строковые ключи, + содержащиеся в массиве исходный_массив. + + + Если указан необязательный параметр значение_для_поиска, + функция возвращает только ключи, совпадающие с этим параметром. В обратном + случае, функция возвращает все ключи массива исходный_массив. + + + + Пример использования <function>array_keys</function> + + 100, "color" => "red"); +print_r(array_keys ($array)); + +$array = array ("blue", "red", "green", "blue", "blue"); +print_r(array_keys ($array, "blue")); + +$array = array ("color" => array("blue", "red", "green"), "size" => array("small", "medium", "large")); +print_r(array_keys ($array)); +]]> + + + Результатом выполнения вышеприведенной программы будет: + + 0 + [1] => color +) +Array +( + [0] => 0 + [1] => 3 + [2] => 4 +) +Array +( + [0] => color + [1] => size +) +]]> + + + + + + + Эта функция появилась в PHP 4. Ниже приведен ее эквивалент для + PHP 3. + + + Эквивалент функции <function>array_keys</function> в PHP 3 + + + + + + + + + См.также array_values. + + + + +