Руководство по РНР 3.0 - Функции обработки массивов

Содержание:
array
array_walk
arsort
asort
count
current
each
end
key
ksort
list
next
pos
prev
reset
rsort
sizeof
sort
uasort
uksort
usort

array

array -- Создает массив
Описание

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 -- Сортирует массив и поддерживает связанные индексы
Описание

void asort(array array);

Эта функция сортирует массив так что индексы массива поддерживают их корреляцию с элементами массива с которыми они связываются. Это используется, главным образом, для сортировки ассоциативных массивов, где имеет значение фактический элементный порядок

Пример 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 -- подсчитывает элементы в переменную
Описание

int count(mixed var);

Возвращает число элементов в 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 each(array array);

Возвращает следующую пару ключ/значение из массива 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 -- устанавливаете внутренний указатель массива на последнем элементе
Описание

end(array array);

end() перемещает array's внутренний указатель на последний элемент массива.

См. также: current(), each(), end() next() и reset()

key

key -- выбирает ключ из ассоциативного массива
Описание

mixed key(array array);

key() Возвращает индекс элемента в текущей позиции массива

См. также: current(), next()

ksort

ksort -- Сортирует массив по ключам.
Описание

int ksort(array array);

Сортирует массив по ключу, используя ключ для корреляциях данных. Это полезно главным образом для ассоциативного массива.

Пример 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 -- Связывает переменные, как если бы они были массивом.
Описание

void 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 -- передвигает внутренний указатель массива
Описание

mixed next(array array);

Возвращает следующий элемент массива, от текущей позиции внутреннего указателя массива, или "ложь"(false) если нет больше элементов. Внимание: если массив содержит пустые элементы, тогда эта функция возвратит "ложь"(false) и для этих элементов. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each().

next() ведет себя подобно current(), с одной лишь разницей. Он передвигает внутренний указатель массива на один элемент вперед прежде, чем возвратить элемент. Это означает что он возвращает значение следующего элемента и передвигает на него внутренний указатель массива. Если при обращении к следующему элементу обнаружен конец массива - next() возвращает "ложь"(false).

См. также: current(), end() prev() и reset()

pos

pos -- Возвращает текущий элемент в массиве
Описание

mixed pos(array array);

Это - псевдоним для current().

См. также: end(), next(), prev() и reset().

prev

prev -- перемещает внутренний указатель массива
Описание

mixed prev(array array);

Возвращает предыдущий элемент массива, или "ложь"(false), если перед текущим нет больше элементов. Внимание: если массив содержит пустые элементы, то функция возвратит "ложь" и на этих элементах. Чтобы правильно просмотреть массив, который может содержать пустые элементы, смотрите функцию each().

prev() ведет себя подобно next(), за исключением того что он переводит внутренний указатель массива на одну позицию назад, а не вперед.

См. также: current(), end() next() и reset()

reset

reset -- устанавливает внутренний указатель массива в первом элементе
Описание

mixed reset(array array);

reset() возвращает внутренний указатель массива в первый элемент.

reset() возвращает первыйэлемент массива.

См. также: current(), each(), next() prev() и reset()

rsort

rsort -- Сортирует массив в обратном порядке
Описание

void rsort(array array);

Сортирует массив в обратном порядке (по убыванию).

Пример 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 -- получает размер массива
Описание

int sizeof(array array);

Возвращает число элементов списка.

См. также: count()

sort

sort -- сортирует массив
Описание

void sort(array array);

Эта функция сортирует масси - все элементы по окончании ее работы будут расположены по возрастанию.

Пример 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().

Назад, к содержанию