> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentación de las funciones de reemplazo de cadenas

# Funciones de reemplazo de cadenas

Las [funciones generales de cadenas](/es/reference/functions/regular-functions/string-functions) y las [funciones de búsqueda en cadenas](/es/reference/functions/regular-functions/string-search-functions) se describen por separado.

<Note>
  La documentación que figura a continuación se genera a partir de la tabla del sistema `system.functions`.
</Note>

{/*AUTOGENERATED_START*/}

<div id="format">
  ## format
</div>

Introducido en: v20.1.0

Da formato a la cadena `pattern` con los valores (cadenas, enteros, etc.) indicados en los argumentos, de forma similar al formato de Python.
La cadena `pattern` puede contener campos de reemplazo entre llaves `{}`.
Todo lo que no esté entre llaves se considera texto literal y se copia textualmente en la salida.
Los caracteres de llave literales pueden escaparse con llaves dobles: `{{` y `}}`.
Los nombres de los campos pueden ser números (a partir de cero) o estar vacíos (en ese caso, se les asignan implícitamente números correlativos en orden ascendente).

**Sintaxis**

```sql theme={null}
format(pattern, s0[, s1, ...])
```

**Argumentos**

* `pattern` — La cadena de formato que contiene marcadores de posición. [`String`](/es/reference/data-types/string)
* `s0[, s1, ...]` — Uno o más valores que se sustituyen en el patrón. [`Any`](/es/reference/data-types/index)

**Valor devuelto**

Devuelve una cadena formateada. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Marcadores de posición numerados**

```sql title=Query theme={null}
SELECT format('{1} {0} {1}', 'World', 'Hello')
```

```response title=Response theme={null}
┌─format('{1} {0} {1}', 'World', 'Hello')─┐
│ Hello World Hello                       │
└─────────────────────────────────────────┘
```

**Numeración implícita**

```sql title=Query theme={null}
SELECT format('{} {}', 'Hello', 'World')
```

```response title=Response theme={null}
┌─format('{} {}', 'Hello', 'World')─┐
│ Hello World                       │
└───────────────────────────────────┘
```

<div id="overlay">
  ## overlay
</div>

Introducido en: v24.9.0

Reemplaza una parte de la cadena `input` por otra cadena, `replace`, a partir del índice basado en 1 `offset`.

**Sintaxis**

```sql theme={null}
overlay(s, replace, offset[, length])
```

**Argumentos**

* `s` — La cadena de entrada. [`String`](/es/reference/data-types/string)
* `replace` — La cadena de reemplazo [`const String`](/es/reference/data-types/string)
* `offset` — Un entero de tipo `Int` (indexado desde 1). Si `offset` es negativo, se cuenta desde el final de la cadena `s`. [`Int`](/es/reference/data-types/int-uint)
* `length` — Opcional. Un entero de tipo `Int`. `length` especifica la longitud del fragmento dentro de la cadena de entrada `s` que se va a reemplazar. Si no se especifica `length`, el número de bytes eliminados de `s` es igual a la longitud de `replace`; de lo contrario, se eliminan `length` bytes. [`Int`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve una cadena con el reemplazo aplicado. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Reemplazo básico**

```sql title=Query theme={null}
SELECT overlay('My father is from Mexico.', 'mother', 4) AS res;
```

```response title=Response theme={null}
┌─res──────────────────────┐
│ My mother is from Mexico.│
└──────────────────────────┘
```

**Reemplazo con longitud**

```sql title=Query theme={null}
SELECT overlay('My father is from Mexico.', 'dad', 4, 6) AS res;
```

```response title=Response theme={null}
┌─res───────────────────┐
│ My dad is from Mexico.│
└───────────────────────┘
```

<div id="overlayUTF8">
  ## overlayUTF8
</div>

Introducido en: v24.9.0

Reemplaza parte de la cadena `s` por otra cadena, `replace`, a partir del índice `offset`, basado en 1.
Asume que la cadena contiene texto válido codificado en UTF-8.
Si no se cumple esta suposición, no se lanza ninguna excepción y el resultado es indefinido.

**Sintaxis**

```sql theme={null}
overlayUTF8(s, replace, offset[, length])
```

**Argumentos**

* `s` — La cadena de entrada. [`String`](/es/reference/data-types/string)
* `replace` — La cadena de reemplazo. [`const String`](/es/reference/data-types/string)
* `offset` — Un entero `Int` (indexado desde 1). Si `offset` es negativo, se cuenta desde el final de la cadena de entrada `s`. [`(U)Int*`](/es/reference/data-types/int-uint)
* `length` — Opcional. Especifica la longitud del fragmento de la cadena de entrada `s` que se va a reemplazar. Si no se especifica `length`, el número de caracteres eliminados de `s` es igual a la longitud de `replace`; de lo contrario, se eliminan `length` caracteres. [`(U)Int*`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve una cadena con el reemplazo aplicado. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Reemplazo UTF-8**

```sql title=Query theme={null}
SELECT overlayUTF8('Mein Vater ist aus Österreich.', 'der Türkei', 20) AS res;
```

```response title=Response theme={null}
┌─res───────────────────────────┐
│ Mein Vater ist aus der Türkei.│
└───────────────────────────────┘
```

<div id="printf">
  ## printf
</div>

Introducido en: v24.8.0

La función `printf` da formato a la cadena proporcionada con los valores (cadenas, enteros, números de coma flotante, etc.) indicados en los argumentos, de forma similar a la función `printf` de C++.
La cadena de formato puede contener especificadores de formato que comienzan con el carácter `%`.
Todo lo que no forme parte de `%` y del especificador de formato que le sigue se considera texto literal y se copia literalmente en la salida.
El carácter literal `%` puede escaparse con `%%`.
La cadena de formato puede ser una constante o una expresión de columna, lo que permite usar distintos patrones de formato por fila.

**Sintaxis**

```sql theme={null}
printf(format[, sub1, sub2, ...])
```

**Argumentos**

* `format` — La cadena de formato con especificadores `%`. [`String`](/es/reference/data-types/string)
* `sub1, sub2, ...` — Opcional. Cero o más valores que se sustituyen en la cadena de formato. [`Any`](/es/reference/data-types/index)

**Valor devuelto**

Devuelve una cadena formateada. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Formato de estilo C++**

```sql title=Query theme={null}
SELECT printf('%%%s %s %d', 'Hello', 'World', 2024);
```

```response title=Response theme={null}
┌─printf('%%%s %s %d', 'Hello', 'World', 2024)─┐
│ %Hello World 2024                            │
└──────────────────────────────────────────────┘
```

<div id="regexpQuoteMeta">
  ## regexpQuoteMeta
</div>

Introducido en: v20.1.0

Añade una barra invertida antes de estos caracteres con significado especial en las expresiones regulares: `\0`, `\\`, `|`, `(`, `)`, `^`, `$`, `.`, `[`, `]`, `?`, `*`, `+`, `{`, `:`, `-`.
Esta implementación difiere ligeramente de re2::RE2::QuoteMeta.
Escapa el byte cero como `\0` en lugar de `\x00` y solo escapa los caracteres necesarios.

**Sintaxis**

```sql theme={null}
regexpQuoteMeta(s)
```

**Argumentos**

* `s` — La cadena de entrada que contiene caracteres que deben escaparse en regex. [`String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena con los caracteres especiales de regex escapados. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Escapar caracteres especiales de regex**

```sql title=Query theme={null}
SELECT regexpQuoteMeta('Hello. [World]? (Yes)*') AS res
```

```response title=Response theme={null}
┌─res───────────────────────────┐
│ Hello\. \[World\]\? \(Yes\)\* │
└───────────────────────────────┘
```

<div id="replaceAll">
  ## replaceAll
</div>

Introducido en: v1.1.0

Reemplaza todas las ocurrencias de la subcadena `pattern` en `haystack` por la cadena `replacement`.

**Sintaxis**

```sql theme={null}
replaceAll(haystack, pattern, replacement)
```

**Alias**: `replace`

**Argumentos**

* `haystack` — La cadena de entrada en la que se busca. [`String`](/es/reference/data-types/string)
* `pattern` — La subcadena que se debe encontrar y reemplazar. [`const String`](/es/reference/data-types/string)
* `replacement` — La cadena por la que se reemplaza el patrón. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena con todas las apariciones del patrón reemplazadas. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Reemplazar todas las apariciones**

```sql title=Query theme={null}
SELECT replaceAll('Hello, Hello world', 'Hello', 'Hi') AS res;
```

```response title=Response theme={null}
┌─res──────────┐
│ Hi, Hi world │
└──────────────┘
```

<div id="replaceOne">
  ## replaceOne
</div>

Introducido en: v1.1.0

Reemplaza la primera aparición de la subcadena `pattern` en `haystack` con la cadena `replacement`.

**Sintaxis**

```sql theme={null}
replaceOne(haystack, pattern, replacement)
```

**Argumentos**

* `haystack` — La cadena de entrada en la que se realiza la búsqueda. [`String`](/es/reference/data-types/string)
* `pattern` — La subcadena que se debe buscar y reemplazar. [`const String`](/es/reference/data-types/string)
* `replacement` — La cadena por la que se reemplazará el patrón. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena en la que se ha reemplazado la primera aparición del patrón. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Reemplazar la primera aparición**

```sql title=Query theme={null}
SELECT replaceOne('Hello, Hello world', 'Hello', 'Hi') AS res;
```

```response title=Response theme={null}
┌─res─────────────┐
│ Hi, Hello world │
└─────────────────┘
```

<div id="replaceRegexpAll">
  ## replaceRegexpAll
</div>

Introducido en: v1.1.0

Como `replaceRegexpOne`, pero reemplaza todas las apariciones del patrón.
Como excepción, si una expresión regular coincide con una subcadena vacía, el reemplazo no se realiza más de una vez.

**Sintaxis**

```sql theme={null}
replaceRegexpAll(haystack, pattern, replacement)
```

**Alias**: `REGEXP_REPLACE`

**Argumentos**

* `haystack` — La cadena de entrada en la que se busca. [`String`](/es/reference/data-types/string)
* `pattern` — El patrón de expresión regular que se debe encontrar. [`const String`](/es/reference/data-types/string)
* `replacement` — La cadena por la que se reemplaza el patrón; puede contener sustituciones. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena en la que se reemplazan todas las coincidencias de la expresión regular. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Reemplazar todos los caracteres por una versión duplicada**

```sql title=Query theme={null}
SELECT replaceRegexpAll('Hello123', '.', '\\\\0\\\\0') AS res
```

```response title=Response theme={null}
┌─res──────────────────┐
│ HHeelllloo112233     │
└──────────────────────┘
```

**Ejemplo de reemplazo de una subcadena vacía**

```sql title=Query theme={null}
SELECT replaceRegexpAll('Hello, World!', '^', 'here: ') AS res
```

```response title=Response theme={null}
┌─res─────────────────┐
│ here: Hello, World! │
└─────────────────────┘
```

<div id="replaceRegexpOne">
  ## replaceRegexpOne
</div>

Introducido en: v1.1.0

Reemplaza la primera aparición de la subcadena que coincide con la expresión regular `pattern` (en sintaxis re2) en `haystack` por la cadena `replacement`.
`replacement` puede contener sustituciones `\0-\9`.
Las sustituciones `\1-\9` corresponden al 1.º-9.º grupo de captura (subcoincidencia), y la sustitución `\0` corresponde a la coincidencia completa.
Para usar un carácter `\` literal en las cadenas `pattern` o `replacement`, escápalo con `\`.
Ten en cuenta también que los literales de cadena requieren un escape adicional.

**Sintaxis**

```sql theme={null}
replaceRegexpOne(haystack, pattern, replacement)
```

**Argumentos**

* `haystack` — La cadena de entrada en la que se realiza la búsqueda. [`String`](/es/reference/data-types/string)
* `pattern` — El patrón de expresión regular que se debe encontrar. [`const String`](/es/reference/data-types/string)
* `replacement` — La cadena por la que se reemplazará el patrón; puede contener sustituciones. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena en la que se reemplaza la primera coincidencia de la expresión regular. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Conversión de fechas ISO al formato estadounidense**

```sql title=Query theme={null}
SELECT DISTINCT
    EventDate,
    replaceRegexpOne(toString(EventDate), '(\\d{4})-(\\d{2})-(\\d{2})', '\\2/\\3/\\1') AS res
FROM test.hits
LIMIT 7
FORMAT TabSeparated
```

```response title=Response theme={null}
2014-03-17      03/17/2014
2014-03-18      03/18/2014
2014-03-19      03/19/2014
2014-03-20      03/20/2014
2014-03-21      03/21/2014
2014-03-22      03/22/2014
2014-03-23      03/23/2014
```

**Copiar una cadena diez veces**

```sql title=Query theme={null}
SELECT replaceRegexpOne('Hello, World!', '.*', '\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0\\\\0') AS res
```

```response title=Response theme={null}
┌─res────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│ Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World!Hello, World! │
└────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
```

<div id="translate">
  ## translate
</div>

Introducido en: v22.7.0

Reemplaza caracteres de la cadena `s` mediante un mapeo de caracteres uno a uno definido por las cadenas `from` y `to`.
`from` y `to` deben ser cadenas ASCII constantes.
Si `from` y `to` tienen el mismo tamaño, cada aparición del primer carácter de `first` en `s` se reemplaza por el primer carácter de `to`, el segundo carácter de `first` en `s` se reemplaza por el segundo carácter de `to`, etc.
Si `from` contiene más caracteres que `to`, todas las apariciones de los caracteres al final de `from` que no tienen un carácter correspondiente en `to` se eliminan de `s`.
La función no modifica los caracteres no ASCII de `s`.

**Sintaxis**

```sql theme={null}
translate(s, from, to)
```

**Argumentos**

* `s` — La cadena de entrada que se va a transformar. [`String`](/es/reference/data-types/string)
* `from` — Una cadena ASCII constante que contiene los caracteres que se deben reemplazar. [`const String`](/es/reference/data-types/string)
* `to` — Una cadena ASCII constante que contiene los caracteres de reemplazo. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve una cadena con las sustituciones de caracteres aplicadas. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Mapeo de caracteres**

```sql title=Query theme={null}
SELECT translate('Hello, World!', 'delor', 'DELOR') AS res
```

```response title=Response theme={null}
┌─res───────────┐
│ HELLO, WORLD! │
└───────────────┘
```

**Distintas longitudes**

```sql title=Query theme={null}
SELECT translate('clickhouse', 'clickhouse', 'CLICK') AS res
```

```response title=Response theme={null}
┌─res───┐
│ CLICK │
└───────┘
```

<div id="translateUTF8">
  ## translateUTF8
</div>

Introducido en: v22.7.0

Como [`translate`](#translate), pero supone que `s`, `from` y `to` son cadenas codificadas en UTF-8.

**Sintaxis**

```sql theme={null}
translateUTF8(s, from, to)
```

**Argumentos**

* `s` — cadena de entrada UTF-8 que se va a traducir. [`String`](/es/reference/data-types/string)
* `from` — cadena UTF-8 constante que contiene los caracteres que se van a reemplazar. [`const String`](/es/reference/data-types/string)
* `to` — cadena UTF-8 constante que contiene los caracteres de reemplazo. [`const String`](/es/reference/data-types/string)

**Valor devuelto**

Devuelve un valor de tipo de dato `String`. [`String`](/es/reference/data-types/string)

**Ejemplos**

**Traducción de caracteres UTF-8**

```sql title=Query theme={null}
SELECT translateUTF8('Münchener Straße', 'üß', 'us') AS res;
```

```response title=Response theme={null}
┌─res──────────────┐
│ Munchener Strase │
└──────────────────┘
```