Перейти к основному содержанию
Общие функции для работы со строками и функции поиска в строках описаны отдельно.
Приведённая ниже документация сгенерирована из системной таблицы system.functions.

format

Добавленный в: v20.1.0 Форматирует строку pattern значениями (строками, целыми числами и т. д.), перечисленными в аргументах, аналогично форматированию в Python. Строка шаблона может содержать поля подстановки, заключённые в фигурные скобки {}. Всё, что не заключено в скобки, считается буквальным текстом и копируется в выходную строку без изменений. Буквальные символы фигурных скобок можно экранировать двойными скобками: {{ и }}. Именами полей могут быть числа (начиная с нуля) или пустые значения (в этом случае им неявно присваиваются последовательно возрастающие номера). Синтаксис
Аргументы
  • pattern — Строка форматирования, содержащая плейсхолдеры. String
  • s0[, s1, ...] — Одно или несколько значений для подстановки в шаблон. Any
Возвращаемое значение Возвращает отформатированную строку. String Примеры Нумерованные плейсхолдеры
Query
Response
Неявная нумерация
Query
Response

overlay

Добавленный в: v24.9.0 Заменяет часть строки input на другую строку replace, начиная с индекса offset (нумерация с 1). Синтаксис
Аргументы
  • s — Входная строка. String
  • replace — Строка замены. const String
  • offset — Целочисленный тип Int (нумерация с 1). Если offset отрицательный, отсчёт ведётся от конца строки s. Int
  • length — Необязательно. Целочисленный тип Int. length задаёт длину фрагмента во входной строке s, который нужно заменить. Если length не указана, количество байтов, удаляемых из s, равно длине replace; в противном случае удаляется length байтов. Int
Возвращаемое значение Возвращает строку с выполненной заменой. String Примеры Простая замена
Query
Response
Замена с указанием длины
Query
Response

overlayUTF8

Добавленный в: v24.9.0 Заменяет часть строки s на другую строку replace, начиная с индекса offset, отсчитываемого от 1. Предполагается, что строка содержит корректный текст в кодировке UTF-8. Если это предположение нарушено, исключение не генерируется, а результат не определён. Синтаксис
Аргументы
  • s — Входная строка. String
  • replace — Строка замены. const String
  • offset — Целочисленный тип Int (нумерация начинается с 1). Если offset отрицательный, отсчёт ведётся от конца входной строки s. (U)Int*
  • length — Необязательный параметр. Задаёт длину фрагмента входной строки s, который нужно заменить. Если length не указан, количество символов, удаляемых из s, равно длине replace; в противном случае удаляется length символов. (U)Int*
Возвращаемое значение Возвращает строку с заменённым фрагментом. String Примеры Замена UTF-8
Query
Response

printf

Добавленный в: v24.8.0 Функция printf форматирует заданную строку значениями (строками, целыми числами, числами с плавающей точкой и т. д.), перечисленными в аргументах, аналогично функции printf в C++. Строка формата может содержать спецификаторы формата, начинающиеся с символа %. Всё, что не является % и следующим за ним спецификатором формата, считается литеральным текстом и копируется в результат как есть. Литеральный символ % можно экранировать с помощью %%. Строка формата может быть как константой, так и выражением столбца, что позволяет использовать разные шаблоны формата для каждой строки. Синтаксис
Аргументы
  • format — Строка формата со спецификаторами %. String
  • sub1, sub2, ... — Необязательный параметр. Одно или несколько значений для подстановки в строку формата. Any
Возвращаемое значение Возвращает отформатированную строку. String Примеры Форматирование в стиле C++
Query
Response

regexpQuoteMeta

Добавленный в: v20.1.0 Добавляет обратную косую черту перед следующими символами, имеющими специальное значение в регулярных выражениях: \0, \\, |, (, ), ^, $, ., [, ], ?, *, +, {, :, -. Эта реализация немного отличается от re2::RE2::QuoteMeta. Нулевой байт экранируется как \0 вместо \x00, при этом экранируются только необходимые символы. Синтаксис
Аргументы
  • s — Входная строка, содержащая символы, которые нужно экранировать в регулярном выражении. String
Возвращаемое значение Возвращает строку, в которой экранированы специальные символы регулярного выражения. String Примеры Экранирование специальных символов регулярного выражения
Query
Response

replaceAll

Добавленный в: v1.1.0 Заменяет все вхождения шаблона регулярного выражения pattern в строке haystack на строку replacement. Синтаксис
Псевдонимы: replace Аргументы
  • haystack — Входная строка, в которой выполняется поиск. String
  • pattern — Шаблон регулярного выражения, который нужно найти и заменить. const String
  • replacement — Строка, которой заменяется найденная подстрока. const String
Возвращаемое значение Возвращает строку, в которой заменены все вхождения шаблона регулярного выражения. String Примеры Заменить все вхождения
Query
Response

replaceOne

Добавленный в: v1.1.0 Заменяет первое вхождение подстроки pattern в строке haystack на строку replacement. Синтаксис
Аргументы
  • haystack — Входная строка, в которой выполняется поиск. String
  • pattern — Шаблон регулярного выражения, который нужно найти и заменить. const String
  • replacement — Строка, на которую заменяется найденный фрагмент. const String
Возвращаемое значение Возвращает строку, в которой заменено первое совпадение с шаблоном регулярного выражения. String Примеры Замена первого вхождения
Query
Response

replaceRegexpAll

Добавленный в: v1.1.0 Как и replaceRegexpOne, но заменяет все вхождения шаблона регулярного выражения. В качестве исключения: если регулярное выражение сработало на пустой подстроке, замена выполняется не более одного раза. Синтаксис
Псевдонимы: REGEXP_REPLACE Аргументы
  • haystack — Входная строка, в которой выполняется поиск. String
  • pattern — Шаблон регулярного выражения, который нужно найти. const String
  • replacement — Строка, которой заменяется шаблон регулярного выражения; может содержать подстановки. const String
Возвращаемое значение Возвращает строку, в которой заменены все совпадения с регулярным выражением. String Примеры Заменить все символы на удвоенные
Query
Response
Пример замены пустой подстроки
Query
Response

replaceRegexpOne

Добавленный в: v1.1.0 Заменяет первое вхождение подстроки в haystack, соответствующее шаблону регулярного выражения pattern (в синтаксисе re2), на строку replacement. replacement может содержать подстановки \0-\9. Подстановки \1-\9 соответствуют 1-й–9-й захватывающим группам (подсовпадениям), а подстановка \0 — всему совпадению. Чтобы использовать буквальный символ \ в строках pattern или replacement, экранируйте его с помощью \. Также имейте в виду, что строковые литералы требуют дополнительного экранирования. Синтаксис
Аргументы
  • haystack — Входная строка для поиска. String
  • pattern — Шаблон регулярного выражения для поиска. const String
  • replacement — Строка, на которую заменяется найденное совпадение; может содержать подстановки. const String
Возвращаемое значение Возвращает строку, в которой заменено первое совпадение по регулярному выражению. String Примеры Преобразование дат ISO в американский формат
Query
Response
Копирование строки десять раз
Query
Response

translate

Добавленный в: v22.7.0 Заменяет символы в строке s на основе посимвольного соответствия, заданного строками from и to. from и to должны быть константными ASCII-строками. Если from и to имеют одинаковую длину, каждое вхождение первого символа из from в s заменяется первым символом из to, каждого второго символа из from — вторым символом из to и так далее. Если from содержит больше символов, чем to, все вхождения символов в конце from, для которых нет соответствующего символа в to, удаляются из s. Символы не из ASCII в s функцией не изменяются. Синтаксис
Аргументы
  • s — Входная строка для преобразования. String
  • from — Константная строка ASCII, содержащая символы для замены. const String
  • to — Константная строка ASCII, содержащая символы-замены. const String
Возвращаемое значение Возвращает строку с заменёнными символами. String Примеры Сопоставление символов
Query
Response
Различная длина
Query
Response

translateUTF8

Добавленный в: v22.7.0 Как translate, но предполагается, что s, from и to — строки в кодировке UTF-8. Синтаксис
Аргументы
  • s — входная UTF-8-строка для преобразования. String
  • from — константная UTF-8-строка, содержащая символы для замены. const String
  • to — константная UTF-8-строка, содержащая символы, на которые выполняется замена. const String
Возвращаемое значение Возвращает значение типа данных String. String Примеры Преобразование символов UTF-8
Query
Response
Последнее изменение 25 июня 2026 г.