Связь и интернет Архив Программирование
   
Сделать стартовойСделать закладку            
   ПОИСК  
   
Главная / PHP / Руководство по РНР 3.0 / Справочник функций /
8  Perl
8  PHP
8  JavaScript
8  HTML
8  DHTML
8  XML
8  CSS
8  C / C++
8  Pascal и Delphi
8  Турбо Ассемблер
8  MySQL
8  CASE-технологии
8  Алгоритмы
8  Python
8  Обратная связь
8  Гостевая книга
Новости о мире


Функции обработки массивов - Программирование от RIN.RU
Функции обработки массивов




array


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


Описание array array(...);


Возвращает массив параметров. Параметры могут быть даныпо индексу при использовании опрератора =>.


Помните что array() - это языковая конструкция, и не является регулярным выражением.


Следующий пример демонстрирует как создавать двумерный массив, как определять ключи для ассоциативного массива, и как в пропускать-и-продолжать числовые индексы в нормальном массиве.


Пример 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, так что все изменения сделанные над элементами массива будут изменениями для самого массива.


Пример array_walk()


$fruits = array("d"=>"lemon","a"=>"orange","b"=>"banana","c"=>"apple");


function test_alter( $item1 ) {
$item1 = "bogus";
}


function test_print( $item2 ) {
echo "$item2
\n";
}


array_walk( $fruits, "test_print" );
array_walk( $fruits, "test_alter" );
array_walk( $fruits, "test_print" );




См. также: each() и list().



arsort


arsort -- Сортировка массива в обратном порядке и поддерка индексных связей.


Описание void arsort(array array);


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


Пример 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 Фрукты показаны в обратном алфавитном порядке, и поддерживаются связанные с ними индексы.


См. также: arsort(), rsort(), ksort(), и sort().



asort


asort -- Сортирует массив и поддерживает связанные индексы


Описание void asort(array array);


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


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



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 содержат данные.


Пример 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:


Пример Просмотр $HTTP_POST_VARS с помощью each()


echo "Values submitted via POST method:
";
while ( list( $key, $val ) = each( $HTTP_POST_VARS ) ) {
echo "$key => $val
";
}


См. также 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);


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


Пример 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() используется для связи списка переменных одной операцией.


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


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


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


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


Пример 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 Фрукты будут отсортированы повозрастанию в алфавитном порядке.


См. также arsortasort(), ksort(), rsort(), и usort().



uasort


uasort -- Сортирует массив с использованием функций сравнения, определенных пользователем и поддержкой индексации


Описание void uasort(array array, function cmp_function);


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



uksort


uksort -- Сортирует массив по ключам, с использованием функций сравнения, определенных пользователем


Описание void uksort(array array, function cmp_function);


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


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


См. также arsortasort(), uasort(), ksort(), rsort() и sort().



usort


usort -- сортирует массив по значениям используя используя функции сравнения, определенные пользователем


Описание void usort(array array, function cmp_function);


Эта функция отсортирует массив по значениям используя используя функции сравнения, определенные пользователем. Если массив, который Вы хотите отсортировать должен сортироваться по некоторым не-тривиальным критериям, Вы должны использовать эту функцию.
Пример 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().



 8  Комментарии к статье  8 8  Обсудить в чате

8  В тему

Adabas D функции

Специфичные функции Apache

Математические BC (произвольной точности) функции

Календарные Функции

Функции Даты/Времени

dBase функции

Функции dbm

Функции для работы с каталогами

Функции запуска программ

Функции работы с filePro

Функции файловой системы

Функции, связанные с HTTP

Функции работы с Hyperwave

Функции работы с изображениями

Функции IMAP

PHP опции и информация

Функции работы с Informix

LDAP Функции

Почтовые функции

Математические функции

Дополнительные функции

Функции mSQL

Функции MySQL

Функции для работы с Sybase

Сетевые функции

Функции ODBC

Функции Oracle

Функции PDF

Функции PostgreSQL

Функции регулярных выражений

Функции семафоров и разделяемой памяти

Solid (надежные) функции

Функции SNMP

Строковые функции

Функции URL

Функции переменных

Функции Vmailmgr

Функции Gz-файлов

 
  
  
    Copyright ©  RIN 2003 - 2004      * Обратная связь