Stringable
класс Stringable реализует JsonSerializable (Просмотреть исходный код)
Трейты
| Conditionable | |
| Macroable | |
| Tappable |
Свойства
| статический защищенный массив | $macros | Зарегистрированные макросы строк. | из Macroable |
| защищенная строка | $value | Основное строковое значение. |
Методы
| $this|mixed | when(mixed $value, callable $callback, callable|null $default = null)
Применить обработчик, если заданное «значение» истинно. | из Conditionable |
| $this|mixed | unless(mixed $value, callable $callback, callable|null $default = null)
Применить обработчик, если заданное «значение» ложно. | из Conditionable |
| static void | macro(string $name, object|callable $macro)
Зарегистрировать пользовательский макрос. | из Macroable |
| static void | mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс. | из Macroable |
| static bool | hasMacro(string $name)
Проверка регистрации макроса. | из Macroable |
| static void | flushMacros()
Очистить существующие макросы. | из Macroable |
| static mixed | __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы класса. | из Macroable |
| mixed | __call(string $method, array $parameters)
Динамически обрабатывать вызовы класса. | из Macroable |
| $this|HigherOrderTapProxy | tap(callable|null $callback = null)
Вызвать заданный замыкание с этим экземпляром, затем вернуть экземпляр. | из Tappable |
| void | __construct(string $value = '')
Создать новый экземпляр класса. | |
| Stringable | after(string $search)
Возвращает остаток строки после первого вхождения заданного значения. | |
| Stringable | afterLast(string $search)
Возвращает остаток строки после последнего вхождения заданного значения. | |
| Stringable | append(array ...$values)
Добавляет заданные значения к строке. | |
| Stringable | ascii(string $language = 'en')
Транслитерировать значение UTF-8 в ASCII. | |
| Stringable | basename(string $suffix = '')
Получить компонент имени, следующего за путем. | |
| Stringable | classBasename()
Получить basename пути класса. | |
| Stringable | before(string $search)
Получить часть строки перед первым вхождением заданного значения. | |
| Stringable | beforeLast(string $search)
Получить часть строки перед последним вхождением заданного значения. | |
| Stringable | between(string $from, string $to)
Получить часть строки между двумя заданными значениями. | |
| Stringable | camel()
Преобразовать значение в верблюжий регистр. | |
| bool | contains(string|array $needles)
Определить, содержит ли заданная строка заданную подстроку. | |
| bool | containsAll(array $needles)
Определить, содержит ли заданная строка все значения массива. | |
| Stringable | dirname(int $levels = 1)
Получить путь к родительскому каталогу. | |
| bool | endsWith(string|array $needles)
Определить, заканчивается ли заданная строка заданной подстрокой. | |
| bool | exactly(string $value)
Определить, является ли строка точным совпадением с заданным значением. | |
| Collection | explode(string $delimiter, int $limit = PHP_INT_MAX)
Разбить строку на массив. | |
| Collection | split(string|int $pattern, int $limit = -1, int $flags = 0)
Разделить строку с помощью регулярного выражения или по длине. | |
| Stringable | finish(string $cap)
Завершить строку одним экземпляром заданного значения. | |
| bool | is(string|array $pattern)
Определить, соответствует ли заданная строка заданному шаблону. | |
| bool | isAscii()
Определить, является ли заданная строка 7-битной ASCII. | |
| bool | isUuid()
Определить, является ли заданная строка корректным UUID. | |
| bool | isEmpty()
Определить, пуста ли заданная строка. | |
| bool | isNotEmpty()
Определить, не пуста ли заданная строка. | |
| Stringable | kebab()
Преобразовать строку в кебаб-регистр. | |
| int | length(string $encoding = null)
Возвращает длину заданной строки. | |
| Stringable | limit(int $limit = 100, string $end = '...')
Ограничить количество символов в строке. | |
| Stringable | lower()
Преобразовать заданную строку в нижний регистр. | |
| Stringable | markdown(array $options = [])
Преобразовать разметку Markdown в HTML в стиле GitHub. | |
| Stringable | mask(string $character, int $index, int|null $length = null, string $encoding = 'UTF-8')
Маскировать часть строки повторяющимся символом. | |
| Stringable | match(string $pattern)
Получить строку, соответствующую заданному шаблону. |
| Коллекция | matchAll(string $pattern)
Получить строку, соответствующую заданному шаблону. | |
| bool | test(string $pattern)
Определить, соответствует ли строка заданному шаблону. | |
| Строка | padBoth(int $length, string $pad = ' ')
Заполнить обе стороны строки другой строкой. | |
| Строка | padLeft(int $length, string $pad = ' ')
Заполнить левую сторону строки другой строкой. | |
| Строка | padRight(int $length, string $pad = ' ')
Заполнить правую сторону строки другой строкой. | |
| array | parseCallback(string|null $default = null)
Разбирать обратный вызов в стиле Class@method в класс и метод. | |
| Строка | pipe(callable $callback)
Вызвать переданный обратный вызов и вернуть новую строку. | |
| Строка | plural(int $count = 2)
Получить множественное число английского слова. | |
| Строка | pluralStudly(int $count = 2)
Привести последнее слово английского слова в стиле studly caps в множественное число. | |
| Строка | prepend(array ...$values)
Добавить перечисленные значения в начало строки. | |
| Строка | remove(string|string[] $search, bool $caseSensitive = true)
Удалить все вхождения заданной строки в исходную строку. | |
| Строка | reverse()
Перевернуть строку. | |
| Строка | repeat(int $times)
Повторить строку. | |
| Строка | replace(string|string[] $search, string|string[] $replace)
Заменить заданное значение в заданной строке. | |
| Строка | replaceArray(string $search, array $replace)
Последовательно заменить заданное значение в строке массивом. | |
| Строка | replaceFirst(string $search, string $replace)
Заменить первое вхождение заданного значения в строке. | |
| Строка | replaceLast(string $search, string $replace)
Заменить последнее вхождение заданного значения в строке. | |
| Строка | replaceMatches(string $pattern, Closure|string $replace, int $limit = -1)
Заменить совпадения, соответствующие заданному регулярному выражению. | |
| Коллекция | scan(string $format)
Разбирать входные данные из строки в коллекцию в соответствии с форматом. | |
| Строка | start(string $prefix)
Начать строку с одного вхождения заданного значения. | |
| Строка | stripTags(string $allowedTags = null)
Удалить HTML и PHP теги из заданной строки. | |
| Строка | upper()
Преобразовать заданную строку в верхний регистр. | |
| Строка | title()
Преобразовать заданную строку в заголовок. | |
| Строка | headline()
Преобразовать заданную строку в заголовок для каждого слова. | |
| Строка | singular()
Получить единственное число английского слова. | |
| Строка | slug(string $separator = '-', string|null $language = 'en')
Сгенерировать понятный для URL "slug" из заданной строки. | |
| Строка | snake(string $delimiter = '_')
Преобразовать строку в змеиный регистр. | |
| bool | startsWith(string|array $needles)
Определить, начинается ли заданная строка с заданной подстроки. | |
| Строка | studly()
Преобразовать значение в регистр studly caps. | |
| Строка | substr(int $start, int|null $length = null)
Возвращает часть строки, указанную параметрами start и length. | |
| int | substrCount(string $needle, int|null $offset = null, int|null $length = null)
Возвращает количество вхождений подстроки. | |
| Строка | substrReplace(string|array $replace, array|int $offset = 0, array|int|null $length = null)
Заменить текст в части строки. | |
| Строка | swap(array $map)
Поменять местами несколько ключевых слов в строке на другие ключевые слова. | |
| Строка | trim(string $characters = null)
Удалить заданные символы с начала и конца строки. | |
| Строка | ltrim(string $characters = null)
Удалить заданные символы с начала строки. | |
| Строка | rtrim(string $characters = null)
Удалить заданные символы с конца строки. | |
| Строка | ucfirst()
Сделать первый символ строки заглавным. | |
| Коллекция | ucsplit()
Разделить строку по заглавным буквам. | |
| Строка | whenContains(string|array $needles, callable $callback, callable|null $default = null)
Выполнить переданный обратный вызов, если строка содержит заданную подстроку. |
| Stringable | whenContainsAll(array $needles, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка содержит все значения массива. | |
| Stringable | whenEmpty(callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка пустая. | |
| Stringable | whenNotEmpty(callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка не пустая. | |
| Stringable | whenEndsWith(string|array $needles, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка оканчивается заданной подстрокой. | |
| Stringable | whenExactly(string $value, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка точно соответствует заданному значению. | |
| Stringable | whenIs(string|array $pattern, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка соответствует заданному шаблону. | |
| Stringable | whenIsAscii(callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка представляет собой 7-битный ASCII. | |
| Stringable | whenIsUuid(callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка является допустимым UUID. | |
| Stringable | whenStartsWith(string|array $needles, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка начинается с заданной подстроки. | |
| Stringable | whenTest(string $pattern, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка соответствует заданному шаблону. | |
| Stringable | words(int $words = 100, string $end = '...')
Ограничить количество слов в строке. | |
| int | wordCount()
Получить количество слов в строке. | |
| HtmlString | toHtmlString()
Преобразовать строку в | |
| $this | dump()
Вывести строку. | |
| never | dd()
Вывести строку и завершить выполнение скрипта. | |
| string | jsonSerialize()
Преобразовать объект в строку при кодировании в JSON. | |
| mixed | __get(string $key)
Проксировать динамические свойства на методы. | |
| string | __toString()
Получить исходное значение строки. |
Подробности
$this|mixed when(mixed $value, callable $callback, callable|null $default = null)
Применить обратный вызов, если заданное "значение" истинно.
$this|mixed unless(mixed $value, callable $callback, callable|null $default = null)
Применить обратный вызов, если заданное "значение" ложно.
static void macro(string $name, object|callable $macro)
Зарегистрировать пользовательское макро.
static void mixin(object $mixin, bool $replace = true)
Добавить другой объект в класс.
static bool hasMacro(string $name)
Проверяет, зарегистрировано ли макро.
static void flushMacros()
Очистить существующие макросы.
static mixed __callStatic(string $method, array $parameters)
Динамически обрабатывать вызовы класса.
mixed __call(string $method, array $parameters)
Динамически обрабатывать вызовы класса.
$this|HigherOrderTapProxy tap(callable|null $callback = null)
Вызвать заданный замыкание с этим экземпляром, а затем вернуть экземпляр.
void __construct(string $value = '')
Создать новый экземпляр класса.
Stringable after(string $search)
Возвращает остаток строки после первого вхождения заданного значения.
Stringable afterLast(string $search)
Возвращает остаток строки после последнего вхождения заданного значения.
Stringable append(array ...$values)
Добавляет заданные значения к строке.
Stringable ascii(string $language = 'en')
Транслитерирует значение UTF-8 в ASCII.
Stringable basename(string $suffix = '')
Получить имя файла (компонент пути).
Stringable classBasename()
Получить имя класса из пути.
Stringable before(string $search)
Получить часть строки перед первым вхождением заданного значения.
Stringable beforeLast(string $search)
Получить часть строки перед последним вхождением заданного значения.
Stringable between(string $from, string $to)
Получить часть строки между двумя заданными значениями.
Stringable camel()
Преобразовать значение в верблюжье регистр.
bool contains(string|array $needles)
Определить, содержит ли данная строка заданную подстроку.
bool containsAll(array $needles)
Определить, содержит ли данная строка все значения массива.
Stringable dirname(int $levels = 1)
Получить путь родительского каталога.
bool endsWith(string|array $needles)
Определить, заканчивается ли данная строка заданной подстрокой.
bool exactly(string $value)
Определить, является ли строка точным совпадением с заданным значением.
Collection explode(string $delimiter, int $limit = PHP_INT_MAX)
Разбить строку на массив.
Collection split(string|int $pattern, int $limit = -1, int $flags = 0)
Разделить строку с помощью регулярного выражения или по длине.
Stringable finish(string $cap)
Завершить строку одним экземпляром заданного значения.
bool is(string|array $pattern)
Определить, соответствует ли данная строка заданному шаблону.
bool isAscii()
Определить, является ли данная строка 7-битной ASCII.
bool isUuid()
Определить, является ли заданная строка корректным UUID.
bool isEmpty()
Определить, является ли заданная строка пустой.
bool isNotEmpty()
Определить, является ли заданная строка непустой.
Stringable kebab()
Преобразовать строку в кебаб-регистр.
int length(string $encoding = null)
Возвратить длину заданной строки.
Stringable limit(int $limit = 100, string $end = '...')
Ограничить количество символов в строке.
Stringable lower()
Преобразовать заданную строку в нижний регистр.
Stringable markdown(array $options = [])
Преобразовать Markdown в HTML, используя форматирование GitHub.
Stringable mask(string $character, int $index, int|null $length = null, string $encoding = 'UTF-8')
Маскировать часть строки повторением заданного символа.
Stringable match(string $pattern)
Получить часть строки, соответствующую заданному шаблону.
Collection matchAll(string $pattern)
Получить все совпадения строки с заданным шаблоном.
bool test(string $pattern)
Определить, соответствует ли строка заданному шаблону.
Stringable padBoth(int $length, string $pad = ' ')
Дополнить строку с обеих сторон.
Stringable padLeft(int $length, string $pad = ' ')
Дополнить строку слева.
Stringable padRight(int $length, string $pad = ' ')
Дополнить строку справа.
array parseCallback(string|null $default = null)
Разбить callback в формате Class@method на класс и метод.
Stringable pipe(callable $callback)
Вызвать заданный callback и вернуть новую строку.
Stringable plural(int $count = 2)
Получить форму множественного числа английского слова.
Stringable pluralStudly(int $count = 2)
Склонить последнее слово английской строки в стиле studly caps к форме множественного числа.
Stringable prepend(array ...$values)
Добавить заданные значения в начало строки.
Stringable remove(string|string[] $search, bool $caseSensitive = true)
Удалить все вхождения заданной строки в строку-предмет.
Stringable reverse()
Перевернуть строку.
Stringable repeat(int $times)
Повторить строку.
Stringable replace(string|string[] $search, string|string[] $replace)
Заменить заданное значение в заданной строке.
Stringable replaceArray(string $search, array $replace)
Последовательно заменить заданное значение в строке массивом.
Stringable replaceFirst(string $search, string $replace)
Заменить первое вхождение заданного значения в строке.
Stringable replaceLast(string $search, string $replace)
Заменить последнее вхождение заданного значения в строке.
Stringable replaceMatches(string $pattern, Closure|string $replace, int $limit = -1)
Заменить шаблоны, соответствующие заданному регулярному выражению.
Collection scan(string $format)
Проанализировать входные данные из строки в коллекцию в соответствии с форматом.
Stringable start(string $prefix)
Начать строку с одного вхождения заданного значения.
Stringable stripTags(string $allowedTags = null)
Удалить HTML и PHP теги из данной строки.
Stringable upper()
Преобразовать заданную строку в верхний регистр.
Stringable title()
Преобразовать заданную строку в заголовок.
Stringable headline()
Преобразовать заданную строку в заголовок каждого слова.
Stringable singular()
Получить единственное число английского слова.
Stringable slug(string $separator = '-', string|null $language = 'en')
Сгенерировать URL-дружественный «slug» из заданной строки.
Stringable snake(string $delimiter = '_')
Преобразовать строку в змеиный регистр.
bool startsWith(string|array $needles)
Определить, начинается ли заданная строка с заданной подстроки.
Stringable studly()
Преобразовать значение в регистр Studly Caps.
Stringable substr(int $start, int|null $length = null)
Возвращает часть строки, указанную параметрами start и length.
int substrCount(string $needle, int|null $offset = null, int|null $length = null)
Возвращает количество вхождений подстроки.
Stringable substrReplace(string|array $replace, array|int $offset = 0, array|int|null $length = null)
Заменяет текст в части строки.
Stringable swap(array $map)
Меняет местами несколько ключевых слов в строке на другие.
Stringable trim(string $characters = null)
Удалить символы с начала и конца строки.
Stringable ltrim(string $characters = null)
Удалить символы слева (с начала) строки.
Stringable rtrim(string $characters = null)
Удалить символы справа (с конца) строки.
Stringable ucfirst()
Первая буква строки в верхнем регистре.
Collection ucsplit()
Разделить строку по заглавным буквам.
Stringable whenContains(string|array $needles, callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка содержит заданную подстроку.
Stringable whenContainsAll(array $needles, callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка содержит все значения из массива.
Stringable whenEmpty(callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка пустая.
Stringable whenNotEmpty(callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка не пустая.
Stringable whenEndsWith(string|array $needles, callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка заканчивается заданной подстрокой.
Stringable whenExactly(string $value, callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка точно соответствует заданному значению.
Stringable whenIs(string|array $pattern, callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка соответствует заданному шаблону.
Stringable whenIsAscii(callable $callback, callable|null $default = null)
Выполнить заданный callback, если строка является 7-битной ASCII.
Stringable whenIsUuid(callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка является допустимым UUID.
Stringable whenStartsWith(string|array $needles, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка начинается с заданной подстроки.
Stringable whenTest(string $pattern, callable $callback, callable|null $default = null)
Выполнить заданный обратный вызов, если строка соответствует заданному шаблону.
Stringable words(int $words = 100, string $end = '...')
Ограничить количество слов в строке.
int wordCount()
Получить количество слов в строке.
HtmlString toHtmlString()
Преобразовать строку в экземпляр HtmlString.
$this dump()
Вывести строку.
never dd()
Вывести строку и завершить сценарий.
string jsonSerialize()
Преобразовать объект в строку при кодировании JSON.
mixed __get(string $key)
Перенаправить динамические свойства на методы.
string __toString()
Получить исходное значение строки.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/8.x/Illuminate/Support/Stringable.html
