socket_sendmsg
(PHP 4 >= 4.1.0)
socket_sendmsg - отправляет сообщение на сокет, независимо от того, является ли он ориентированным на соединение или нет.
Описание
bool socket_sendmsg (resource socket, resource iovec, int flags, string addr [, int port])
socket_sendto
(PHP 4 >= 4.1.0)
socket_sendto - отправляет сообщение на сокет, независимо от того, соединён он или нет.
Описание
int socket_sendto (resource socket, string buf, int len, int flags, string addr [, int port])
socket_set_blocking
(PHP 4)
socket_set_blocking - отправляет режим blocking/non-blocking на сокет.
Описание
int socket_set_blocking (int socket descriptor, int mode)
Если mode равен FALSE, дескриптор данного сокета будет переключён в режим non-blocking, а если TRUE, он будет переключён в режим blocking. Это влияет на вызовы вроде fgets(), которые читают с сокета. В режиме non-blocking вызов fgets() всегда сразу возвращает, а в режиме blocking - ожидает, когда данные станут доступны на сокете.
Эта функция вызывалась раньше set_socket_blocking(), но теперь это не рекомендуется.
socket_set_nonblock
(PHP 4 >= 4.1.0)
socket_set_nonblock - устанавливает неблокирующий режим для дескриптора файла fd.
Описание
bool socket_set_nonblock (resource socket)
socket_set_option
(только PHP 4 CVS)
socket_set_option - устанавливает опции сокета.
Описание
bool socket_set_option (resource socket, int level, int optname, int )
Примечание: эта функция вызывалась socket_setopt() в версиях до PHP 4.3.0.
socket_set_timeout
(PHP 4)
socket_set_timeout - установить период таймаута для сокета.
Описание
bool socket_set_timeout (int socket descriptor, int seconds, int microseconds)
Устанавливает значение таймаута на socket descriptor, выраженное суммой seconds и microseconds.
socket_shutdown
(PHP 4 >= 4.1.0)
socket_shutdown - выключает получение, отправку с сокета или и то, и другое.
Описание
bool socket_shutdown (resource socket [, int how])
socket_strerror
(PHP 4 >= 4.1.0)
socket_strerror - возвращает строку - описание ошибки сокета.
Описание
string socket_strerror (int errno)
socket_strerror() принимает в качеств параметра errno код ошибки сокета, возвращённый функцией socket_last_error(), и возвращает соответствующий объясняющий текст. Вместо того чтобы заставлять системный include-файл найти, что означает '-111', вы просто передаёте это значение в socket_strerror(), и она объясняет, что произошло.
socket_write
(PHP 4 >= 4.1.0)
socket_write - записывает в сокет.
Описание
int socket_write (resource socket, string buffer [, int length])
Функция socket_write() записывает в сокет socket из буфера buffer.
Необязательный параметр length может специфицировать альтернативную длину байтов, записываемых в сокет. Если параметр length больше длины буфера, он скрыто усекается до длины буфера.
Возвращает количество байтов, успешно записанных в сокет, или FALSE при ошибке. Код ошибки можно запросить функцией socket_last_error(). Этот код можно передать функции socket_strerror() для получения текстового объяснения ошибки.
Примечание: socket_write() не обязательно записывает все байты из данного буфера. В зависимости от сетевых буферов etc., записывается только определённое количество данных, даже один байт, даже если ваш буфер больше. Вы должны отследить, чтобы не забыть случайно, передачу остатка ваших данных.
Примечание: для socket_write() совершенно правильным будет возврат 0, что означает отсутствие записанных байтов. Используйте операцию === для проверки FALSE в случае ошибки.
См. также socket_accept(), socket_bind(), socket_connect(), socket_listen(), socket_read() и socket_strerror().
socket_writev
(PHP 4 >= 4.1.0)
socket_writev - записывает в дескриптор файла fd, используя scatter-gather массив, определённый в iovec_id.
Описание
bool socket_writev (resource socket, resource iovec_id)
sort
(PHP 3, PHP 4)
Описание
void sort (array array [, int sort_flags])
Эта функция сортирует массив. Элементы буду упорядочены от низшего к высшему.
Пример 1. sort()
<?php
$fruits = array ("lemon", "orange", "banana", "apple");
sort ($fruits);
reset ($fruits);
while (list ($key, $val) = each ($fruits)) {
echo "fruits[".$key."] = ".$val."\n";
}
?>Этот пример выведет:
soundex
(PHP 3, PHP 4)
soundex - вычисляет ключ soundex строки.
Описание
string soundex (string str)
Вычисляет ключ soundex строки str.
Soundex-ключи имеют то свойство, что слова, произнесённые одинаково, дают тот же самый soundex-ключ и могут, таким образом, быть использованы для упрощения поиска в БД, где вы знаете произношение но не написание. Эта soundex-функция возвращает строку длиной в 4 символа, начиная с буквы.
Эту функцию soundex описал Donald Knuth в книге "The Art Of Computer Programming, vol. 3: Sorting And Searching", Addison-Wesley (1973), стр. 391-392.
split
(PHP 3, PHP 4)
split - делает из строки массив с помощью регулярного выражения.
Описание
array split (string pattern, string string [, int limit])
Примечание: preg_split(), использующая Perl-совместимый синтаксис регулярных выражений, работает часто быстрее split().
Возвращает массив строк, каждая из которых является подстрокой строки string и образована путём разделения строки по границам, образованным патэрном pattern регулярного выражения. Если limit установлен, возвращённый массив будет содержать максимум limit элементов с последним элементом, содержащим остаток строки string. Если возникла ошибка, split() возвращает FALSE.
Для того чтобы разделить первые четыре поля строчки /etc/passwd:
spliti
(PHP 4 >= 4.0.1)
spliti - делит строку на массив с помощью регулярного выражения, без учёта регистра.
Описание
array spliti (string pattern, string string [, int limit])
Эта функция идентична split(), но игнорирует регистр алфавитных символов.
См. также split(), explode() и implode().
sprintf
(PHP 3, PHP 4)
sprintf - возвращает отформатированную строку.
Описание
string sprintf (string format [, mixed args])
Возвращает строку, созданную в соответствии со строкой форматирования format.
Строка форматирования состоит из 0 или более директив: обычных символов (исключая %), которые копируются прямо в результат, и спецификаций конвертации, каждая из которых приводит к извлечению её собственного параметра. Это применяется к sprintf() и к printf().
Каждая спецификация конвертации состоит из знака процентов (%) с последующим одним или более из следующих элементов, в данном порядке:
Необязательный padding-спецификатор, который сообщает, какой символ будет использоваться для заполнения результатов до размера строки. Это может быть символ space/пробел или 0 (символ нуль). По умолчанию заполняется пробелами. Альтернативный заполнитель может быть специфицирован с помощью префикса - одинарной кавычки ('). См. примеры далее.
Необязательный alignment-спецификатор, который сообщает, должен ли результат выравниваться влево или вправо (left-justified или right-justified). По умолчанию right-justified; символ - здесь делает left-justified.
Необязательное число, width-спецификатор, который сообщает, сколько символов (минимум) должна дать эта конвертация.
Необязательный precision-спецификатор, который сообщает, сколько десятеричных цифр должно выводиться для чисел с плавающей точкой. Эта опция не оказывает действия на другие типы, кроме float. (Для форматирования чисел используется также функция number_format().)
type-спецификатор, который сообщает, как какой тип должны рассматриваться данные аргумента. Возможные типы:
Как и в PHP версии 4.0.6, строка форматирования поддерживает нумерацию/обмен аргументов (numbering/swapping). Вот пример:
sql_regcase
(PHP 3, PHP 4)
sql_regcase - создаёт регулярное выражение для поиска совпадений без учёта регистра.
Описание
string sql_regcase (string string)
Возвращает правильное регулярное выражение, которое будет подставляться к строке string, игнорируя регистр. Это выражение является string с конвертацией каждого символа в выражение в квадратных скобках; это выражение в квадратных скобках содержит формы этого символа в верхнем и нижнем регистре, если это применимо, иначе содержит оригинальный символ дважды.
sqrt
(PHP 3, PHP 4)
Описание
float sqrt (float arg)
Возвращает квадратный корень аргумента arg.
srand
(PHP 3, PHP 4)
srand - сеет генератор случайных чисел.
Описание
void srand (int seed)
Сеет генератор случайных чисел с числом seed.
sscanf
(PHP 4 >= 4.0.1)
sscanf - разбирает ввод строки в соответствии с форматом.
Описание
mixed sscanf (string str, string format [, string var1])
Функция sscanf() это input-аналог printf(). sscanf() читает из строки str и интерпретирует её в соответствии со специфицированным форматом format. Если этой функции передано только два параметра, разобранные значения будут возвращены как массив.
Любой пробел в строке формата совпадает с любым пробелом в строке ввода. Это означает, что даже tab \n в строке формата может совпадать с одиночным пробельным символом в строке ввода.
stat
(PHP 3, PHP 4)
stat - выдаёт информацию о файле.
Описание
array stat (string filename)
Собирает статистику о файле filename.
Возвращает массив со статистикой о файле со следующими элементами:
device/устройство
inode
метод защиты inode
количество ссылок
user id владельца
group id владельца
тип устройства, если inode device *
размер в байтах
время последнего доступа
время последней модификации
время последнего изменения
blocksize для файловой системы I/O *
количество выделенных блоков
* - верно только в системах, поддерживающих тип st_blksize -- другие системы (т.е. Windows) возвращают -1.
Возвращает FALSE при ошибке.
stat() не может использоваться с remote-файлами.
Результаты функции кэшируются. См. детали в clearstatcache().
str_pad
(PHP 4 >= 4.0.1)
str_pad - заполняет строку определённой длины другой строкой.
Описание
string str_pad (string input, int pad_length [, string pad_string [, int pad_type]])
Эта функция возвращает строку input, заполненную влево, вправо или в обоих направлениях на специфицированную длину. Если необязательный аргумент pad_string отсутствует, input заполняется пробелами, иначе заполняется символами из pad_string до верхней границы.
Необязательный аргумент pad_type может быть: STR_PAD_RIGHT, STR_PAD_LEFT или STR_PAD_BOTH. Если pad_type не специфицирован, принимается STR_PAD_RIGHT.
Если значение pad_length отрицательное или меньше длины input-строки, заполнение не выполняется.
str_repeat
(PHP 4)
str_repeat - повторяет строку.
Описание
string str_repeat (string input, int multiplier)
Возвращает input_str, повторённую multiplier раз.
multiplier должен быть больше или равен 0. Если multiplier равен 0, функция возвратит пустую строку.
str_replace
(PHP 3>= 3.0.6, PHP 4)
str_replace - замещает все вхождения строки поиска строкой замещения.
Описание
mixed str_replace (mixed search, mixed replace, mixed subject)
Эта функция возвращает строку или массив со всеми вхождениями search в subject, заменёнными данным значением replace. Если вам не нужны какие-то особые правила замещения, вы всегда должны использовать эту функцию вместо ereg_replace() или preg_replace().
В PHP 4.0.5 и новее каждый параметр для str_replace() может быть массивом.
Если subject это массив, то поиск и замена выполняется с каждым вхождением subject, а return-значение также является массивом.
Если search и replace это массивы, то str_replace() принимает значение из каждого массива и использует его для поиска и замены в subject. Если replace имеет меньше значений, чем search, то пустая строка используется для остальных замещающих значений. Если search это массив, а replace - строка, то эта строка замещения используется для каждого значения search.
str_rot13
(PHP 4 >= 4.2.0)
str_rot13 - выполняет rot13-трансформацию строки.
Описание
string str_rot13 (string str)
Эта функция выполняет ROT13-шифрование аргумента str и возвращает результирующую строку. ROT13-шифрование просто сдвигает каждую букву на 13 позиций в алфавите, оставляя неалфавитные символы без изменения. Дешифрование выполняется этой же функцией, путём передачи ей шифрованной строки как аргумента и получения оригинальной версии.
strcasecmp
(PHP 3>= 3.0.2, PHP 4)
strcasecmp - бинарное безопасное сравнение строк без учёта регистра.
Описание
int strcasecmp (string str1, string str2)
Возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2, и 0, если они равны.
strchr
(PHP 3, PHP 4)
strchr - находит первое вхождение символа.
Описание
string strchr (string haystack, string needle)
Это псевдоним функции strstr(), идентичный во всём.
strcmp
(PHP 3, PHP 4)
strcmp - двоично безопасное сравнение строк.
Описание
int strcmp (string str1, string str2)
Возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2, и 0, если они равны.
Заметьте, что сравнение идёт с учётом регистра.
См. также ereg(), strcasecmp(), substr(), stristr(), strncasecmp(), strncmp() и strstr().
strcoll
(PHP 4 >= 4.0.5)
strcoll - сравнение строк на основе локализации.
Описание
int strcoll ( string str1, string str2)
Возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2, и 0, если они равны. strcoll() использует текущую locale для выполнения сравнения. Если текущая locale равна C или POSIX, эта функция эквивалентна strcmp().
Это сравнение с учётом регистра и, в отличие от strcmp(), эта функция бинарно не безопасна.
См. также ereg(), strcmp(), strcasecmp(), substr(), stristr(), strncasecmp(), strncmp(), strstr() и setlocale().
strcspn
(PHP 3>= 3.0.3, PHP 4)
strcspn - находит длину начального сегмента, не совпадающего с маской.
Описание
int strcspn (string str1, string str2)
Возвращает длину начального сегмента строки str1, который не содержит никаких символов из str2.
См. также strspn().
strftime
(PHP 3, PHP 4)
strftime - форматирует локальные дату/время в соответствии с локальными установками.
Описание
string strftime (string format [, int timestamp])
Возвращает строку, отформатированную в соответствии с заданной строкой формата с использованием timestamp или текущего локального времени, если timestamp не задан. Имена month и weekday и другие зависимые от языка строки соотносятся с текущей локализацией через setlocale().
В строке формата распознаются следующие спецификаторы конвертации:
%a - сокращённое имя weekday в соответствии с текущей locale
%A - полное имя weekday в соответствии с текущей locale
%b - сокращённое имя month в соответствии с текущей locale
%B - полное имя month в соответствии с текущей locale
%c - предпочтительное представление даты и времени для текущей locale
%C - число столетий (год, разделённый на 100 и усечённый до integer, в диапазоне 00 - 99)
%d - число месяца как 10-ричное число (диапазон 01 - 31)
%D - то же , что %m/%d/%y
%e - число месяца как 10-ричное число, одиночная цифра имеет перед собой пробел (диапазон '1' - '31')
%g - как %G, но без столетия
%G - год из 4 цифр, соответствующий ISO-номеру недели (см. %V). Имеет тот же формат и значение, что и %Y, но, если ISO week number принадлежит предыдущему или следующему году, используется тот год.
%h - то же, что и %b
%H - часы как 10-ричное число (диапазон 00 - 23)
%I - часы как 10-ричное число с использованием 12-часового циферблата (диапазон 01 - 12)
%j - день года как 10-ричное число (диапазон 001 - 366)
%m - month как 10-ричное число (диапазон 01 - 12)
%M - минуты как 10-ричное число
%n - символ newline
%p - 'am' или 'pm' в соответствии с заданным значением времени, либо соответствующие строки для текущей locale
%r - время в нотации a.m. и p.m.
%R - время в 24-часовой нотации
%S - секунды как 10-ричное число
%t - символ tab
%T - текущее время, равное %H:%M:%S
%u - день недели как 10-ричное число [1,7], где 1 это Monday
%U - номер недели текущего года как 10-ричное число, начиная с Sunday как первого дня первой недели
%V - ISO 8601:1988 номер недели текущего года как 10-ричное число, диапазон 01 - 53, где week 1 это первая неделя, имеющая как минимум 4 дня в текущем году, а Monday это первый день недели. (Используйте %G или %g для компонента year, соответствующие номеру недели для специфицированного .)
%W - номер недели текущего года как 10-ричное число, начиная с Monday как первого дня первой недели
%w - день недели как 10-ричное число, Sunday как 0
%x - предпочтительное представление даты для текущей locale без времени
%X - предпочтительное представление времени для текущей locale без даты
%y - год как 10-ричное число без столетий (диапазон 00 - 99)
%Y - год как 10-ричное число, включая столетия
%Z - часовой пояс, имя или аббревиатура
%% -литеральный символ '%'
Примечание: не все виды специфицированной конвертации могут поддерживаться вашей библиотекой C, и в этом случае они не будут поддерживаться РНР-функцией strftime(). Это означает, что %T и %D не будут работать в Windows.
strip_tags
(PHP 3>= 3.0.8, PHP 4)
strip_tags - вырезает тэги HTML и PHP из строки.
Описание
string strip_tags (string str [, string allowable_tags])
Эта функция пытается вернуть строку str с вырезанными тэгами HTML и PHP. Выдаёт ошибку с предупреждением в случае наличия неполных или ложных тэгов. Использует ту же машину вырезания тэгов, что и fgetss().
Вы можете использовать необязательный второй параметр для специфицирования тэгов, которые не должны вырезаться.
Примечание: allowable_tags был введён в PHP 3.0.13 и в PHP 4.0b3.
stripcslashes
(PHP 4)
stripcslashes - раскавычивает строку, закавыченную функцией addcslashes().
Описание
string stripcslashes (string str)
Возвращает строку с вырезанными обратными слэшами. Распознаёт C-подобные \n, \r ..., 8-ричные и 16-ричные представления.
См. также addcslashes().
stripslashes
(PHP 3, PHP 4)
stripslashes - раскавычивает строку, закавыченную функцией addslashes().
Описание
string stripslashes (string str)
Возвращает строку с вырезанными обратными слэшами (\' становится ' и так далее). Двойные backslash становятся одинарными.
См. также addslashes().
stristr
(PHP 3>= 3.0.6, PHP 4)
stristr - strstr() без учёта регистра.
Описание
string stristr (string haystack, string needle)
Возвращает весь haystack от первого вхождения needle до конца. needle и haystack проверяются без учёта регистра символов.
Если needle не найден, возвращает FALSE.
Если needle не является строкой, он конвертируется в integer и применяется как обычное значение символа.
strlen
(PHP 3, PHP 4)
strlen - получает длину строки.
Описание
int strlen (string str)
Возвращает длину строки string.
strnatcasecmp
(PHP 4)
strnatcasecmp - сравнение строк без учёта регистра с использованием алгоритма "natural order".
Описание
int strnatcasecmp (string str1, string str2)
Эта функция реализует алгоритм сравнения, упорядочивающий алфавитно-числовые строки "человеческим" способом. Поведение этой функции похоже на strnatcmp(), но сравнение нечувствительно к регистру. Дополнительно см. страницу Martin'а Pool'а Natural Order String Comparison.
Как и другие функции сравнения строк, эта возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2; 0, если они равны.
См. также ereg(), strcasecmp(), substr(), stristr(), strcmp(), strncmp(), strncasecmp(), strnatcmp() и strstr().
strnatcmp
(PHP 4)
strnatcmp - сравнение строк с использованием алгоритма "natural order/натурального порядка".
Описание
int strnatcmp (string str1, string str2)
Эта функция реализует алгоритм сравнения, упорядочивающий алфавитно-числовые строки человекообразным способом. Вот пример разницы между этим алгоритмом и обычными алгоритмами сортировки строк на компьютере (используемые в strcmp()):
strncasecmp
(PHP 4 >= 4.0.2)
strncasecmp - бинарно безопасное сравнение строк для первых n символов.
Описание
int strncasecmp (string str1, string str2, int len)
Эта функция похожа на strcasecmp() с той разницей, что вы можете специфицировать количество (верхнюю границу) символов (len) каждой строки, используемое при сравнении. Если любая строка короче len, то длина этой строки будет использоваться при сравнении.
Возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2; 0, если они равны.
См. также ereg(), strcasecmp(), strcmp(), substr(), stristr() и strstr().
strncmp
(PHP 4 )
strncmp - бинарно безопасное сравнение строк для первых n символов.
Описание
int strncmp (string str1, string str2, int len)
Эта функция похожа на strcmp() с той разницей, что вы можете специфицировать количество (верхнюю границу) символов (len) каждой строки, используемое при сравнении. Если любая строка короче len, то длина этой строки будет использоваться при сравнении.
Возвращает < 0, если str1 меньше str2; > 0, если str1 больше str2; 0, если они равны.
Обратите внимание, что это сравнение с учётом регистра.
См. также ereg(), strncasecmp(), strcasecmp(), substr(), stristr(), strcmp() и strstr().
strpos
(PHP 3, PHP 4)
strpos - находит позицию первого вхождения строки.
Описание
int strpos (string haystack, string needle [, int offset])
Возвращает числовую позицию первого вхождения needle в строке haystack. В отличие от strrpos(), эта функция принимает полную строку как параметр needle, и вся эта строка используется.
Если needle не найден, возвращает FALSE.
Примечание: легко ошибиться с return-значениями "character found at position 0" и "character not found". Вот как определить разницу:
strrchr
(PHP 3, PHP 4)
strrchr - находит последнее вхождение (появление) символа в строке.
Описание
string strrchr (string haystack, string needle)
Эта функция возвращает часть из haystack, начинающуюся с последнего вхождения needle и идущую до конца haystack.
Возвращает FALSE, если needle не найден.
Если needle содержит более одного символа, используется первый.
Если needle это не строка, он конвертируется в integer и применяется как порядковое значение символа.
strrev
(PHP 3, PHP 4)
strrev - разворачивает строку.
Описание
string strrev (string string)
Возвращает развёрнутую строку string.
strrpos
(PHP 3, PHP 4)
strrpos - находит позицию последнего вхождения char в строке.
Описание
int strrpos (string haystack, char needle)
Возвращает числовую позицию последнего вхождения needle в строке haystack. Обратите внимание, что needle в этом случае может быть только одиночным символом. Если строка передаётся как needle, то будет использоваться только первый символ такой строки.
Если needle не найден, возвращает FALSE.
Примечание: легко ошибиться с return-значениями "character found at position 0" и "character not found". Вот как определить разницу:
strspn
(PHP 3>= 3.0.3, PHP 4)
strspn - находит длину начального сегмента маски.
Описание
int strspn (string str1, string str2)
Возвращает длину начального сегмента str1, состоящего полностью из из символов строки str2.
strstr
(PHP 3, PHP 4)
strstr - находит первое вхождение строки.
Описание
string strstr (string haystack, string needle)
Возвращает часть строки haystack от первого вхождения needle до конца haystack.
Если needle не найден, возвращает FALSE.
Если needle не строка, он конвертируется в integer и применяется как порядковое значение символа.
Примечание: эта функция чувствительна к регистру символов. Для поиска без учёта регистра используйте функцию stristr().
strtok
(PHP 3, PHP 4 )
strtok - лексемизация/Tokenize строки.
Описание
string strtok (string arg1, string arg2)
strtok() разделяет строку (arg1) на небольшие строки (лексемы/tokens), где каждая строка отделена символом из arg2. То есть, если у вас имеется, например, строка "This is an example string", вы можете лексемизировать её на отдельные слова с применением пробела как разделителя.
Пример 1. strtok()
$string = "This is\tan example\nstring";
/* Использовать также символы tab и newline как лексемизирующие символы */
$tok = strtok($string," \n\t");
while ($tok) {
echo "Word=$tok<br>";
$tok = strtok(" \n\t");
}Заметьте, что только первый вызов strtok использует аргумент string. Каждый последующий вызов strtok только использует лексему и отслеживает таким образом, где он находится в текущей строке. Для старта сначала или для лексемизации новой строки вы просто вызываете strtok снова с аргументом string для его инициализации. Заметьте, что вы можете поместить несколько лексем в параметр token. Строка будет лексемизироваться, если найден какой-нибудь один из символов из этого аргумента.
Поведение в случае обнаружения пустой части было изменено в PHP 4.1.0. Старое поведение - возвращалась пустая строка, новое, корректное - эта часть строки просто пропускается:
strtolower
(PHP 3, PHP 4)
strtolower - переводит символы строки в нижний регистр.
Описание
string strtolower (string str)
Возвращает string со всеми алфавитными символами, конвертированными в нижний регистр.
Заметьте, что 'алфавитность' определяется текущей locale (локальными настройками). Это означает, что, при "C" locale по умолчанию, такие символы как umlaut-A не будут конвертироваться.
strtotime
(PHP 3>= 3.0.12, PHP 4)
strtotime - разбирает английское текстовое описание datetime в UNIX timestamp.
Описание
int strtotime (string time [, int now])
Функция ожидает строку, содержащую английский формат даты, и пытается разобрать этот формат в UNIX timestamp относительно timestamp, заданного в параметре now, или относительно текущего времени, если ничего не задано. При неудаче возвращает -1.
Поскольку strtotime() ведёт себя в соответствии с GNU-синтаксисом даты, просмотрите страницу GNU-учебника Date Input Formats. Там описан правильный синтаксис параметра time.
strtoupper
(PHP 3, PHP 4)
strtoupper - переводит символы строки в верхний регистр.
Описание
string strtoupper (string string)
Возвращает string со вмеси алфавитными символами, конвертированными в верхний регистр.
Заметьте, что 'алфавитные' определяется текущей locale (локальными настройками). Это означает, что, при "C" locale по умолчанию, такие символы как umlaut-a, не будут конвертироваться.
strtr
(PHP 3, PHP 4)
strtr - транслирует определённые символы.
Описание
string strtr (string str, string from, string to)
string strtr (string str, array replace_pairs)
Эта функция возвращает копию строки str, транслируя все появления каждого символа из параметра from в соответствующие символы из to и возвращая результат.
Если from и to имеют разные размеры, лишние символы в более длинном игнорируются.
strval
(PHP 3, PHP 4)
strval - получает строковое значение переменной.
Описание
string strval (mixed var)
Возвращает string-значение переменной var. См. в документации по string информацию о конвертировании в строки.
var может быть любым скалярным типом. Вы не можете использовать strval() с массивами или объектами.
См. также floatval(), intval(), settype() и Трюки с типами.
substr
(PHP 3, PHP 4)
substr - возвращает часть строки.
Описание
string substr (string string, int start [, int length])
Substr возвращает часть строки string, специфицированную параметрами start и length.
Если start положительный, возвращаемая строка начинается со start'овой позиции в string, отсчитываемой от нуля. Например, в строке 'abcdef' символ в позиции 0 это 'a', символ в позиции 2 это 'c', и так далее.
substr_count
(PHP 4)
substr_count - вычисляет количество появлений подстроки.
Описание
int substr_count (string haystack, string needle)
substr_count() возвращает количество появлений подстроки needle в строке haystack.
substr_replace
(PHP 4)
substr_replace - заменяет текст части строки.
Описание
string substr_replace (string string, string replacement, int start [, int length])
substr_replace() замещает копию строки string, ограниченную параметрами start и (не обязательно) length - строкой, заданной в параметре replacement. Возвращает результат.
Если start положительный, замещение начинается со start'ового смещения в строке string.
Если start отрицательный, замещение начинается со start'ового символа от конца строки string.
Если задан положительный length, он представляет длину замещаемой части строки string. Если он отрицательный, он представляет количество символов от конца строки string, с которых замещение останавливается. Если он не задан, то по умолчанию будет strlen( string ); т.е. конец замещения - в конце string.
Пример 1. substr_replace()
<?php $var = 'ABCDEFGH:/MNRPQR/'; echo "Original: $var<hr>\n"; /* Эти два примера замещают все $var на 'bob'. */ echo substr_replace($var, 'bob', 0) . "<br>\n"; echo substr_replace($var, 'bob', 0, strlen($var)) . "<br>\n"; /* Вставляет 'bob' в начале $var. */ echo substr_replace($var, 'bob', 0, 0) . "<br>\n"; /* Следующие два замещают 'MNRPQR' в $var на 'bob'. */ echo substr_replace($var, 'bob', 10, -1) . "<br>\n"; echo substr_replace($var, 'bob', -7, -1) . "<br>\n"; /* Удаляется 'MNRPQR' из $var. */ echo substr_replace($var, '', 10, -1) . "<br>\n"; ?>
См. также str_replace() и substr().
swf_actiongeturl
(PHP 4)
swf_actiongeturl - получает URL из Shockwave Flash-клипа.
Описание
void swf_actiongeturl (string url, string target)
swf_actionGetUrl() получает URL url с целью target.
swf_actiongotoframe
(PHP 4)
swf_actiongotoframe - проигрывает кадр и останавливается.
Описание
void swf_actiongotoframe (int framenumber)
swf_actionGotoFrame() перейдёт к кадру framenumber, проиграет его и остановится.
swf_actiongotolabel
(PHP 4)
swf_actiongotolabel - отображает кадр со специфицированным лэйблом.
Описание
void swf_actiongotolabel (string label)
swf_actionGotoLabel() отображает кадр с лэйблом label и останавливается.
swf_actionnextframe
(PHP 4)
swf_actionnextframe - переходит вперёд на один кадр.
Описание
void swf_actionnextframe (void)
swf_actionplay
(PHP 4)
swf_actionplay - начинает проигрывание клипа flash с текущего кадра.
Описание
void swf_actionplay (void)
swf_actionprevframe
(PHP 4)
swf_actionprevframe - переходит назад на один кадр.
Описание
void swf_actionprevframe (void)
swf_actionsettarget
(PHP 4)
swf_actionsettarget - устанавливает контекст акций.
Описание
void swf_actionsettarget (string target)
swf_actionSetTarget() устанавливает контекст для всех акций. Вы можете использовать это для управления другими flash-клипами, проигрываемыми в данной время.
swf_actionstop
(PHP 4)
swf_actionstop - останавливает проигрывание flash movie с текущего кадра.
Описание
void swf_actionstop (void)
swf_actiontogglequality
(PHP 4)
swf_actiontogglequality - переключает с низкого на высокое качество и обратно.
Описание
void swf_actiontogglequality (void)
swf_actionwaitforframe
(PHP 4)
swf_actionwaitforframe - пропускает акцию, если кадр не загружен.
Описание
void swf_actionwaitforframe (int framenumber, int skipcount)
swf_actionWaitForFrame() проверяет, загружен ли кадр framenumber, и, если нет, пропускает количество акций, специфицированное параметром skipcount. Это можно использовать для анимаций типа "Loading...".
swf_addbuttonrecord
(PHP 4)
swf_addbuttonrecord - управляет размещением, видом и активной областью текущей кнопки.
Описание
void swf_addbuttonrecord (int states, int shapeid, int depth)
swf_addbuttonrecord() позволяет определять специфику использования кнопки. Первый параметр, states, определяет статусы, которые может иметь кнопка; это может быть одна из или все следующие константы: BSHitTest, BSDown, BSOver, BSUp. Второй параметр, shapeid, это обычно object id фигуры кнопки. Параметр depth это местоположение кнопки в текущем кадре.
Пример 1. Функция swf_addbuttonrecord()
swf_addcolor
(PHP 4)
swf_addcolor - устанавливает глобальный add-цвет для специфицированного rgba-значения.
Описание
void swf_addcolor (float r, float g, float b, float a)
swf_addcolor() устанавливает global add color для специфицированного rgba-цвета. Этот цвет затем используется (неявно) функциями swf_placeobject(), swf_modifyobject() и swf_addbuttonrecord(). Цвет объекта будет добавлен rgba -значениями, если объект записывается на экран.
Примечание: rgba-значения могут быть положительными или отрицательными.
swf_closefile
(PHP 4)
swf_closefile - закрывает текущий Shockwave Flash-файл.
Описание
void swf_closefile ([int return_file])
Закрывает файл, открытый функцией swf_openfile(). Если параметр return_file установлен, то возвращается содержимое SWF-файла.
Пример 1. Создание простого flash-файла на основе
пользовательского ввода и вывод
его и сохранение в БД
swf_definebitmap
(PHP 4)
swf_definebitmap - определяет растр.
Описание
void swf_definebitmap (int objid, string image_name)
swf_definebitmap() определяет растр, заданный изображением GIF, JPEG, RGB или FI. Изображение будет конвертировано в формат Flash JPEG или Flash color map.
swf_definefont
(PHP 4)
swf_definefont - определяет шрифт.
Описание
void swf_definefont (int fontid, string fontname)
swf_definefont() определяет шрифт fontname и назначает ему id fontid. Затем устанавливает шрифт fontname как текущий шрифт.
swf_defineline
(PHP 4)
swf_defineline - определяет линию.
Описание
void swf_defineline (int objid, float x1, float y1, float x2, float y2, float width)
swf_defineline() определяет линию, начиная с координат x - x1 и y - y1, до x - x2 и y - y2. Ширина определяется параметром width.
swf_definepoly
(PHP 4)
swf_definepoly - определяет многоугольник.
Описание
void swf_definepoly (int objid, array coords, int npoints, float width)
swf_definepoly() определяет многоугольник как массив координат x, y (определены в параметре coords). Параметр npoints это общее количество точек в массиве coords. width это ширина рамки многоугольника; если 0.0 многоугольник заполняется.
swf_definerect
(PHP 4)
swf_definerect - определяет прямоугольник.
Описание
void swf_definerect (int objid, float x1, float y1, float x2, float y2, float width)
swf_definerect() определяет прямоугольник с координатами верхнего левого угла x, x1 и y, y1. Координаты правого нижнего угла x, x2 и y, y2. Толщина рамки прямоугольника задаётся параметром width; если width равен 0.0, прямоугольник заполняется.
swf_definetext
(PHP 4)
swf_definetext - определяет текстовую строку.
Описание
void swf_definetext (int objid, string str, int docenter)
Определяет строку текста (параметр str) с использованием текущего шрифта и текущего размера шрифта. docenter это точка центрирования слова; если docenter равен 1, слово центрируется в x.
swf_endbutton
(PHP 4)
swf_endbutton - конец определения текущей кнопки.
Описание
void swf_endbutton (void)
swf_enddoaction
(PHP 4)
swf_enddoaction - заканчивает текущую акцию.
Описание
void swf_enddoaction (void)
Заканчивает текущую акцию , начатую функцией swf_startdoaction().
swf_endshape
(PHP 4)
swf_endshape - завершает определение текущей фигуры/shape.
Описание
void swf_endshape (void)
swf_endsymbol
(PHP 4)
swf_endsymbol - завершает определение символа.
Описание
void swf_endsymbol (void)
swf_endsymbol() завершает определение символа, начатое функцией swf_startsymbol().
swf_fontsize
(PHP 4)
swf_fontsize - изменяет размер шрифта.
Описание
void swf_fontsize (float size)
swf_fontsize() изменяет размер шрифта на значение size.
swf_fontslant
(PHP 4)
swf_fontslant - устанавливает наклон шрифта.
Описание
void swf_fontslant (float slant)
Устанавливает наклон текущего шрифта на угол slant. Положительные значения - наклон вперёд, отрицательные - назад.
swf_fonttracking
(PHP 4)
swf_fonttracking - устанавливает трэкинг текущего шрифта.
Описание
void swf_fonttracking (float tracking)
Устанавливает трэкинг текущего шрифта на значение параметра tracking. Эта функция используется для увеличения межсимвольного пространства; положительные значения увеличивают пространство, отрицательные - уменьшают.
swf_getbitmapinfo
(PHP 4)
swf_getbitmapinfo - получает информацию о растре.
Описание
array swf_getbitmapinfo (int bitmapid)
swf_getbitmapinfo() возвращает массив информации о растре, заданном параметром bitmapid. Возвращаемый массив содержит следующие элементы:
"size" - размер растра в байтах.
"width" - ширина растра в пикселах.
"height" - высота растра в пикселах
swf_getfontinfo
(PHP 4)
swf_getfontinfo - высота в пикселах заглавной A и строчной x.
Описание
array swf_getfontinfo (void)
swf_getfontinfo() возвращает ассоциативный массив с параметрами:
Aheight - высота в пикселах заглавной A.
xheight - высота в пикселах строчной x.
swf_getframe
(PHP 4)
swf_getframe - получает номер текущего кадра.
Описание
int swf_getframe (void)
swf_labelframe
(PHP 4)
swf_labelframe - помечает ярлыком текущий кадр.
Описание
void swf_labelframe (string name)
Помечает текущий кадр именем name.
swf_lookat
(PHP 4)
swf_lookat - определяет трансформацию просмотра.
Описание
void swf_lookat (float view_x, float view_y, float view_z, float reference_x, float reference_y, float reference_z, float twist)
swf_lookat() определяет трансформацию просмотра/transformation, задавая позицию просмотра (параметры view_x, view_y и view_z) и координаты точки отсчёта в сцене; точка отсчёта задана параметрами reference_x, reference_y и reference_z. Параметр twist управляет ротацией вдоль оси z.
swf_modifyobject
(PHP 4)
swf_modifyobject - модифицирует объект.
Описание
void swf_modifyobject (int depth, int how)
Обновляет позицию и/или цвет объекта на специфицированную глубину depth. Параметр how определяет, что обновлять. how может быть константой MOD_MATRIX или MOD_COLOR или комбинацией обеих (MOD_MATRIX|MOD_COLOR).
MOD_COLOR использует текущий mulcolor (специфицированный функцией swf_mulcolor()) и addcolor (специфицированный функцией swf_addcolor()) для раскраски объекта. MOD_MATRIX использует текущую матрицу для позиционирования объекта.
swf_mulcolor
(PHP 4)
swf_mulcolor - устанавливает глобальный multiply-цвет - специфицированное rgba-значение.
Описание
void swf_mulcolor (float r, float g, float b, float a)
swf_mulcolor() устанавливает глобальный multiply-цвет - специфицированный rgba-цвет. Этот цвет используется затем (неявно) функциями swf_placeobject(), swf_modifyobject() и swf_addbuttonrecord(). Цвет объекта будет умножен на rgba-значения, когда объект записывается на экран.
Примечание: rgba-значения могут быть положительными или отрицательными.
swf_nextid
(PHP 4)
swf_nextid - возвращает следующий свободный object id.
Описание
int swf_nextid (void)
swf_nextid() возвращает следующий доступный object id.
swf_oncondition
(PHP 4)
swf_oncondition - описывает переход/transition, используемый для переключения списка акций.
Описание
void swf_oncondition (int transition)
swf_onCondition() описывает переход, который переключит список акций. Есть несколько типов перехода, следующие предназначены для кнопок, определённых как TYPE_MENUBUTTON:
IdletoOverUp
OverUptoIdle
OverUptoOverDown
OverDowntoOverUp
IdletoOverDown
OutDowntoIdle
MenuEnter (IdletoOverUp|IdletoOverDown)
MenuExit (OverUptoIdle|OverDowntoIdle)
Для TYPE_PUSHBUTTON имеются следующие опции:
IdletoOverUp
OverUptoIdle
OverUptoOverDown
OverDowntoOverUp
OverDowntoOutDown
OutDowntoOverDown
OutDowntoIdle
ButtonEnter (IdletoOverUp|OutDowntoOverDown)
ButtonExit (OverUptoIdle|OverDowntoOutDown)
swf_openfile
(PHP 4)
swf_openfile - открывает новый Shockwave Flash файл.
Описание
void swf_openfile (string filename, float width, float height, float framerate, float r, float g, float b)
swf_openfile() открывает новый файл filename с шириной width и высотой height, частотой кадров framerate и фоном со значением красного r, зелёного - g и синего - b.
swf_openfile() обязана быть первой вызываемой вами функцией, иначе ваш скрипт вызовет segfault. Если вы хотите направит ваш вывод на экран, сделайте имя файла: "php://stdout" (это поддерживается в 4.0.1 и позднее).
swf_ortho
(PHP 4 >= 4.0.1)
swf_ortho - определяет орфографическое отображение пользовательских координат в текущем порте просмотра.
Описание
void swf_ortho (float xmin, float xmax, float ymin, float ymax, float zmin, float zmax)
swf_ortho2
(PHP 4)
swf_ortho2 - определяет 2D орфографическое отображение пользовательских координат в текущем порте просмотра.
Описание
void swf_ortho2 (float xmin, float xmax, float ymin, float ymax)
swf_ortho2() определяет двухмерное орфографическое отображение пользовательских координат в текущем порте просмотра, это по умолчанию отображение один к одному области Flash-клипа. Если желательна перспективная трансформация, можно использовать функцию swf_perspective ().
swf_perspective
(PHP 4)
swf_perspective - определяет трансформацию проекции перспективы.
Описание
void swf_perspective (float fovy, float aspect, float near, float far)
swf_perspective() определяет трансформацию проекции перспективы. Параметр fovy это угол поля просмотра в направлении y. Параметр aspect должен иметь значение аспекта пропорции порта просмотра, в котором происходит прорисовка. Параметр near это ближний план усечения, а far - дальний план усечения.
Примечание: могут происходит различные искажения при выполнении проекции перспективы из-за того, что Flash-плэйеры имеют только двухмерную матрицу.
swf_placeobject
(PHP 4)
swf_placeobject - место объекта в экране.
Описание
void swf_placeobject (int objid, int depth)
Помещает объект objid в текущем кадре на глубину depth. Параметры objid и depth обязаны быть в диапазоне от 1 до 65535.
Используется текущий mulcolor (специфицированный функцией swf_mulcolor()) и текущий addcolor (специфицированный функцией swf_addcolor()) для раскраски объекта, а текущая матрица используется для позиционирования объекта.
Примечание: поддерживаются полные RGBA-цвета.
swf_polarview
(PHP 4)
swf_polarview - определяет позицию смотрящего с полярными координатами.
Описание
void swf_polarview (float dist, float azimuth, float incidence, float twist)
swf_polarview определяет позицию смотрящего с полярными координатами. Параметр dist задаёт расстояние между точкой просмотра/viewpoint и источником мирового пространства. Параметр azimuth определяет азимутальный угол в плане координат x,y, измеренный от оси y. Параметр incidence определяет угол падения в плане y,z, измеренный от оси z. Угол падения определён как угол порта просмотра относительно оси z. Наконец, twist специфицирует величину, на которую точка просмотра поворачивается вокруг линии зрения с использованием правила правой руки.
swf_popmatrix
(PHP 4)
swf_popmatrix - восстанавливает матрицу предыдущей трансформации.
Описание
void swf_popmatrix (void)
swf_popmatrix() проталкивает матрицу текущей трансформации обратно в стэк.
swf_posround
(PHP 4)
swf_posround - включает/отключает округление трансляции при размещении или перемещении объектов.
Описание
void swf_posround (int round)
swf_posround() включает/отключает округление трансляции при размещении или перемещении объектов; бывают моменты, когда текст становится более читабельным при включённом округлении. round указывает, включено округление или нет: если равен 1, округление включено, если 0 - округление отключено.
swf_pushmatrix
(PHP 4)
swf_pushmatrix - проталкивает матрицу текущей трансформации обратно стэк.
Описание
void swf_pushmatrix (void)
swf_removeobject
(PHP 4)
swf_removeobject - удаляет объект.
Описание
void swf_removeobject (int depth)
Удаляет объект на глубину depth.
swf_rotate
(PHP 4)
swf_rotate - поворачивает текущую трансформацию.
Описание
void swf_rotate (float angle, string axis)
swf_rotate() поворачивает текущую трансформацию на угол angle вокруг оси axis. Верными значениями для axis являются 'x' (ось x), 'y' (ось y) или 'z' (ось z).
