Все эти функции манипулируют строками различными способами. Некоторые более специализированные функции вы можете найти в разделах о регулярных выражениях и о функциях обработки URL.
string addslashes(string str);
Возвращает строку с обратной чертой (/) перед символами, которые должны быть выделены в запросах к базам данных и т.п. Эти символы: ('), двойные кавычки ("), (\) и NUL (нулевой байт).
См. также stripslashes(), htmlspecialchars() и quotemeta().
string chop(string str);
Возвращает строку без повторяющихся пробелов.
|
Example 1. chop() $trimmed = Chop($line); |
См. также trim().
string chr(int ascii);
возвращает односимвольную строку, содержащую символ, определенный кодом ascii.
|
Example 1. chr() $str .= chr(27); /* добавляет символ ESC в конец $str */
/* Часто это более полезно */
$str = sprintf("The string ends in escape: %c", 27); |
string chunk_split(string string, int [chunklen]
, string [end]
);
Может быть использована для разбития строки на более меньшие части, например, при конвертировании результата функции 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)); |
string convert_cyr_string(string str, string from, string to);
Эта функция переводит указанную строку из одной русской кодовой таблицы в другую. Аргументы from и to являются одним символом, который определяет исходную и целевую кодовую таблицу. Поддерживаемые типы:
k - koi8-r
w - windows-1251
i - iso8859-5
a - x-cp866
d - x-cp866
m - x-mac-cyrillic
string crypt(string str, string [salt]);
crypt() Зашифрует строку, используя стандартный метод шифрации UNIX DES. Аргументы являются строкой, которую нужно зашифровать, и дополнительная 2-символная строка salt, на которой будет основываться шифрование. См. документацию UNIX для дополнительной информации.
Если аргумент salt отсутствует, то он буде генерирован случайным образом.
Некоторые операционные системы поддерживают больше одного типа шифрования. В действительности, иногда метод шифрования DES заменятеся основанными на MD5 алгоритмами. Тип шифрования устанавливается аргументом salt. Во время установки PHP определяет возможности функций шифрации и будет поддерживать аргумент salt для других методов шифрации. Если параметр salt не установлен, то PHP автоматически сгенерирует стандартный 2-х символный ключ DES, если же в системе по умолчанию установлен тип шифрации MD5, то будет сгенерирован MD5-совместимый ключ.
Стандартная шифрация DES crypt() содержит ключ в двух первых символах потока вывода.
Нет других функций дешифрации, кроме crypt() использующей однопроходный алгоритм.
echo(string arg1, string [argn]...);
Выводит все параметры.
echo() в действительности не является функцией (это языковая конструкция), поэтому вам не обязательно использовать круглые скобки.
|
Пример 1. echo echo "Hello World"; |
См. также: print() printf() flush()
array explode(string separator, string string);
Возвращает массив строк, содержащий в элементы, разделенные срокой separator.
|
Пример 1. explode() $pizza = "piece1 piece2 piece3 piece4 piece5 piece6";
$pieces = explode(" ", $pizza); |
См. также split() и implode().
void flush(void);
Освобождает буферы вывода PHP и все остальные, использумые PHP (CGI, web-сарвер и т.д.). Это эффективная возможность выдать все накопленное в буферах в броузер пользователя.
array get_meta_tags(string filename, int
[use_include_path]);
Открывает файл filename и обрабатывает его строка за строкой и извлекает теги <meta>.
|
Пример 1. Теги Meta <meta name="author" content="name"> <meta name="tags" content="php3 documentation"> </head> <!-- parsing stops here --> |
Значение свойства name становится ключем, значение свойства content становится значением возвращаемого массива, поэтому вы можете легко использовать стандартные функции для его обработки или доступа к отдельным элементам. Специальные символы в значении свойства заменяются символом '_', остальные переводятся в нижний регистр.
Установка параметра use_include_path в 1 приведет к тому, что PHP3 будет пытаться открыть файл по стандартному include пути.
string htmlspecialchars(string string);
Определенные символы имеют особое значение в HTML и должны быть заменены кодами HTML, если они таковые имеют. Эта функция возвращает строки с произведенными такими изменениями.
Эта функция полезна для отчистки полученного от пользователя текста от разметки HTML (доски сообщений, гостевые книги).
В настоящее время осуществляются следующие замены:
'&' (амперсанд) становится '&'
'"' (двойные кавычки) становится '"'
'<' (знак меньше) становится '<'
'>' (знак больше) становится '>'
Следует отметить, что эта функция не заменяет ничего, кроме указанного выше. Для полной обработки см. функцию htmlentities().
См. также htmlentities() и nl2br().
string htmlentities(string string);
Эта функция идентична htmlspecialchars() , кроме того, что все символы, которые имеют соответсвующий код HTML заменяются на этот HTML код.
В настоящее время применятеся кодовая таблица ISO-8859-1.
См. также htmlspecialchars() и nl2br().
string implode(array pieces, string glue);
Возвращает строку, содержащую совокупность всех элементов массива в том же порядке, со строкой glue между каждым элементом.
|
Пример 1. implode() $colon_separated = implode($array, ":"); |
См. также explode(), join(), и split().
string join(array pieces, string glue);
join() является псевдонимом функции implode(), и полностью ей идентична.
string ltrim(string str);
Эта функция удаляет пробелы из начала строки и возвращает обрезаную строку.
string md5(string str);
Вычисляет значение MD5 для строки str используя алгоритм RSA Data Security, Inc. MD5 Message-Digest.
string nl2br(string string);
Возвращает string с '<BR>' вставляемыми перед каждой новой строкой.
См. также htmlspecialchars() и htmlentities().
int ord(string string);
Возвращает ASCII-значение первого символа строки string. Эта функция дополняет функцию chr().
|
Пример 1. ord() if (ord($str) == 10) {
echo("The first character of \$str is a line feed.\n");
} |
См. также chr().
void parse_str(string 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(string arg);
Выводит строку arg.
См. также: echo() printf() flush()
int printf(string format, mixed [args]...);
Осуществляет вывод в соответствии с параметром format, который расписан в описании функции sprintf().
См. также: print(), sprintf(), и flush().
string quoted_printable_decode(string str);
Эта функция возвращает 8-битную строку, соответствующую декодированной сроке в кавычках. Эта функция аналогична imap_qprint(), за исключением того, что она не требует IMAP модуль для работы.
int quotemeta(string str);
Возвращает обработанную str с символами (\) перед каждым из следующих символов:
. \\ + * ? [ ^ ] ( $ )
См. также addslashes(), htmlentities(), htmlspecialchars(), nl2br(), и stripslashes().
string rawurldecode(string str);
Возвращает строку, в которой последовательность из символа процента (%) с последующих 2-х шестнадцатиричных цифр заменяется соответствующим буквенным символом. Например, строку
foo%20bar%40bazбудет заменена на
foo bar@baz
См. также rawurlencode().
string rawurlencode(string str);
Возвращает строку, в которой все не буквенно-цифровые символы, кроме
-_.заменяются на знак (%) с последующими двумя шестнадцатиричными цифрами. Это кодирование, описанное в RFC1738, применяется для защиты символов от интерпритации их как особых разделителей URL, и для защиты URL от искажения системами передачи данных с переводом символов (как некоторые e-mail системы). Например, если вы хотите включить пароль в ftp URL:
|
Пример 1. rawurlencode() echo '<A HREF="ftp://user:', rawurlencode ('foo @+%/'),
'@ftp.my.com/x.txt">'; |
|
Пример 2. rawurlencode() echo '<A HREF="http://x.com/department_list_script/',
rawurlencode ('sales и marketing/Miami'), '">'; |
См. также rawurldecode().
string setlocale(string category, string locale);
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 не существует или категории неверное. Неверное имя категории также вызывает предупреждающее сообщение.
string soundex(string str);
Вычисляет 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(string format, mixed [args]...);
Возвращает строку, обрабатываемую в соответствии с форматирующей строкой format.
Форматирующая строка, содержащая ноль или более директив: обычные символы (кроме %) которые копируются прямо в результат, и that are copied directly to the result, и описания изменений, каждое из которых выполняет определенные действия. Это применительно и к sprintf() и к printf()
Каждое описание изменений состоит из следующих элементов, в порядке:
Дополнительный описатель заполнения, который говорит, какие символы будут использоваться для заполнения результата до правильног размера строки. Это могут быть пробелы или 0 (символ нуля). По умолчанию заполняется пробелами. Алтернативный символ заполнения может быть определен одинарной кавычкой ('). См. примеры ниже.
Дополнительный описатель выравнивания , который говорит, что результат должен быть выравнен по левому или по правому краю. По умолчанию выравнивание происходит по правому краю; символ - приведет к вырвниванию по левому краю.
Дополнительный описатель ширины, который говорит, с каким количеством символов (минимум) пожет производится данная замена.
Дополнительный описатель точности, который говорит, сколько десятичных знаков следует отображать для чисел с плавающей точкой. Этот описатель не действует на остальные типы, кроме double. (другая полезная функция для форматирования чисел это number_format().)
Описатель типа, который говорит о том, как тип данных аргумента должен трактоваться. Возможные типы:
| % - символ процента. Аргумент не требуется. |
| 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" |
string strchr(string haystack, string needle);
Эта функция является псевдонимом для функции strstr(), и полностью ей идентична.
int strcmp(string str1, string str2);
Возвращает < 0 если str1 меньше чем str2; > 0 если str1 больше чем str2, и 0 если они равны.
Следует отметить, что это сравнение чуствительно к регистру.
См. также ereg(), substr(), и strstr().
int strcspn(string str1, string str2);
Возвращает длину начального сегмента str1, который не содержит любые символы в str2.
См. также strspn().
string stripslashes(string str);
Возвращает строку с вырезанными символами \. (\' заменяется на ' и так далее). Двойные \\ заменяются на \.
См. также addslashes().
int strlen(string str);
Возвращает длину строки string.
int strrpos(string haystack, char needle);
Возвращает номер позиции последнего появления символа needle в строке haystack. Следует отметить, что needle в этом случае может быть только единственным символом. Если в качестве параметра needle указывается строка, то только первый символ будет использован.
Если needle не найден, то возвращается false.
Если параметр needle не является строкой, то он переводится в десятичное число и рассматривается как числовое значение символа.
См. также strpos(), strrchr(), substr(), и strstr().
int strpos(string haystack, string needle, int [offset]);
Возвращает номер позиции первого появления строки needle в строке haystack. В отличии от strrpos(), эта функция может рассматривать целую строку в качестве параметра needle и целая строка будет использоваться.
Если параметр needle не найден, то возвращается false.
Если параметр needle не является строкой, то он переводится в целое число и рассматривается как числовое значение символа.
Дополнительный параметр offset позволяет вам пределять, с какого символа в строке haystack начинать поиск. Позиция возвращается все равно относительно начала строки haystack.
См. также strrpos(), strrchr(), substr(), и strstr().
string strrchr(string haystack, string needle);
Эта функция возвращает позицию 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().
string strrev(string string);
Возвращает перевернутую строку string.
int strspn(string str1, string str2);
Возвращает длину начального сегмента строки str1, который содержит все символы из str2.
См. также strcspn().
string strstr(string haystack, string needle);
Возвращает все haystack с первого появления строкиneedle и до конца.
Если параметр needle не найден, то возвращается false.
Если параметр needle не является строкой, то он переводится в целое число и рассматривается как числовое значение символа.
См. также strrchr(), substr(), и ereg().
string strtok(string arg1, string arg2);
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().
string strtolower(string str);
Возвращает сроку string со всеми буквенными символами, переведенными в нижний регистр.
Помните, что буквенные символы определяются текущими локальными установками.
См. также strtoupper() и ucfirst().
string strtoupper(string string);
Возвращает строку string со всеми буквенными символами, переведенными в верхний регистр.
Следует отметить, что буквенные символы определяются текущими локальными установками.
См. также strtolower() и ucfirst().
string str_replace(string needle, string str, string haystack);
Эта функция заменяет все вхождения строки needle в строке haystack на указанную строку str. Если вам не требуются причудливые правила замены, то вам следует всегда использовать эту функцию вместо ereg_replace().
|
Пример 1. str_replace() $bodytag = str_replace("%body%", "black", "<body text=%body%>");
|
Эта функция двоично-безопасная.
См. также ereg_replace().
string strtr(string str, string from, string to);
Эта функция обрабатывает строку str, заменяя все появления каждого символа из строки from на соответствующие символы в строке to, и возвращает результат.
Если строки from и to имеют различную длину, то дополнительные символы более длинной из строк игнорируются.
|
Пример 1. strtr() $addr = strtr($addr, "дец", "aao");
|
См. также ereg_replace().
string substr(string string, int start, int [length]);
Эта функция возвращает часть строки 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"
string trim(string str);
Эта функция обрезает пробеды с начала и с конца строки и возвращает обрезанную строку.
string ucfirst(string str);
Делает заглавным первый символ строки str, если этот символ буквенный.
Следует напомнить, что 'буквенные' символы определяются текущими настройками.
См. также strtoupper() и strtolower().
string ucwords(string str);
Делает заглавным первый символ каждого слова в строке str, если этот символ буквенный.
См. также strtoupper(), strtolower() и ucfirst().
Назад | Содержание | Вперед