str

• class str (php\lib\str).

use php\lib\str;

Класс для работы со строками в php, состоит только из статических методов, экземпляр класса создать невозможно.

---

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

• str :: pos()
• str :: posIgnoreCase()
• str :: lastPos()
• str :: lastPosIgnoreCase()
• str :: sub()
• str :: compare()
• str :: compareIgnoreCase()
• str :: equalsIgnoreCase()
• str :: startsWith()
• str :: endsWith()
• str :: lower()
• str :: lowerFirst()
• str :: upper()
• str :: upperFirst()
• str :: length()
• str :: replace()
• str :: repeat()
• str :: trim()
• str :: trimRight()
• str :: trimLeft()
• str :: reverse()
• str :: shuffle()
• str :: random()
• str :: split()
• str :: join()
• str :: encode()
• str :: decode()
• str :: isNumber()
• str :: isLower()
• str :: isUpper()
• str :: format()
• str :: contains()
• str :: count()
• str :: uuid()
• str :: hash()
• str :: lines()

---

pos()

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

Метод ищет подстроку $search в строке $string и возвращает её позицию (начиная с нуля). Если ничего не было найдено, метод вернет -1. Метод учитывает регистр символов и позволяет начинать поиск с определенного по счету символа $fromIndex.

$search = 'родилась';
$string = 'В лесу родилась ёлочка';

$pos = str::pos($string, $search);

alert('Позиция = ' . $pos);

---

posIgnoreCase()

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

Метод не учитывает регистр символов при поиске. См. также pos().

Метод ищет подстроку $search в строке $string и возвращает её позицию (начиная с нуля). Если ничего не было найдено, метод вернет -1. Метод позволяет начинать поиск с определенного по счету символа $fromIndex.

---

lastPos()

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

Метод учитывает регистр символов при поиске.

Метод ищет подстроку $search в строке $string начиная с конца строки и возвращает её позицию (начиная с нуля). Если ничего не было найдено, метод вернет -1. Метод позволяет начинать поиск с определенного по счету символа $fromIndex, по-умолчанию он равен null, что означает - искать, начиная с последнего символа строки.

$string = 'ту-ту-ру';
$search = 'ту';

$pos = str::lastPos($string, $search);
// $pos будет равен 3, а не 0, т.к. поиск идет с конца.

---

lastPosIgnoreCase()

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

Метод не учитывает регистр символов при поиске. См. также lastPos().

Метод ищет подстроку $search в строке $string начиная с конца строки и возвращает её позицию (начиная с нуля). Если ничего не было найдено, метод вернет -1. Метод позволяет начинать поиск с определенного по счету символа $fromIndex, по-умолчанию он равен null, что означает - искать, начиная с последнего символа строки.

---

sub()

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

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

$string = 'Hello World';

alert(str::sub($string, 6)); // выведет World, W - 6 символ.
alert(str::sub($string, 6, 9)); // выведет Wor, l - 9 символ.

---

compare()

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

Сравнивает две строки и возвращает результат в виде числа, где:

• 0 - означает, что строки равны.
• больше 0 - строка $string1 больше $string2.
• меньше 0 - строка $string1 меньше $string2.

---

compareIgnoreCase()

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

Сравнивает две строки и возвращает результат в виде числа. Метод идентичен compare(), за исключением того, что он при сравнении игнорирует регистр символов сравниваемых строк.

---

equalsIgnoreCase()

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

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

if (str::equalsIgnoreCase('ПРИВЕТ', 'привет')) {
   alert('ПРИВЕТ == привет, без учета регистра символов');
}

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

---

startsWith()

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

Возвращает true если строка $string начинается с префикс-строки $prefix. Можно указать, с какого символа по счету проверять префикс через третий аргумент $offset (индексация идет с нуля).

$string = 'gamedev';

if (str::startsWith($string, 'game')) {
    alert('Строка начинается со слова game');
}

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

---

endsWith()

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

Возвращает true если строка $string оканчивается суффикс-строкой $suffix.

$string = 'file.mp3';

if (str::endsWith($string, '.mp3')) {
    alert('Строка оканчивается на ".mp3"');
}

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