Str
class Str (View source)
Свойства
| Macroable |
Свойства
| static protected array | $macros | Зарегистрированные макросы строк. | from Macroable |
| static protected array | $snakeCache | Кэш змеиного регистра. | |
| static protected array | $camelCache | Кэш верблюжьего регистра. | |
| static protected array | $studlyCache | Кэш верблюжьего регистра. | |
| static protected callable|null | $uuidFactory | Обратный вызов для генерации UUID. | |
| static protected callable|null | $ulidFactory | Обратный вызов для генерации ULID. | |
| static protected callable|null | $randomStringFactory | Обратный вызов для генерации случайных строк. |
Методы
| static void | macro(string $name, object|callable $macro)
Зарегистрировать пользовательское макро. | from Macroable |
| static void | mixin(object $mixin, bool $replace = true)
Смешать другой объект в класс. | from Macroable |
| static bool | hasMacro(string $name)
Проверяет, зарегистрировано ли макро. | from Macroable |
| static void | flushMacros()
Очистить существующие макросы. | from Macroable |
| static mixed | __callStatic(string $method, array $parameters)
Динамически обработать вызовы класса. | from Macroable |
| mixed | __call(string $method, array $parameters)
Динамически обработать вызовы класса. | from Macroable |
| static Stringable | of(string $string)
Получить новый строковый объект из заданной строки. | |
| 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 string|false | charAt(string $subject, int $index)
Получить символ по указанному индексу. | |
| static bool | contains(string $haystack, string|iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка заданную подстроку. | |
| static bool | containsAll(string $haystack, iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка все значения массива. | |
| static string | convertCase(string $string, int $mode = MB_CASE_FOLD, string|null $encoding = 'UTF-8')
Преобразовать регистр строки. | |
| 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 string | unwrap(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(mixed $value)
Определить, является ли заданное значение корректным JSON. | |
| static bool | isUrl(mixed $value, array $protocols = [])
Определить, является ли заданное значение корректным URL. | |
| static bool | isUuid(mixed $value)
Определить, является ли заданное значение корректным UUID. | |
| static bool | isUlid(mixed $value)
Определить, является ли заданное значение корректным ULID. | |
| static string | kebab(string $value)
Преобразовать строку в кебаб-кейс. | |
| 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 в HTML в стиле GitHub. | |
| static string | inlineMarkdown(string $string, array $options = [])
Преобразует inline 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 bool | isMatch(string|iterable<string> $pattern, string $value)
Определить, соответствует ли заданная строка заданному шаблону. | |
| 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 | password(int $length = 32, bool $letters = true, bool $numbers = true, bool $symbols = true, bool $spaces = false)
Сгенерировать случайный, защищенный пароль. | |
| static int|false | position(string $haystack, string $needle, int $offset = 0, string|null $encoding = null)
Найти позицию первого вхождения подстроки в строке, учитывая многобайтовую кодировку. | |
| 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|string[] | replace(string|iterable<string> $search, string|iterable<string> $replace, string|iterable<string> $subject, bool $caseSensitive = true)
Заменить заданное значение в заданной строке. | |
| static string | replaceFirst(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения в строке. | |
| static string | replaceStart(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения, если оно находится в начале строки. | |
| static string | replaceLast(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения в строке. | |
| static string | replaceEnd(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения, если оно находится в конце строки. | |
| static string|string[]|null | replaceMatches(array|string $pattern, Closure|string $replace, array|string $subject, int $limit = -1)
Заменить совпадения, соответствующие заданному регулярному выражению. | |
| static string | remove(string|iterable<string> $search, string|iterable<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 | apa(string $value)
Преобразовать заданную строку в заголовок в стиле APA. | |
| 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 = '_')
Преобразовать строку в змеиный регистр (snake case). | |
| 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 | take(string $string, int $limit)
Взять первые или последние {limit} символов строки. | |
| static string | toBase64(string $string)
Преобразовать заданную строку в Base64-кодировку. | |
| static string|false | fromBase64(string $string, bool $strict = false)
Декодировать заданную Base64-кодированную строку. | |
| 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 string | wordWrap(string $string, int $characters = 75, string $break = "\n", bool $cutLongWords = false)
Переносить строку на новую строку через заданное количество символов. | |
| static UuidInterface | uuid()
Сгенерировать UUID (версия 4). | |
| static UuidInterface | orderedUuid()
Сгенерировать UUID с отслеживанием времени. | |
| 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(DateTimeInterface|null $time = null)
Сгенерировать ULID. | |
| static void | createUlidsNormally()
Указать, что ULID должны генерироваться стандартным способом, а не с помощью пользовательского объекта. | |
| static void | createUlidsUsing(callable $factory = null)
Установить вызываемый объект для генерации ULID. | |
| static void | createUlidsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность для генерации ULID. | |
| static Ulid | freezeUlids(Closure $callback = null)
Всегда возвращать один и тот же ULID при генерации новых ULID. | |
| static void | flushCache()
Очистить все строки из кэша форматирования. |
Подробности
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 string|false charAt(string $subject, int $index)
Получить символ по указанному индексу.
static bool contains(string $haystack, string|iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка заданную подстроку.
static bool containsAll(string $haystack, iterable<string> $needles, bool $ignoreCase = false)
Определить, содержит ли заданная строка все значения массива.
static string convertCase(string $string, int $mode = MB_CASE_FOLD, string|null $encoding = 'UTF-8')
Преобразовать регистр символов в строке.
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 string unwrap(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(mixed $value)
Определить, является ли заданное значение допустимым JSON.
static bool isUrl(mixed $value, array $protocols = [])
Определить, является ли заданное значение допустимым URL.
static bool isUuid(mixed $value)
Определить, является ли заданное значение допустимым UUID.
static bool isUlid(mixed $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 = [])
Преобразует inline 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 bool isMatch(string|iterable<string> $pattern, string $value)
Определить, соответствует ли заданная строка заданному шаблону.
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 password(int $length = 32, bool $letters = true, bool $numbers = true, bool $symbols = true, bool $spaces = false)
Генерирует случайный, безопасный пароль.
static int|false position(string $haystack, string $needle, int $offset = 0, string|null $encoding = null)
Найти позицию первого вхождения подстроки в строке с учетом многобайтовых символов.
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|string[] replace(string|iterable<string> $search, string|iterable<string> $replace, string|iterable<string> $subject, bool $caseSensitive = true)
Заменить заданное значение в данной строке.
static string replaceFirst(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения в строке.
static string replaceStart(string $search, string $replace, string $subject)
Заменить первое вхождение заданного значения, если оно находится в начале строки.
static string replaceLast(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения в строке.
static string replaceEnd(string $search, string $replace, string $subject)
Заменить последнее вхождение заданного значения, если оно находится в конце строки.
static string|string[]|null replaceMatches(array|string $pattern, Closure|string $replace, array|string $subject, int $limit = -1)
Заменить шаблоны, соответствующие заданному регулярному выражению.
static string remove(string|iterable<string> $search, string|iterable<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 apa(string $value)
Преобразовать заданную строку в заглавные буквы по стилю APA.
См.: https://apastyle.apa.org/style-grammar-guidelines/capitalization/title-case
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 take(string $string, int $limit)
Взять первые или последние {$limit} символов строки.
static string toBase64(string $string)
Преобразовать заданную строку в кодировку Base64.
static string|false fromBase64(string $string, bool $strict = false)
Декодировать заданную строку, закодированную в Base64.
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 string wordWrap(string $string, int $characters = 75, string $break = "\n", bool $cutLongWords = false)
Переносить строку на заданное количество символов.
static UuidInterface uuid()
Генерировать UUID (версия 4).
static UuidInterface orderedUuid()
Генерировать UUID с отслеживанием времени.
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(DateTimeInterface|null $time = null)
Генерировать ULID.
static void createUlidsNormally()
Указать, что ULID должны создаваться стандартным образом, а не с помощью пользовательского фабричного метода.
static void createUlidsUsing(callable $factory = null)
Установить вызываемый объект, который будет использоваться для генерации ULID.
static void createUlidsUsingSequence(array $sequence, callable|null $whenMissing = null)
Установить последовательность, которая будет использоваться для генерации ULID.
static Ulid freezeUlids(Closure $callback = null)
Всегда возвращать тот же ULID при генерации новых ULID.
static void flushCache()
Удалить все строки из кэшей преобразования.
© Taylor Otwell
Licensed under the MIT License.
Laravel is a trademark of Taylor Otwell.
https://laravel.com/api/10.x/Illuminate/Support/Str.html