Руководство по РНР 3.0 - Строковые функции

Содержание
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.

AddSlashesAddSlashes -- выделяет строку обратной чертой

Описание

string addslashes(string str);

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

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

ChopChop -- удаляет повторяющиеся пробелы

Описание

string chop(string str);

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

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

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

ChrChr -- возвращает специалный символ

Описание

string chr(int ascii);

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

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

chunk_splitchunk_split -- разбивает строку на мелкие части

Описание

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));
Эта функция значительно быстрее, чем ereg_replace().

convert_cyr_stringconvert_cyr_string -- переводит из одной русской кодовой таблицы в другую

Описание

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

cryptcrypt -- шифрует строку методом DES

Описание

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() использующей однопроходный алгоритм.

echoecho -- выводит одно или более строк

Описание

echo(string arg1, string [argn]...);

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

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

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

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

explodeexplode -- разбивает строку на строки

Описание

array explode(string separator, string string);

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

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

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

flushflush -- освобождает буферы вывода

Описание

void flush(void);

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

get_meta_tagsget_meta_tags -- Извлекает все содержимое атрибутов тег meta из файла и возвращает в массиве

Описание

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

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

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

htmlspecialcharshtmlspecialchars -- Переводит специальные символы в коды HTML

Описание

string htmlspecialchars(string string);

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

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

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

'&' (амперсанд) становится '&'
'"' (двойные кавычки) становится '"'
'<' (знак меньше) становится '<'
'>' (знак больше) становится '>'

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

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

htmlentitieshtmlentities -- Переводит все возможные символы в коды HTML.

Описание

string htmlentities(string string);

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

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

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

implodeimplode -- Объединяет массив элементов в строку

Описание

string implode(array pieces, string glue);

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

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

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

joinjoin -- Присоединяет элементы массива к строке

Описание

string join(array pieces, string glue);

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

ltrimltrim -- Удаляет пробелы из начала строки.

Описание

string ltrim(string str);

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

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

md5md5 -- Вычисляет значение md5 для строки

Описание

string md5(string str);

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

nl2brnl2br -- Переводит символы новой строки в HTML-тег разрыва строки

Описание

string nl2br(string string);

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

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

OrdOrd -- Возвращает ASCII-значение символа

Описание

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().

parse_strparse_str -- Разбирает строку на переменные

Описание

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" */

printprint -- выводит строку

Описание

print(string arg);

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

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

printfprintf -- выводит форматированную строку

Описание

int printf(string format, mixed [args]...);

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

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

quoted_printable_decodequoted_printable_decode -- переводит строку в кавычках в 8-битную строку

Описание

string quoted_printable_decode(string str);

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

QuoteMetaQuoteMeta -- выделяет meta символы

Описание

int quotemeta(string str);

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

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

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

rawurldecoderawurldecode -- декодирует URL-кодированную строку

Описание

string rawurldecode(string str);

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

foo%20bar%40baz

будет заменена на

foo bar@baz

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

rawurlencoderawurlencode -- URL-кодирует строку в соответствии с RFC1738

Описание

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">';

Или, если передаете информацию в качестве части URL:

Пример 2. rawurlencode()

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

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

setlocalesetlocale -- Устанавливает локальную информацию

Описание

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

soundexsoundex -- вычисляет soundex ключ для строки

Описание

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';

sprintfsprintf -- возвращает форматированную строку

Описание

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"

strchrstrchr -- Находит первое появление символа.

Описание

string strchr(string haystack, string needle);

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

strcmpstrcmp -- Двоичное сравнение строк (безопасное)

Описание

int strcmp(string str1, string str2);

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

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

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

strcspnstrcspn -- находит длину нечального сегмента, не совпадающего с маской

Описание

int strcspn(string str1, string str2);

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

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

StripSlashesStripSlashes -- удаляет символы \ из строки

Описание

string stripslashes(string str);

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

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

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

Описание

int strlen(string str);

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

strrposstrrpos -- Находит позицию последего появления символа в строке

Описание

int strrpos(string haystack, char needle);

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

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

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

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

strposstrpos -- Находит позицию первого появления строки.

Описание

int strpos(string haystack, string needle, int [offset]);

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

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

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

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

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

strrchrstrrchr -- Находит последнее появление символа в строке

Описание

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().

strrevstrrev -- Переворачивает строку

Описание

string strrev(string string);

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

strspnstrspn -- Находит длину начального сегмента, отвечающего маске

Описание

int strspn(string str1, string str2);

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

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

strstrstrstr -- Находит первое появление строки

Описание

string strstr(string haystack, string needle);

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

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

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

strtokstrtok -- Разбивает строку

Описание

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().

strtolowerstrtolower -- Переводит строку в нижний регистр

Описание

string strtolower(string str);

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

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

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

strtoupperstrtoupper -- Переводит строку в верхний регистр

Описание

string strtoupper(string string);

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

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

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

str_replacestr_replace -- Заменяет все вхождения строки на указанную строку

Описание

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().

strtrstrtr -- Переводит определенные символы

Описание

string strtr(string str, string from, string to);

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

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

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

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

substrsubstr -- Возвращает часть строки

Описание

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"

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

trimtrim -- Обрезает пробелы с начала и с конца строки

Описание

string trim(string str);

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

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

ucfirstucfirst -- Переводит первый символ строки в верхний регистр

Описание

string ucfirst(string str);

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

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

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

ucwordsucwords -- Переводит в верхний регистр первые символы каждого слова в строке

Описание

string ucwords(string str);

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

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

Содержание