Руководство по РНР 3.0 - Функции обработки массивов
array
array -- Создает массив
Описание
Возвращает массив параметров. Параметры могут быть даныпо индексу при использовании опрератора =>.
Помните что array() - это языковая конструкция, и не является регулярным выражением.
Следующий пример демонстрирует как создавать двумерный массив, как определять ключи для ассоциативного массива, и как в пропускать-и-продолжать числовые индексы в нормальном массиве.
Пример 1. 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")
); |
См. также:
list() .
array_walk
array_walk -- Применение функции на каждого члена массива.
Описание
int array_walk(array arr, string func);
Применяет функцию с именем func для каждого элемента массива arr. Элементы проходят как первый аргумент функции func; если func требует больше чем один аргумент, будет сгенерировано предупреждение всякий раз, когда
array_walk() вызывает func.
Эти предупреждения могут подавляться добавлением знака '@' при вызове array_walk(), или при использовании error_reporting() .
Помните, что func будет работать с елементами массива arr, так что все изменения сделанные над элементами массива будут изменениями для самого массива.
Пример 1. 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' );
|
См. также:
each() и
list() .
arsort
arsort -- Сортировка массива в обратном порядке и поддерка индексных связей.
Описание
void arsort(array array);
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которыми они связываются. Это используется, главным образом, для сортировки ассоциативных массивов, где имеет значение фактический элементный порядок.
Пример 1. 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[b] = banana
fruits[c] = apple
Фрукты показаны в обратном алфавитном порядке, и поддерживаются связанные с ними индексы.
См. также:
asort() ,
rsort() ,
ksort() , и
sort() .
asort
asort -- Сортирует массив и поддерживает связанные индексы
Описание
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которыми они связываются. Это используется, главным образом, для сортировки ассоциативных массивов, где имеет значение фактический элементный порядок
Пример 1. 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[b] = banana
fruits[d] = lemon
fruits[a] = orange
Фрукты показаны в алфавитном порядке, и поддерживаются индексы связанные с каждым элементом массива.
См. также:
arsort() ,
rsort() ,
ksort() , и
sort() .
count
count -- подсчитывает элементы в переменную
Описание
Возвращает число элементов в var, который является естественно массивом (что либо другое будет иметь один элемент).
возвращает 0 если переменная не укстановлена.
возвражает 1 если переменная не является массивом.
См. также:
sizeof() ,
isset() , и
is_array() .
current
current -- возвращает текущий элемент массива
Описание
mixed current(array array);
Каждая переменная-массив имеет внутренний указатель, который указывает на один из своих элементов. Кроме того, все элементы в массиве связываются двунаправленным списком указателей для дополнительных целей.
Внутренний указатель указывает на первый элемент, который включался в массив пока Вы не выполняли одну из функций, которые модифицируют этот указатель в этом массиве.
Функция current()просто возвращает элемент массива, на который в данный момент указывает внутренний указатель. Он никак не перемещает указатель. Если внутренний указатель указывает на конец списка элементов,
current() возвращает false(ложно).
Внимание: если массив содержит пустые элементы (0 или "", пустую строку), то функция возвратит "false" для каждого из них. Это показывает, что текущий элемент является нулевым значением или вы дошли до конца массива. Для того, чтобы правильно просматривать массив, используйте функцию each() .
См. также:
end() ,
next() ,
prev() и
reset() .
each
each -- возвращает следующую пару ключ/значение из массива
Описание
Возвращает следующую пару ключ/значение из массива array и предоставляет курсор массива. Эта пара возвращается в четырех-элементный массив, с ключами 0, 1, key, и
value. Элементы 0 и
key - каждое содержит ключевое имя элемента массива, а 1 и value содержат данные.
Пример 1. each() $foo = array( "bob", "fred", "jussi", "jouni" );
$bar = each( $foo );
$bar теперь содержит следующие пары ключ/значение:
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. Просмотр $HTTP_POST_VARS с помощью each() echo "Values submitted via POST method:<br>";
while ( list( $key, $val ) = each( $HTTP_POST_VARS ) ) {
echo "$key => $val<br>";
}
|
См. также
key() ,
list() ,
current() ,
reset() ,
next() , и
prev() .
end
end -- устанавливаете внутренний указатель массива на последнем элементе
key
key -- выбирает ключ из ассоциативного массива
Описание
key() Возвращает индекс элемента в текущей позиции массива
См. также:
current() ,
next()
ksort
ksort -- Сортирует массив по ключам.
Описание
Сортирует массив по ключу, используя ключ для корреляциях данных. Это полезно главным образом для ассоциативного массива.
Пример 1. 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[b] = banana
fruits[c] = apple
fruits[d] = lemon
См. также
asort() ,
arsort() ,
sort() , и
rsort() .
list
list -- Связывает переменные, как если бы они были массивом.
Описание
Подобно
array() , функция list в действительностью является языковой конструкцией а не функцией list() используется для связи списка переменных одной операцией.
Пример 1. 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> |
См. также:
each() ,
array() .
next
next -- передвигает внутренний указатель массива
Описание
Возвращает следующий элемент массива, от текущей позиции внутреннего указателя массива, или "ложь"(false) если нет больше элементов.
Внимание: если массив содержит пустые элементы, тогда эта функция возвратит "ложь"(false) и для этих элементов. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию
each() .
next() ведет себя подобно
current() , с одной лишь разницей. Он передвигает внутренний указатель массива на один элемент вперед прежде, чем возвратить элемент. Это означает что он возвращает значение следующего элемента и передвигает на него внутренний указатель массива. Если при обращении к следующему элементу обнаружен конец массива - next() возвращает "ложь"(false).
См. также:
current() ,
end()
prev() и
reset()
pos
pos -- Возвращает текущий элемент в массиве
prev
prev -- перемещает внутренний указатель массива
Описание
Возвращает предыдущий элемент массива, или "ложь"(false), если перед текущим нет больше элементов. Внимание: если массив содержит пустые элементы, то функция возвратит "ложь" и на этих элементах. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию
each() .
prev() ведет себя подобно
next() , за исключением того что он переводит внутренний указатель массива на одну позицию назад, а не вперед.
См. также:
current() ,
end()
next() и
reset()
reset
reset -- устанавливает внутренний указатель массива в первом элементе
Описание
mixed reset(array array);
reset() возвращает внутренний указатель массива в первый элемент.
reset() возвращает первыйэлемент массива.
См. также:
current() ,
each() ,
next()
prev() и reset()
rsort
rsort -- Сортирует массив в обратном порядке
Описание
Сортирует массив в обратном порядке (по убыванию).
Пример 1. 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
Фрукты отсортированы в обратном алфавитном порядке.
См. также
arsort() ,
asort() ,
ksort() ,
sort() и
usort() .
sizeof
sizeof -- получает размер массива
Описание
Возвращает число элементов списка.
См. также:
count()
sort
sort -- сортирует массив
Описание
Эта функция сортирует масси - все элементы по окончании ее работы будут расположены по возрастанию.
Пример 1. 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
Фрукты будут отсортированы повозрастанию в алфавитном порядке.
См. также
arsort() ,
asort() ,
ksort() ,
rsort() , и
usort() .
uasort
uasort -- Сортирует массив с использованием функций сравнения, определенных пользователем и поддержкой индексации
Описание
void uasort(array array, function cmp_function);
Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которой они связываются. Т. е. при такой сортировке используются индексы. функции сравнения задает пользователь.
uksort
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
См. также
arsort() ,
asort() ,
uasort() ,
ksort() ,
rsort() и
sort() .
usort
usort -- сортирует массив по значениям используя используя функции сравнения, определенные пользователем
Описание
void usort(array array, function cmp_function);
Эта функция отсортирует массив по значениям используя используя функции сравнения, определенные пользователем. Если массив, который Вы хотите отсортировать должен сортироваться по некоторым не-тривиальным критериям, Вы должны использовать эту функцию.
Пример 1. 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";
} |
Пример покажет:
0: 6
1: 5
2: 3
3: 2
4: 1
Очевидно, что в этом тривиальном случае функция
rsort()
было бы более соответствующей.
См. также
arsort() ,
asort() ,
ksort() ,
rsort() и
sort() .
Содержание
