Содержание

addslashes

chop

chr

chunk_split

convert_cyr_string

crypt

echo

explode

flush

get_meta_tags

htmlspecialchars

htmlentities

implode

join

ltrim

md5

nl2br

ord

parse_str

print

printf

quoted_printable_decode

quotemeta

rawurldecode

rawurlencode

setlocale

soundex

sprintf

strchr

strcmp

strcspn

stripslashes

strlen

strrpos

strpos

strrchr

strrev

strspn

strstr

strtok

strtolower

strtoupper

str_replace

strtr

substr

trim

ucfirst

ucwords

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

AddSlashes

Описание

Возвращает строку с обратной чертой (/) перед символами, которые должны быть выделены в запросах к базам данных и т.п. Эти символы: ('), двойные кавычки ("), (\) и NUL (нулевой байт).

См. также stripslashes(), htmlspecialchars() и quotemeta().

Chop

Описание

Возвращает строку без повторяющихся пробелов.

Example 1. chop() $trimmed = Chop($line);

См. также trim().

Chr

Описание

возвращает односимвольную строку, содержащую символ, определенный кодом ascii.

Example 1. chr() $str .= chr(27); /* добавляет символ ESC в конец $str */ /* Часто это более полезно */ $str = sprintf("The string ends in escape: %c", 27);

Эта функция дополняет функцию ord(). См. также sprintf() с форматирующей строкой %c.

chunk_split

Описание

Может быть использована для разбития строки на более меньшие части, например, при конвертировании результата функции base64_encode в формат RFC 2045. Функция вставляет каждый chunklen-ый (по умолчанию до 76) символ строку end (по умолчанию "\r\n"). Функция возвращает новую строку, оставляя исходную не тронутой.

Example 1. chr_replace() # format $data using RFC 2045 semantics $new_string = chunk_split(base64_encode($data));

Эта функция значительно быстрее, чем ereg_replace().

convert_cyr_string

Описание

Эта функция переводит указанную строку из одной русской кодовой таблицы в другую. Аргументы from и to являются одним символом, который определяет исходную и целевую кодовую таблицу. Поддерживаемые типы:

• k - koi8-r

• w - windows-1251

• i - iso8859-5

• a - x-cp866

• d - x-cp866

• m - x-mac-cyrillic

crypt

Описание

crypt() Зашифрует строку, используя стандартный метод шифрации UNIX DES. Аргументы являются строкой, которую нужно зашифровать, и дополнительная 2-символная строка salt, на которой будет основываться шифрование. См. документацию UNIX для дополнительной информации.

Если аргумент salt отсутствует, то он буде генерирован случайным образом.

Некоторые операционные системы поддерживают больше одного типа шифрования. В действительности, иногда метод шифрования DES заменятеся основанными на MD5 алгоритмами. Тип шифрования устанавливается аргументом salt. Во время установки PHP определяет возможности функций шифрации и будет поддерживать аргумент salt для других методов шифрации. Если параметр salt не установлен, то PHP автоматически сгенерирует стандартный 2-х символный ключ DES, если же в системе по умолчанию установлен тип шифрации MD5, то будет сгенерирован MD5-совместимый ключ.

Стандартная шифрация DES crypt() содержит ключ в двух первых символах потока вывода.

Нет других функций дешифрации, кроме crypt() использующей однопроходный алгоритм.

echo

Описание

Выводит все параметры.

echo() в действительности не является функцией (это языковая конструкция), поэтому вам не обязательно использовать круглые скобки.

Пример 1. echo echo "Hello World";

См. также: print() printf() flush()

explode

Описание

Возвращает массив строк, содержащий в элементы, разделенные срокой separator.

Пример 1. explode() $pizza = "piece1 piece2 piece3 piece4 piece5 piece6"; $pieces = explode(" ", $pizza);

См. также split() и implode().

flush

Описание

Освобождает буферы вывода PHP и все остальные, использумые PHP (CGI, web-сарвер и т.д.). Это эффективная возможность выдать все накопленное в буферах в броузер пользователя.

get_meta_tags

Описание

Открывает файл filename и обрабатывает его строка за строкой и извлекает теги <meta>.

Пример 1. Теги Meta <meta name="author" content="name"> <meta name="tags" content="php3 documentation"> </head> <!-- parsing stops here -->

(обратите внимание на окончание строк - PHP3 использует интеллектуальную функцию для обработки входного потока, поэтому файлы MAC не будут работать на Unox).

Значение свойства name становится ключем, значение свойства content становится значением возвращаемого массива, поэтому вы можете легко использовать стандартные функции для его обработки или доступа к отдельным элементам. Специальные символы в значении свойства заменяются символом '_', остальные переводятся в нижний регистр.

Установка параметра use_include_path в 1 приведет к тому, что PHP3 будет пытаться открыть файл по стандартному include пути.

htmlspecialchars

Описание

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

Эта функция полезна для отчистки полученного от пользователя текста от разметки HTML (доски сообщений, гостевые книги).

В настоящее время осуществляются следующие замены:

• '&' (амперсанд) становится '&amp;'

• '"' (двойные кавычки) становится '&quot;'

• '<' (знак меньше) становится '&lt;'

• '>' (знак больше) становится '&gt;'

Следует отметить, что эта функция не заменяет ничего, кроме указанного выше. Для полной обработки см. функцию htmlentities().

См. также htmlentities() и nl2br().

htmlentities

Описание

Эта функция идентична htmlspecialchars() , кроме того, что все символы, которые имеют соответсвующий код HTML заменяются на этот HTML код.

В настоящее время применятеся кодовая таблица ISO-8859-1.

См. также htmlspecialchars() и nl2br().

implode

Описание

Возвращает строку, содержащую совокупность всех элементов массива в том же порядке, со строкой glue между каждым элементом.

Пример 1. implode() $colon_separated = implode($array, ":");

См. также explode(), join(), и split().

join

Описание

join() является псевдонимом функции implode(), и полностью ей идентична.

ltrim

Описание

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

См. также chop() и trim().

md5

Описание

Вычисляет значение MD5 для строки str используя алгоритм RSA Data Security, Inc. MD5 Message-Digest.

nl2br

Описание

Возвращает string с '<BR>' вставляемыми перед каждой новой строкой.

См. также htmlspecialchars() и htmlentities().

Ord

Описание

Возвращает ASCII-значение первого символа строки string. Эта функция дополняет функцию chr().

Пример 1. ord() if (ord($str) == 10) { echo("The first character of \$str is a line feed.\n"); }

См. также chr().

parse_str

Описание

Разбирает строку str , как если бы она была URL-строкой запроса, и устанавливает переменные текущей среды.

Пример 1. Using parse_str() $str = "first=value&second[]=this+works&second[]=another"; parse_str($str); echo $first; /* prints "value" */ echo $second[0]; /* prints "this works" */ echo $second[1]; /* prints "another" */

print

Описание

Выводит строку arg.

См. также: echo() printf() flush()

printf

Описание

Осуществляет вывод в соответствии с параметром format, который расписан в описании функции sprintf().

См. также: print(), sprintf(), и flush().

quoted_printable_decode

Описание

Эта функция возвращает 8-битную строку, соответствующую декодированной сроке в кавычках. Эта функция аналогична imap_qprint(), за исключением того, что она не требует IMAP модуль для работы.

QuoteMeta

Описание

Возвращает обработанную str с символами (\) перед каждым из следующих символов:

. \\ + * ? [ ^ ] ( $ )

См. также addslashes(), htmlentities(), htmlspecialchars(), nl2br(), и stripslashes().

rawurldecode

Описание

Возвращает строку, в которой последовательность из символа процента (%) с последующих 2-х шестнадцатиричных цифр заменяется соответствующим буквенным символом. Например, строку

foo%20bar%40baz

foo bar@baz

См. также rawurlencode().

rawurlencode

Описание

Возвращает строку, в которой все не буквенно-цифровые символы, кроме

-_.

echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'),
     '@ftp.my.com/x.txt">';

echo '<A HREF="http://x.com/department_list_script/',
     rawurlencode ('sales и marketing/Miami'), '">';

См. также rawurldecode().

setlocale

Описание

category является строкой, определяющей категорию функций, изменяемую строкой locale:

• LC_ALL для всех нижеследующих

• LC_COLLATE для сравнения строк - в данное время не обрабатывается PHP

• LC_CTYPE для классификации и перевода символов, например: strtoupper()

• LC_MONETARY для localeconv() - в данное время не обрабатывается PHP

• LC_NUMERIC для десятичного разделителя

• LC_TIME для даты и времени, форматируемых функцией strftime()

Если locale является пустой строкой "", то локальные имена будут установлены из значений переменных окружения с теми же именами, как у вышеописанных категорий, или из "LANG".

Если locale равна нулю или "0", то местные установки не изменяются, возвращаются текущие установки.

Setlocale возвращает новое текущее locale, или false, если locale функционально не поддерживается текущей платформой, указанный locale не существует или категории неверное. Неверное имя категории также вызывает предупреждающее сообщение.

soundex

Описание

Вычисляет soundex ключ для str.

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

Эта функция описана Дональдом Кнутом в книге "The Art Of Computer Programming, vol. 3: Sorting и Searching", Addison-Wesley (1973), pp. 391-392.

Пример 1. Soundex soundex("Euler") == soundex("Ellery") == 'E460'; soundex("Gauss") == soundex("Ghosh") == 'G200'; soundex("Knuth") == soundex("Kant") == 'H416'; soundex("Lloyd") == soundex("Ladd") == 'L300'; soundex("Lukasiewicz") == soundex("Lissajous") == 'L222';

sprintf

Описание

Возвращает строку, обрабатываемую в соответствии с форматирующей строкой format.

Форматирующая строка, содержащая ноль или более директив: обычные символы (кроме %) которые копируются прямо в результат, и that are copied directly to the result, и описания изменений, каждое из которых выполняет определенные действия. Это применительно и к sprintf() и к printf()

Каждое описание изменений состоит из следующих элементов, в порядке:

1. Дополнительный описатель заполнения, который говорит, какие символы будут использоваться для заполнения результата до правильног размера строки. Это могут быть пробелы или 0 (символ нуля). По умолчанию заполняется пробелами. Алтернативный символ заполнения может быть определен одинарной кавычкой ('). См. примеры ниже.

2. Дополнительный описатель выравнивания , который говорит, что результат должен быть выравнен по левому или по правому краю. По умолчанию выравнивание происходит по правому краю; символ - приведет к вырвниванию по левому краю.

3. Дополнительный описатель ширины, который говорит, с каким количеством символов (минимум) пожет производится данная замена.

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

5. Описатель типа, который говорит о том, как тип данных аргумента должен трактоваться. Возможные типы:

   % - символ процента. Аргумент не требуется.

   b - аргумент трактуется как integer и представляется как двоичное число.

   c - аргумент трактуется как integer и представляется как символ с ASCII значением.

   d - аргумент трактуется как integer и представляется как десятичное число.

   f - аргумент трактуется как double и представляется как число с плавающей точкой.

   o - аргумент трактуется как integer и представляется как восьмиричное число.

   s - аргумент трактуется и представляется как строка.

   x - аргумент трактуется как integer и представляется как шестнадцатиричное число (с буквами в нижнем регистре).

   X - аргумент трактуется как integer и представляется как шестнадцатиричное число (с буквами в верхнем регистре).

См. также: printf(), number_format()

Примеры

Пример 1. sprintf: числа с нулями $isodate = sprintf("%04d-%02d-%02d", $year, $month, $day);

Пример 2. sprintf: форматирование денежной еденицы $money1 = 68.75; $money2 = 54.35; $money = $money1 + $money2; // echo $money will output "123.1"; $formatted = sprintf ("%01.2f", $money); // echo $formatted will output "123.10"

strchr

Описание

Эта функция является псевдонимом для функции strstr(), и полностью ей идентична.

strcmp

Описание

Возвращает < 0 если str1 меньше чем str2; > 0 если str1 больше чем str2, и 0 если они равны.

Следует отметить, что это сравнение чуствительно к регистру.

См. также ereg(), substr(), и strstr().

strcspn

Описание

Возвращает длину начального сегмента str1, который не содержит любые символы в str2.

См. также strspn().

StripSlashes

Описание

Возвращает строку с вырезанными символами \. (\' заменяется на ' и так далее). Двойные \\ заменяются на \.

См. также addslashes().

strlen

Описание

Возвращает длину строки string.

strrpos

Описание

Возвращает номер позиции последнего появления символа needle в строке haystack. Следует отметить, что needle в этом случае может быть только единственным символом. Если в качестве параметра needle указывается строка, то только первый символ будет использован.

Если needle не найден, то возвращается false.

Если параметр needle не является строкой, то он переводится в десятичное число и рассматривается как числовое значение символа.

См. также strpos(), strrchr(), substr(), и strstr().

strpos

Описание

Возвращает номер позиции первого появления строки needle в строке haystack. В отличии от strrpos(), эта функция может рассматривать целую строку в качестве параметра needle и целая строка будет использоваться.

Если параметр needle не найден, то возвращается false.

Если параметр needle не является строкой, то он переводится в целое число и рассматривается как числовое значение символа.

Дополнительный параметр offset позволяет вам пределять, с какого символа в строке haystack начинать поиск. Позиция возвращается все равно относительно начала строки haystack.

См. также strrpos(), strrchr(), substr(), и strstr().

strrchr

Описание

Эта функция возвращает позицию haystack, с которой начинается последнее появление needle и продолжается до конца haystack.

Возвращает false если needle не найдена.

Если параметрneedle содержит более чем один символ, то используется первый символ.

Если параметр needle не является строкой, то он переводится в целое число и рассматривается как числовое значение символа.

Пример 1. strrchr() // получение последней директории в $PATH $dir = substr( strrchr( $PATH, ":" ), 1 ); // получение всего после последней новой строки $text = "Line 1\nLine 2\nLine 3"; $last = substr( strrchr( $text, 10 ), 1 );

См. также substr() и strstr().

strrev

Описание

Возвращает перевернутую строку string.

strspn

Описание

Возвращает длину начального сегмента строки str1, который содержит все символы из str2.

См. также strcspn().

strstr

Описание

Возвращает все haystack с первого появления строкиneedle и до конца.

Если параметр needle не найден, то возвращается false.

Если параметр needle не является строкой, то он переводится в целое число и рассматривается как числовое значение символа.

См. также strrchr(), substr(), и ereg().

strtok

Описание

strtok() используется для разбития строки. Это значит, что если вы имеете строку типа "This is an example string", то вы можете разбить эту строку на отдельные слова используя пробел в качестве разделителя.

Пример 1. strtok() $string = "This is an example string"; $tok = strtok($string," "); while($tok) { echo "Word=$tok<br>"; $tok = strtok(" "); }

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

Также будьте внимательны к разделителям равным "0". Это может вызвать ошибку в определенных выражених.

См. также split() и explode().

strtolower

Описание

Возвращает сроку string со всеми буквенными символами, переведенными в нижний регистр.

Помните, что буквенные символы определяются текущими локальными установками.

См. также strtoupper() и ucfirst().

strtoupper

Описание

Возвращает строку string со всеми буквенными символами, переведенными в верхний регистр.

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

См. также strtolower() и ucfirst().

str_replace

Описание

Эта функция заменяет все вхождения строки needle в строке haystack на указанную строку str. Если вам не требуются причудливые правила замены, то вам следует всегда использовать эту функцию вместо ereg_replace().

Пример 1. str_replace() $bodytag = str_replace("%body%", "black", "<body text=%body%>");

Эта функция двоично-безопасная.

См. также ereg_replace().

strtr

Описание

Эта функция обрабатывает строку str, заменяя все появления каждого символа из строки from на соответствующие символы в строке to, и возвращает результат.

Если строки from и to имеют различную длину, то дополнительные символы более длинной из строк игнорируются.

Пример 1. strtr() $addr = strtr($addr, "дец", "aao");

См. также ereg_replace().

substr

Описание

Эта функция возвращает часть строки string, определяемую параметрами start (начало) и length (длина).

Если параметр start положительный, то возвращаемая строка будет начинаться с start-ого символа строки string. Примеры:

$rest = substr("abcdef", 1); // вернет "bcdef"
$rest = substr("abcdef", 1, 3); // вернет "bcd"

Если параметр start отрицательный, то возвращаемая строка будет начинаться start-ого символа от конца строкиstring. Примеры:

$rest = substr("abcdef", -1); // вернет "f"
$rest = substr("abcdef", -2); // вернет "ef"
$rest = substr("abcdef", -3, 1); // вернет "d"

Если параметр length указан и он положительный, то возвращаемая строка закончится за length символов от начала start. Это приведет к строке с отрицательной длиной (потому что начало будет за концом строки), поэтому возвращаемая строка будет содержать один символ от начала строки start.

Если length указан и он отрицательный, то возвращаемая строка закончится за length от конца строки string. Это приведет к строке с отрицательной длиной, поэтому возвращаемая строка будет содержать один символ от начала строки start. Примеры:

$rest = substr("abcdef", -1, -1); // вернет "bcde"

См. также strrchr() и ereg().

trim

Описание

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

См. также chop() и ltrim().

ucfirst

Описание

Делает заглавным первый символ строки str, если этот символ буквенный.

Следует напомнить, что 'буквенные' символы определяются текущими настройками.

См. также strtoupper() и strtolower().

ucwords

Описание

Делает заглавным первый символ каждого слова в строке str, если этот символ буквенный.

См. также strtoupper(), strtolower() и ucfirst().