Str
класс Str (Просмотр исходного кода)
Трейты
| Macroable |
Свойства
| статический защищенный массив | $macros | Зарегистрированные макросы строк. | из Macroable |
| статический защищенный массив | $snakeCache | Кэш слов в змеином регистре. | |
| статический защищенный массив | $camelCache | Кэш слов в верблюжьем регистре. | |
| статический защищенный массив | $studlyCache | Кэш слов в верблюжьем регистре с заглавными буквами. | |
| статический защищенный вызов|null | $uuidFactory | Обратный вызов, используемый для генерации UUID. | |
| статический защищенный вызов|null | $randomStringFactory | Обратный вызов, используемый для генерации случайных строк. |
Методы
| 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 |
| static Stringable | of(string $string)
Получить новый объект stringable из заданной строки. | |
| static string | after(string $subject, string $search)
Возвращает остаток строки после первого вхождения заданного значения. | |
| static string | afterLast(string $subject, string $search)
Возвращает остаток строки после последнего вхождения заданного значения. | |
| static string | ascii(string $value, string $language = 'en')
Транслитерировать значение UTF-8 в ASCII. | |
| static string | transliterate(string $string, string|null $unknown = '?', bool|null $strict = false)
Транслитерировать строку в её ближайшее представление ASCII. | |
| static string | before(string $subject, string $search)
Получить часть строки перед первым вхождением заданного значения. | |
| static string | beforeLast(string $subject, string $search)
Получить часть строки перед последним вхождением заданного значения. | |
| static string | between(string $subject, string $from, string $to)
Получить часть строки между двумя заданными значениями. | |
| static string | betweenFirst(string $subject, string $from, string $to)
Получить наименьшую возможную часть строки между двумя заданными значениями. | |
| static string | camel(string $value)
Преобразовать значение в верблюжье регистр. | |
| static bool | contains(string $haystack, string|iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка заданную подстроку. | |
| static bool | containsAll(string $haystack, iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка все значения массива. | |
| static bool | endsWith(string $haystack, string|iterable<string> $needles)
Определить, заканчивается ли заданная строка заданной подстрокой. | |
| static string|null | excerpt(string $text, string $phrase = '', array $options = [])
Извлекает выдержку из текста, соответствующую первому экземпляру фразы. | |
| static string | finish(string $value, string $cap)
Добавить к строке однократное вхождение заданного значения. | |
| static string | wrap(string $value, string $before, string|null $after = null)
Оборачивает строку заданными строками. | |
| static bool | is(string|iterable<string> $pattern, string $value)
Определить, соответствует ли заданная строка заданному шаблону. | |
| static bool | isAscii(string $value)
Определить, является ли заданная строка 7-битной ASCII. | |
| static bool | isJson(string $value)
Определить, является ли заданная строка валидным JSON. | |
| static bool | isUuid(string $value)
Определить, является ли заданная строка валидным UUID. | |
| static bool | isUlid(string $value)
Определить, является ли заданная строка валидным ULID. | |
| static string | kebab(string $value)
Преобразовать строку в регистр kebab. | |
| static int | length(string $value, string|null $encoding = null)
Возвращает длину заданной строки. | |
| static string | limit(string $value, int $limit = 100, string $end = '...')
Ограничить количество символов в строке. | |
| static string | lower(string $value)
Преобразовать заданную строку в нижний регистр. | |
| static string | words(string $value, int $words = 100, string $end = '...')
Ограничить количество слов в строке. | |
| static string | markdown(string $string, array $options = [])
Преобразует Markdown в формате GitHub в HTML. | |
| static string | inlineMarkdown(string $string, array $options = [])
Преобразует встроенный Markdown в HTML. | |
| static string | mask(string $string, string $character, int $index, int|null $length = null, string $encoding = 'UTF-8')
Маскирует часть строки повторяющимся символом. | |
| static string | match(string $pattern, string $subject)
Получить строку, соответствующую заданному шаблону. | |
| static Collection | matchAll(string $pattern, string $subject)
Получить все совпадения с заданным шаблоном. | |
| static string | padBoth(string $value, int $length, string $pad = ' ')
Добавить пробелы с обеих сторон строки. | |
| static string | padLeft(string $value, int $length, string $pad = ' ')
Добавить пробелы слева к строке. | |
| static string | padRight(string $value, int $length, string $pad = ' ')
Добавить пробелы справа к строке. | |
| static array<int,string|null> | parseCallback(string $callback, string|null $default = null)
Разделить вызов типа Class[@]method на класс и метод. | |
| static string | plural(string $value, int|array|Countable $count = 2)
Получить множественное число английского слова. |
| static string | pluralStudly(string $value, int|array|Countable $count = 2)
Умножить последнее слово английского слова studly caps на число. | |
| static string | random(int $length = 16)
Сгенерировать более истинно «случайную» альфа-цифровую строку. | |
| static void | createRandomStringsUsing(callable $factory = null)
Установить вызываемый объект, который будет использоваться для генерации случайных строк. | |
| static void | createRandomStringsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность, которая будет использоваться для генерации случайных строк. | |
| static void | createRandomStringsNormally()
Указать, что случайные строки должны создаваться стандартным способом, а не с помощью пользовательского объекта. | |
| static string | repeat(string $string, int $times)
Повторить заданную строку. | |
| static string | replaceArray(string $search, iterable<string> $replace, string $subject)
Последовательно заменить заданное значение в строке массивом. | |
| static string | replace(string|iterable<string> $search, string|iterable<string> $replace, string|iterable<string> $subject)
Заменить заданное значение в заданной строке. | |
| static string | replaceFirst(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения в строке. | |
| static string | replaceLast(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения в строке. | |
| static string | remove(string|iterable<string> $search, string $subject, bool $caseSensitive = true)
Удалить все вхождения заданной строки в строку-объект. | |
| static string | reverse(string $value)
Перевернуть заданную строку. | |
| static string | start(string $value, string $prefix)
Начать строку с единственного вхождения заданного значения. | |
| static string | upper(string $value)
Преобразовать заданную строку в верхний регистр. | |
| static string | title(string $value)
Преобразовать заданную строку в заголовок. | |
| static string | headline(string $value)
Преобразовать заданную строку в заголовок каждого слова. | |
| static string | singular(string $value)
Получить единственное число английского слова. | |
| static string | slug(string $title, string $separator = '-', string|null $language = 'en', array<string,string> $dictionary = ['@' => 'at'])
Сгенерировать URL-дружественный «slug» из заданной строки. | |
| static string | snake(string $value, string $delimiter = '_')
Преобразовать строку в змеиный регистр. | |
| static string | squish(string $value)
Удалить все «лишние» пробелы из заданной строки. | |
| static bool | startsWith(string $haystack, string|iterable<string> $needles)
Определить, начинается ли заданная строка с заданной подстроки. | |
| static string | studly(string $value)
Преобразовать значение в регистр studly caps. | |
| static string | substr(string $string, int $start, int|null $length = null, string $encoding = 'UTF-8')
Возвращает часть строки, заданную параметрами начала и длины. | |
| static int | substrCount(string $haystack, string $needle, int $offset = 0, int|null $length = null)
Возвращает количество вхождений подстроки. | |
| static string|string[] | substrReplace(string|string[] $string, string|string[] $replace, int|int[] $offset = 0, int|int[]|null $length = null)
Заменить текст в части строки. | |
| static string | swap(array $map, string $subject)
Поменять местами несколько ключевых слов в строке на другие. | |
| static string | lcfirst(string $string)
Сделать первый символ строки строчной. | |
| static string | ucfirst(string $string)
Сделать первый символ строки заглавной. | |
| static string[] | ucsplit(string $string)
Разбить строку на части по заглавным символам. | |
| static int | wordCount(string $string, string|null $characters = null)
Получить количество слов в строке. | |
| static UuidInterface | uuid()
Сгенерировать UUID (версия 4). | |
| static UuidInterface | orderedUuid()
Сгенерировать UUID с порядком по времени (версия 4). | |
| static void | createUuidsUsing(callable $factory = null)
Установить вызываемый объект, который будет использоваться для генерации UUID. | |
| static void | createUuidsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность, которая будет использоваться для генерации UUID. | |
| static UuidInterface | freezeUuids(Closure $callback = null)
Всегда возвращать тот же UUID при генерации новых UUID. | |
| static void | createUuidsNormally()
Указать, что UUID должны создаваться стандартным способом, а не с помощью пользовательского объекта. | |
| static Ulid | ulid()
Сгенерировать ULID. | |
| static void | flushCache()
Удалить все строки из кэшей регистров. |
Details
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)
Динамически обрабатывает вызовы класса.
static Stringable of(string $string)
Получить новый объект stringable из заданной строки.
static string after(string $subject, string $search)
Возвращает остаток строки после первого вхождения заданного значения.
static string afterLast(string $subject, string $search)
Возвращает остаток строки после последнего вхождения заданного значения.
static string ascii(string $value, string $language = 'en')
Транслитерировать значение UTF-8 в ASCII.
static string transliterate(string $string, string|null $unknown = '?', bool|null $strict = false)
Транслитерировать строку в её ближайшее ASCII представление.
static string before(string $subject, string $search)
Получить часть строки перед первым вхождением заданного значения.
static string beforeLast(string $subject, string $search)
Получить часть строки перед последним вхождением заданного значения.
static string between(string $subject, string $from, string $to)
Получить часть строки между двумя заданными значениями.
static string betweenFirst(string $subject, string $from, string $to)
Получить наименьшую возможную часть строки между двумя заданными значениями.
static string camel(string $value)
Преобразовать значение в верблюжий регистр.
static bool contains(string $haystack, string|iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка заданную подстроку.
static bool containsAll(string $haystack, iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка все значения массива.
static bool endsWith(string $haystack, string|iterable<string> $needles)
Определить, заканчивается ли заданная строка заданной подстрокой.
static string|null excerpt(string $text, string $phrase = '', array $options = [])
Извлекает выдержку из текста, соответствующую первому вхождению фразы.
static string finish(string $value, string $cap)
Заканчивает строку одним вхождением заданного значения.
static string wrap(string $value, string $before, string|null $after = null)
Оборачивает строку заданными строками.
static bool is(string|iterable<string> $pattern, string $value)
Определяет, соответствует ли заданная строка заданному шаблону.
static bool isAscii(string $value)
Определяет, является ли заданная строка 7-битной ASCII.
static bool isJson(string $value)
Определяет, является ли заданная строка валидным JSON.
static bool isUuid(string $value)
Определяет, является ли заданная строка валидным UUID.
static bool isUlid(string $value)
Определяет, является ли заданная строка валидным ULID.
static string kebab(string $value)
Преобразует строку в kebab-кейс.
static int length(string $value, string|null $encoding = null)
Возвращает длину заданной строки.
static string limit(string $value, int $limit = 100, string $end = '...')
Ограничивает количество символов в строке.
static string lower(string $value)
Преобразует заданную строку в нижний регистр.
static string words(string $value, int $words = 100, string $end = '...')
Ограничивает количество слов в строке.
static string markdown(string $string, array $options = [])
Преобразует Markdown в формате GitHub в HTML.
static string inlineMarkdown(string $string, array $options = [])
Преобразует встроенный Markdown в HTML.
static string mask(string $string, string $character, int $index, int|null $length = null, string $encoding = 'UTF-8')
Маскирует часть строки повторяющимся символом.
static string match(string $pattern, string $subject)
Получить строку, соответствующую заданному шаблону.
static Collection matchAll(string $pattern, string $subject)
Получить все строки, соответствующие заданному шаблону.
static string padBoth(string $value, int $length, string $pad = ' ')
Дополнить строку с обеих сторон.
static string padLeft(string $value, int $length, string $pad = ' ')
Дополнить строку слева.
static string padRight(string $value, int $length, string $pad = ' ')
Дополнить строку справа.
static array<int,string|null> parseCallback(string $callback, string|null $default = null)
Разбирает callback-стиля Class[@]method в класс и метод.
static string plural(string $value, int|array|Countable $count = 2)
Получить форму множественного числа английского слова.
static string pluralStudly(string $value, int|array|Countable $count = 2)
Склонить последнее слово английской строки в стиле studly caps к множественному числу.
static string random(int $length = 16)
Генерировать более "истинно" случайную альфа-числовую строку.
static void createRandomStringsUsing(callable $factory = null)
Установить вызываемый объект, который будет использоваться для генерации случайных строк.
static void createRandomStringsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность, которая будет использоваться для генерации случайных строк.
static void createRandomStringsNormally()
Указать, что случайные строки должны создаваться в обычном режиме, а не с использованием пользовательского фабричного метода.
static string repeat(string $string, int $times)
Повторить заданную строку.
static string replaceArray(string $search, iterable<string> $replace, string $subject)
Последовательно заменить заданное значение в строке массивом.
static string replace(string|iterable<string> $search, string|iterable<string> $replace, string|iterable<string> $subject)
Заменить заданное значение в заданной строке.
static string replaceFirst(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения в строке.
static string replaceLast(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения в строке.
static string remove(string|iterable<string> $search, string $subject, bool $caseSensitive = true)
Удалить все вхождения заданной строки в строке-сущности.
static string reverse(string $value)
Перевернуть заданную строку.
static string start(string $value, string $prefix)
Добавить заданное значение в начало строки.
static string upper(string $value)
Преобразовать заданную строку в верхний регистр.
static string title(string $value)
Преобразовать заданную строку в заголовок.
static string headline(string $value)
Преобразовать каждую часть заданной строки в заголовок.
static string singular(string $value)
Получить единственное число английского слова.
static string slug(string $title, string $separator = '-', string|null $language = 'en', array<string,string> $dictionary = ['@' => 'at'])
Сгенерировать URL-дружественный «slug» из заданной строки.
static string snake(string $value, string $delimiter = '_')
Преобразовать строку в змеиный регистр.
static string squish(string $value)
Удалить все лишние пробелы из заданной строки.
static bool startsWith(string $haystack, string|iterable<string> $needles)
Определить, начинается ли заданная строка с заданной подстроки.
static string studly(string $value)
Преобразовать значение в регистр Studly Caps.
static string substr(string $string, int $start, int|null $length = null, string $encoding = 'UTF-8')
Возвращает часть строки, указанную параметрами start и length.
static int substrCount(string $haystack, string $needle, int $offset = 0, int|null $length = null)
Возвращает количество вхождений подстроки.
static string|string[] substrReplace(string|string[] $string, string|string[] $replace, int|int[] $offset = 0, int|int[]|null $length = null)
Замена текста в части строки.
static string swap(array $map, string $subject)
Обмен несколькими ключевыми словами в строке на другие ключевые слова.
static string lcfirst(string $string)
Преобразовать первый символ строки в нижний регистр.
static string ucfirst(string $string)
Преобразовать первый символ строки в верхний регистр.
static string[] ucsplit(string $string)
Разделить строку на части по символам в верхнем регистре.
static int wordCount(string $string, string|null $characters = null)
Получить количество слов в строке.
static UuidInterface uuid()
Сгенерировать UUID (версия 4).
static UuidInterface orderedUuid()
Сгенерировать UUID с упорядоченным по времени (версия 4).
static void createUuidsUsing(callable $factory = null)
Установить вызываемый объект, который будет использоваться для генерации UUID.
static void createUuidsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность, которая будет использоваться для генерации UUID.
static UuidInterface freezeUuids(Closure $callback = null)
Всегда возвращать тот же UUID при генерации новых UUID.
static void createUuidsNormally()
Указать, что UUID должны создаваться стандартным способом, а не с использованием пользовательского фабричного метода.
static Ulid ulid()
Сгенерировать ULID.
static void flushCache()
Удалить все строки из кэшей форматирования.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/9.x/Illuminate/Support/Str.html
