String

Функции для работы с ASCII-строками.

Список функций

• String::Base64Encode(string:String{Flags:AutoMap}) -> String

• String::Base64Decode(string:String) -> String?

• String::Base64StrictDecode(string:String) -> String?

• String::EscapeC(string:String{Flags:AutoMap}) -> String

• String::UnescapeC(string:String{Flags:AutoMap}) -> String

• String::HexEncode(string:String{Flags:AutoMap}) -> String

• String::HexDecode(string:String) -> String?

• String::EncodeHtml(string:String{Flags:AutoMap}) -> String

• String::DecodeHtml(string:String{Flags:AutoMap}) -> String

• String::CgiEscape(string:String{Flags:AutoMap}) -> String

• String::CgiUnescape(string:String{Flags:AutoMap}) -> String

  Кодирует или декодирует строку указанным образом.

Пример

SELECT String::Base64Encode("YQL"); -- "WVFM"

• String::Strip(string:String{Flags:AutoMap}) -> String

  Вырезает из строки крайние пробелы.

Пример

SELECT String::Strip("YQL ");       -- "YQL"

• String::Collapse(string:String{Flags:AutoMap}) -> String

  Заменяет множественные пробелы внутри строки одиночными.

• String::CollapseText(string:String{Flags:AutoMap}, limit:Uint64) -> String

  Укорачивает текст до указанного размера с добавлением троеточия.

• String::Contains(string:String?, substring:String) -> Bool

  Проверяет наличие подстроки в строке.

• String::Reverse(string:String?) -> String? - Устаревшая: используйте Unicode::Reverse

  Устаревшие функции, к использованию не рекомендуются.

• String::HasPrefixIgnoreCase(string:String?, prefix:String) -> Bool

• String::StartsWithIgnoreCase(string:String?, prefix:String) -> Bool

• String::HasSuffixIgnoreCase(string:String?, suffix:String) -> Bool

• String::EndsWithIgnoreCase(string:String?, suffix:String) -> Bool

  Проверяют наличие префикса или суффикса в строке без учёта региста символов.

• String::AsciiToLower(string:String{Flags:AutoMap}) -> String - меняет только латинские символы. Для работы с другими алфавитами смотрите Unicode::ToLower

• String::AsciiToUpper(string:String{Flags:AutoMap}) -> String - меняет только латинские символы. Для работы с другими алфавитами смотрите Unicode::ToUpper

• String::AsciiToTitle(string:String{Flags:AutoMap}) -> String - меняет только латинские символы. Для работы с другими алфавитами смотрите Unicode::ToTitle

  Переводят регистр ascii символов строки к ВЕРХНЕМУ, нижнему или Заглавному виду.

• String::SplitToList(string:String?, delimeter:String, [ DelimeterString:Bool?, SkipEmpty:Bool?, Limit:Uint64? ]) -> List<String>

  Разбивает строку на подстроки по разделителю.
  string -- исходная строка
  delimeter -- разделитель
  Именованные параметры:

  • DelimeterString:Bool? — считать разделитель строкой (true, по умолчанию) или набором символов "любой из" (false)
  • SkipEmpty:Bool? - пропускать ли пустые строки в результате, по умолчанию false
  • Limit:Uint64? - ограничение на число извлекаемых компонент, по умолчанию не ограничено; необработанный суффикс оригинальной строки возвращается последним элементом при превышении лимита

Пример

SELECT String::SplitToList("1,2,3,4,5,6,7", ",", 3 as Limit); -- ["1", "2", "3", "4,5,6,7"]

• String::JoinFromList(strings:List<String>{Flags:AutoMap}, separator:String) -> String

  Конкатенирует список строк через разделитель в единую строку.

• String::ToByteList(string:String) -> List<Byte>

  Разбивает строку на список байт.

• String::FromByteList(bytes:List<Uint8>) -> String

  Собирает список байт в строку.

• String::ReplaceAll(input:String{Flags:AutoMap}, find:String, replacement:String) -> String

• String::ReplaceFirst(input:String{Flags:AutoMap}, find:String, replacement:String) -> String

• String::ReplaceLast(input:String{Flags:AutoMap}, find:String, replacement:String) -> String

  Заменяют все/первое/последнее вхождения(е) строки find в input на replacement.

• String::RemoveAll(input:String{Flags:AutoMap}, symbols:String) -> String

• String::RemoveFirst(input:String{Flags:AutoMap}, symbols:String) -> String

• String::RemoveLast(input:String{Flags:AutoMap}, symbols:String) -> String

  Удаляют все/первое/последнее вхождения(е) символа в наборе symbols из input. Второй аргумент интерпретируется как неупорядоченный набор символов для удаления.

• String::IsAscii(string:String{Flags:AutoMap}) -> Bool

  Проверяет, является ли строка валидной ascii последовательностью.

• String::IsAsciiSpace(string:String{Flags:AutoMap}) -> Bool

• String::IsAsciiUpper(string:String{Flags:AutoMap}) -> Bool

• String::IsAsciiLower(string:String{Flags:AutoMap}) -> Bool

• String::IsAsciiAlpha(string:String{Flags:AutoMap}) -> Bool

• String::IsAsciiAlnum(string:String{Flags:AutoMap}) -> Bool

• String::IsAsciiHex(string:String{Flags:AutoMap}) -> Bool

  Проверяют, отвечает ли ascii строка указанному условию.

• String::LevensteinDistance(stringOne:String{Flags:AutoMap}, stringTwo:String{Flags:AutoMap}) -> Uint64

  Вычисляет расстояние Левенштейна для переданных строк.

• String::LeftPad(string:String{Flags:AutoMap}, size:Uint64, filler:[String?]) -> String

• String::RightPad(string:String{Flags:AutoMap}, size:Uint64, filler:[String?]) -> String

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

• String::Hex(value:Uint64{Flags:AutoMap}) -> String

• String::SHex(value:Int64{Flags:AutoMap}) -> String

• String::Bin(value:Uint64{Flags:AutoMap}) -> String

• String::SBin(value:Int64{Flags:AutoMap}) -> String

• String::HexText(string:String{Flags:AutoMap}) -> String

• String::BinText(string:String{Flags:AutoMap}) -> String

• String::HumanReadableDuration(value:Uint64{Flags:AutoMap}) -> String

• String::HumanReadableQuantity(value:Uint64{Flags:AutoMap}) -> String

• String::HumanReadableBytes(value:Uint64{Flags:AutoMap}) -> String

• String::Prec(Double{Flags:AutoMap}, digits:Uint64) -> String

  Распечатывает значение указанным образом.

Библиотека String разработана на основе util/string/ и TString из Аркадии.