Функции обработки массивов
array -- Создает массив Описание
array array (...);
Возвращает массив параметров. Параметры могут быть даныпо индексу при использовании опрератора => .
Помните что array() - это языковая конструкция, и не является регулярным выражением.
Следующий пример демонстрирует как создавать двумерный массив, как определять ключи для ассоциативного массива, и как в пропускать-и-продолжать числовые индексы в нормальном массиве. Пример 1.
Code
array() $fruits = array( "fruits" => array("a"=>"orange","b"=>"banana","c"=>"apple"), "numbers" => array(1, 2, 3, 4, 5, 6) "holes" => array("first", 5 => "second", "third") );
array_walk -- Применение функции на каждого члена массива.
Описание
Code
int array_walk (array arr, string func);
Применяет функцию с именем func для каждого элемента массива arr . Элементы проходят как первый аргумент функции func ; если func требует больше чем один аргумент, будет сгенерировано предупреждение всякий раз, когда array_walk() вызывает func . Эти предупреждения могут подавляться добавлением знака '@' при вызове array_walk() , или при использовании error_reporting() .
Помните, что func будет работать с елементами массива arr , так что все изменения сделанные над элементами массива будут изменениями для самого массива. Пример 1.
Code
array_walk() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); function test_alter( $item1 ) { $item1 = 'bogus'; } function test_print( $item2 ) { echo "$item2<br>\n"; } array_walk( $fruits, 'test_print' ); array_walk( $fruits, 'test_alter' ); array_walk( $fruits, 'test_print' );
arsort -- Сортировка массива в обратном порядке и поддерка индексных связей.
Описание
void arsort (array array);
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которыми они связываются. Это используется, главным образом, для сортировки ассоциативных массивов, где имеет значение фактический элементный порядок. Пример 1.
Code
arsort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); arsort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; }
Пример нам покажет: fruits[a] = orange fruits[d] = lemon fruits = banana fruits[c] = apple Фрукты показаны в обратном алфавитном порядке, и поддерживаются связанные с ними индексы.
asort -- Сортирует массив и поддерживает связанные индексы
[b]Описание
void asort (array array);
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которыми они связываются. Это используется, главным образом, для сортировки ассоциативных массивов, где имеет значение фактический элементный порядок Пример 1.
Code
asort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); asort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; }
Этот пример покажет: fruits[c] = apple fruits = banana fruits[d] = lemon fruits[a] = orange Фрукты показаны в алфавитном порядке, и поддерживаются индексы связанные с каждым элементом массива.
count -- подсчитывает элементы в переменную
[b]Описание
int count (mixed var);
Возвращает число элементов в var , который является естественно массивом (что либо другое будет иметь один элемент).
возвращает 0 если переменная не укстановлена.
возвражает 1 если переменная не является массивом.
current -- возвращает текущий элемент массива
Описание
mixed current (array array);
Каждая переменная-массив имеет внутренний указатель, который указывает на один из своих элементов. Кроме того, все элементы в массиве связываются двунаправленным списком указателей для дополнительных целей. Внутренний указатель указывает на первый элемент, который включался в массив пока Вы не выполняли одну из функций, которые модифицируют этот указатель в этом массиве.
Функция current() просто возвращает элемент массива, на который в данный момент указывает внутренний указатель. Он никак не перемещает указатель. Если внутренний указатель указывает на конец списка элементов, current() возвращает false(ложно).
Внимание: если массив содержит пустые элементы (0 или "", пустую строку), то функция возвратит "false" для каждого из них. Это показывает, что текущий элемент является нулевым значением или вы дошли до конца массива. Для того, чтобы правильно просматривать массив, используйте функцию each() .
each -- возвращает следующую пару ключ/значение из массива
Описание
array each (array array);
Возвращает следующую пару ключ/значение из массива array и предоставляет курсор массива. Эта пара возвращается в четырех-элементный массив, с ключами 0 , 1 , key , и value . Элементы 0 и key - каждое содержит ключевое имя элемента массива, а 1 и value содержат данные. Пример 1. each() $foo = array( "bob", "fred", "jussi", "jouni" ); $bar = each( $foo );
$bar теперь содержит следующие пары ключ/значение:
Code
0 => 0
1 => 'bob'
key => 0
value => 'bob'
$foo = array( "Robert" => "Bob", "Seppo" => "Sepi" ); $bar = each( $foo );
$bar теперь содержит следующие пары ключ/значение:
0 => 'Robert'
1 => 'Bob'
key => 'Robert'
value => 'Bob'
each() , как правило, используется вместе с list() чтобы просмотреть массив; например, $HTTP_POST_VARS: Пример 2. Просмотр
Code
$HTTP_POST_VARS с помощью each() echo "Values submitted via POST method:<br>"; while ( list( $key, $val ) = each( $HTTP_POST_VARS ) ) { echo "$key => $val<br>"; }
end -- устанавливаете внутренний указатель массива на последнем элементе
Описание
end (array array);
end() перемещает array 's внутренний указатель на последний элемент массива.
key -- выбирает ключ из ассоциативного массива
Описание
mixed key (array array);
key() Возвращает индекс элемента в текущей позиции массива
ksort -- Сортирует массив по ключам.
Описание
int ksort (array array);
Сортирует массив по ключу, используя ключ для корреляциях данных. Это полезно главным образом для ассоциативного массива. Пример 1.
Code
ksort() $fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple"); ksort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; }
Этот пример должен показать: fruits[a] = orange fruits = banana fruits[c] = apple fruits[d] = lemon
list -- Связывает переменные, как если бы они были массивом.
[b]Описание
void list (...);
Подобно array() , функция list в действительностью является языковой конструкцией а не функцией list() используется для связи списка переменных одной операцией. Пример 1.
Code
list() <table> <tr> <th>Employee name</th> <th>Salary</th> </tr> <?php $result = mysql($conn, "SELECT id, name, salary FROM employees"); while (list($id, $name, $salary) = mysql_fetch_row($result)) { print(" <tr>\n". " <td><a href=\"info.php3?id=$id\">$name</a></td>\n". " <td>$salary</td>\n". " </tr>\n"); } ?></table>
next -- передвигает внутренний указатель массива
Описание
mixed next (array array);
Возвращает следующий элемент массива, от текущей позиции внутреннего указателя массива, или "ложь"(false) если нет больше элементов. Внимание: если массив содержит пустые элементы, тогда эта функция возвратит "ложь"(false) и для этих элементов. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each() .
next() ведет себя подобно current() , с одной лишь разницей. Он передвигает внутренний указатель массива на один элемент вперед прежде, чем возвратить элемент. Это означает что он возвращает значение следующего элемента и передвигает на него внутренний указатель массива. Если при обращении к следующему элементу обнаружен конец массива - next() возвращает "ложь"(false).
pos -- Возвращает текущий элемент в массиве
Описание
mixed pos (array array);
Это - псевдоним для current() .
prev -- перемещает внутренний указатель массива
Описание
mixed prev (array array);
Возвращает предыдущий элемент массива, или "ложь"(false), если перед текущим нет больше элементов. Внимание: если массив содержит пустые элементы, то функция возвратит "ложь" и на этих элементах. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each() .
prev() ведет себя подобно next() , за исключением того что он переводит внутренний указатель массива на одну позицию назад, а не вперед.
reset -- устанавливает внутренний указатель массива в первом элементе
Описание
mixed reset (array array);
reset() возвращает внутренний указатель массива в первый элемент.
reset() возвращает первыйэлемент массива.
rsort -- Сортирует массив в обратном порядке
Описание
void rsort (array array);
Сортирует массив в обратном порядке (по убыванию). Пример 1.
Code
rsort() $fruits = array("lemon","orange","banana","apple"); rsort($fruits); for(reset($fruits); ($key,$value) = each($fruits); ) { echo "fruits[$key] = ".$value."\n"; }
Этот пример покажет: fruits[0] = orange fruits[1] = lemon fruits[2] = banana fruits[3] = apple Фрукты отсортированы в обратном алфавитном порядке.
sizeof -- получает размер массива
Описание
int sizeof (array array);
Возвращает число элементов списка.
sort -- сортирует массив
Описание
void sort (array array);
Эта функция сортирует масси - все элементы по окончании ее работы будут расположены по возрастанию. Пример 1.
Code
sort() $fruits = array("lemon","orange","banana","apple"); sort($fruits); for(reset($fruits); $key = key($fruits); next($fruits)) { echo "fruits[$key] = ".$fruits[$key]."\n"; }
Этот пример покажет: fruits[0] = apple fruits[1] = banana fruits[2] = lemon fruits[3] = orange Фрукты будут отсортированы повозрастанию в алфавитном порядке.
uasort -- Сортирует массив с использованием функций сравнения, определенных пользователем и поддержкой индексации
Описание
void uasort (array array, function cmp_function);
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которой они связываются. Т. е. при такой сортировке используются индексы. функции сравнения задает пользователь.
uksort -- Сортирует массив по ключам, с использованием функций сравнения, определенных пользователем
Описание
void uksort (array array, function cmp_function);
Эта функция отсортирует ключи массива используя функции сравнения, определенные пользователем. Если массив, который Вы хотите отсортировать, должен сортироваться некоторыми не-тривиальными критериями, Вы должны использовать эту функцию. Пример 1. uksort() function mycompare($a, $b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array(4 => "four", 3 => "three", 20 => "twenty", 10 => "ten"); uksort($a, mycompare); while(list($key, $value) = each($a)) { echo "$key: $value\n"; }
Пример покажет: 20: twenty 10: ten 4: four 3: three
usort -- сортирует массив по значениям используя используя функции сравнения, определенные пользователем
Описание
void usort (array array, function cmp_function);
Эта функция отсортирует массив по значениям используя используя функции сравнения, определенные пользователем. Если массив, который Вы хотите отсортировать должен сортироваться по некоторым не-тривиальным критериям, Вы должны использовать эту функцию. Пример 1.
Code
usort() function cmp($a,$b) { if ($a == $b) return 0; return ($a > $b) ? -1 : 1; } $a = array(3,2,5,6,1); usort($a, cmp); while(list($key,$value) = each($a)) { echo "$key: $value\n"; }
