Skip to content

Latest commit

 

History

History
479 lines (348 loc) · 13.5 KB

str.ru.md

File metadata and controls

479 lines (348 loc) · 13.5 KB

str

  • класс str (php\lib\str)
  • пакет std
  • исходники php/lib/Str.php

Описание

Класс для работы со строками.


Статичные Методы

  • str ::pos() - Возвращает первую позицию найденной строки в подстроке, начиная
  • str ::posIgnoreCase() - Метод такой же как pos() только с игнорированием регистра символов.
  • str ::lastPos() - Возвращает позицию первой найденной подстроки в строке начиная с конца.
  • str ::lastPosIgnoreCase() - Метод такой же как lastPos() только с игнорированием регистра символов.
  • str ::sub() - Возвращает подстроку из другой строки, которая укзывается через
  • str ::compare() - Compares two strings lexicographically.
  • str ::compareIgnoreCase() - The same method as compare() only with ignoring case characters
  • str ::equalsIgnoreCase() - Checks that the strings are equal with ignoring case characters
  • str ::startsWith() - Tests if the substring of this string beginning at the
  • str ::endsWith() - Tests if this string ends with the specified suffix.
  • str ::lower() - Конвертирует все символы строки в нижний регистр и возвращает её.
  • str ::upper() - Конвертирует все символы строки в верхний регистр и возвращает её.
  • str ::length() - Возвращает длину строки.
  • str ::replace() - Заменяет каждую подстроку на другую.
  • str ::repeat() - Возвращает новую строку состояющую из повторов указанной строки.
  • str ::trim() - Возвращает копию строки без пробельных символов слева и справа.
  • str ::trimRight()
  • str ::trimLeft()
  • str ::reverse() - Возвращает перевернутую строку.
  • str ::shuffle() - Returns a randomized string based on chars in $string
  • str ::random() - Возвращает новую случайную строку основанную на наборе символов из $set.
  • str ::split() - Разбивает строку на массив используя строку-разделитель $separator.
  • str ::join() - Собирает массив в строку с разделителем $separator.
  • str ::encode() - Кодирует юникодную строку в любую другую кодировку и возвращает бинарную строку.
  • str ::decode() - Декодирует строку из указанной кодировке в родную юникодную строку.
  • str ::isNumber() - Returns true if $string is integer number (e.g: '12893', '3784', '0047')
  • str ::isLower()
  • str ::isUpper()
  • str ::lowerFirst()
  • str ::upperFirst()
  • str ::parseAs() - Parse text as json, ini, yaml, etc.
  • str ::formatAs() - Format value as ini, json, yml, etc.
  • str ::format()
  • str ::contains() - Возвращает true если строка содержит укзанную подстроку.
  • str ::count() - Возвращает количество найденный строк в другой строке.
  • str ::uuid()
  • str ::hash() - Возвращает хеш строки.
  • str ::lines() - Переводит многострочный текст в массив, если $removeEmpty true, то удаляет пустые строки из результата.

Методы


Статичные Методы

pos()

str::pos(string $string, string $search, int $fromIndex): int

Возвращает первую позицию найденной строки в подстроке, начиная с указанной позиции ($fromIndex). Если ничего не найдено, возвращает -1.


posIgnoreCase()

str::posIgnoreCase(string $string, string $search, int $fromIndex): int

Метод такой же как pos() только с игнорированием регистра символов.


lastPos()

str::lastPos(string $string, string $search, null|int $fromIndex): int

Возвращает позицию первой найденной подстроки в строке начиная с конца. Если ничего не найдено, возвращает -1.


lastPosIgnoreCase()

str::lastPosIgnoreCase(string $string, string $search, null|int $fromIndex): int

Метод такой же как lastPos() только с игнорированием регистра символов.


sub()

str::sub(string $string, int $beginIndex, null|int $endIndex): string

Возвращает подстроку из другой строки, которая укзывается через начальную позицию (включительно) $beginIndex и до конечной позиции (не включительно) $endIndex. В итоге длина подстроки будет равна $endIndex - $beginIndex.


compare()

str::compare(string $string1, string $string2): int

Compares two strings lexicographically. The comparison is based on the Unicode value of each character in the strings.

The character sequence represented by $string1 String is compared lexicographically to the character sequence represented by $string2. The result is a negative integer if $string1 lexicographically precedes $string2. The result is a positive integer if $string1 lexicographically follows $string2. The result is zero if the strings are equal; compare returns 0 exactly when the strings are equal


compareIgnoreCase()

str::compareIgnoreCase(string $string1, string $string2): int

The same method as compare() only with ignoring case characters


equalsIgnoreCase()

str::equalsIgnoreCase(string $string1, string $string2): bool

Checks that the strings are equal with ignoring case characters


startsWith()

str::startsWith(string $string, string $prefix, int $offset): bool

Tests if the substring of this string beginning at the specified index starts with the specified prefix.

Returns true if the character sequence represented by the argument is a prefix of the substring of this object starting at index offset; false otherwise. The result is false if toffset is negative or greater than the length of this $string; otherwise the result is the same as the result of the expression

.. code-block:: php

startsWith(sub($offset), $prefix)


endsWith()

str::endsWith(string $string, string $suffix): bool

Tests if this string ends with the specified suffix.


lower()

str::lower(string $string): string

Конвертирует все символы строки в нижний регистр и возвращает её.


upper()

str::upper(string $string): string

Конвертирует все символы строки в верхний регистр и возвращает её.


length()

str::length(string $string): int

Возвращает длину строки. Длина строки равна количеству юникодных единиц в строке.


replace()

str::replace(string $string, string $target, string $replacement): string

Заменяет каждую подстроку на другую.


repeat()

str::repeat(string $string, int $amount): string

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


trim()

str::trim(string $string, string $charList): string

Возвращает копию строки без пробельных символов слева и справа.


trimRight()

str::trimRight(string $string, string $charList): string

trimLeft()

str::trimLeft(string $string, string $charList): string

reverse()

str::reverse(string $string): string

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


shuffle()

str::shuffle(string $string): string

Returns a randomized string based on chars in $string


random()

str::random(int $length, string $set): string

Возвращает новую случайную строку основанную на наборе символов из $set.


split()

str::split(string $string, string $separator, int $limit): array

Разбивает строку на массив используя строку-разделитель $separator. Аналог функции explode() из zend php.


join()

str::join(array|\Iterator $iterable, string $separator, int $limit): string

Собирает массив в строку с разделителем $separator. Аналог функции implode() из zend php.


encode()

str::encode(string $string, string $charset): string

Кодирует юникодную строку в любую другую кодировку и возвращает бинарную строку.


decode()

str::decode(string $string, string $charset): string

Декодирует строку из указанной кодировке в родную юникодную строку.


isNumber()

str::isNumber(string $string, bool $bigNumbers): bool

Returns true if $string is integer number (e.g: '12893', '3784', '0047')

  • for 123 - true
  • for 00304 - true
  • for 3389e4 - false
  • for 3.49 - false
  • for 23 - false

isLower()

str::isLower(string $string): bool

isUpper()

str::isUpper(mixed $string): bool

lowerFirst()

str::lowerFirst(string $string): string

upperFirst()

str::upperFirst(string $string): string

parseAs()

str::parseAs(string $string, string $format, int $flags): mixed

Parse text as json, ini, yaml, etc.


formatAs()

str::formatAs(mixed $input, string $format, int $flags): string

Format value as ini, json, yml, etc.


format()

str::format(string $string, mixed $args): string

contains()

str::contains(string $string, string $search): bool

Возвращает true если строка содержит укзанную подстроку.


count()

str::count(string $string, string $subString, int $offset): int

Возвращает количество найденный строк в другой строке.


uuid()

str::uuid(null|string $value): string

hash()

str::hash(string $string, string $algorithm): string

Возвращает хеш строки.


lines()

str::lines(string $string, bool $removeEmpty): array

Переводит многострочный текст в массив, если $removeEmpty true, то удаляет пустые строки из результата.


Методы

__construct()

__construct(): void