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

> Documentación de las funciones de bitmap

# Funciones de bitmap

Los bitmaps se pueden construir de dos formas. La primera utiliza la función de agregación groupBitmap con `-State`; la segunda consiste en construir un bitmap a partir de un Array.

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

Introducido en: v20.1.0

Calcula la conjunción lógica (AND) de dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapAnd(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve un bitmap que contiene los bits presentes en los dos bitmaps de entrada [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapAnd(bitmapBuild([1, 2, 3]), bitmapBuild([3, 4, 5]))) AS res;
```

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

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

Introducido en: v20.1.0

Devuelve la cardinalidad de la conjunción lógica (AND) de dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapAndCardinality(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el número de bits activados en la intersección de los dos bitmaps [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapAndCardinality(bitmapBuild([1,2,3]), bitmapBuild([3,4,5])) AS res;
```

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

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

Introducido en: v20.1.0

Calcula la diferencia de conjuntos A AND-NOT B entre dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapAndnot(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve un bitmap que contiene los bits activados presentes en el primer bitmap, pero no en el segundo [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapAndnot(bitmapBuild([1, 2, 3]), bitmapBuild([3, 4, 5]))) AS res;
```

```response title=Response theme={null}
┌─res────┐
│ [1, 2] │
└────────┘
```

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

Introducido en: v20.1.0

Devuelve la cardinalidad de la operación AND-NOT entre dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapAndnotCardinality(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el número de bits activados en el resultado de `bitmap1 AND-NOT bitmap2` [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapAndnotCardinality(bitmapBuild([1,2,3]), bitmapBuild([3,4,5])) AS res;
```

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

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

Introducido en: v20.1.0

Crea un bitmap a partir de un array de enteros. Los tipos de elementos compatibles son enteros con signo y sin signo de 8, 16, 32 o 64 bits. Es la operación inversa de la función [`bitmapToArray`](/es/reference/functions/regular-functions/bitmap-functions#bitmapToArray).

**Sintaxis**

```sql theme={null}
bitmapBuild(array)
```

**Argumentos**

* `array` — Array de enteros. [`Array((U)Int*)`](/es/reference/data-types/array)

**Valor devuelto**

Devuelve un bitmap a partir del array proporcionado [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapBuild([1, 2, 3, 4, 5]) AS res, toTypeName(res);
```

```response title=Response theme={null}
┌─res─┬─toTypeName(bitmapBuild([1, 2, 3, 4, 5]))─────┐
│     │ AggregateFunction(groupBitmap, UInt8)        │
└─────┴──────────────────────────────────────────────┘
```

**Bitmap con signo**

```sql title=Query theme={null}
SELECT bitmapBuild([-128, -1]::Array(Int8)) AS res, toTypeName(res);
```

```response title=Response theme={null}
┌─res─┬─toTypeName(bitmapBuild([-128, -1]::Array(Int8)))─┐
│     │ AggregateFunction(groupBitmap, Int8)             │
└─────┴──────────────────────────────────────────────────┘
```

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

Introducido en: v20.1.0

Devuelve el número de bits activados (la cardinalidad) en el bitmap.

**Sintaxis**

```sql theme={null}
bitmapCardinality(bitmap)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el número de bits activados en el bitmap [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapCardinality(bitmapBuild([1, 3, 3, 5, 7, 7])) AS res
```

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

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

Introducido en: v20.1.0

Comprueba si el bitmap contiene un elemento específico. El valor se compara como un entero sin signo del tipo de elemento del bitmap. En los bitmaps con signo, un elemento negativo coincide con su equivalente sin signo (por ejemplo, el valor `Int8` `-1` coincide con `255`).

**Sintaxis**

```sql theme={null}
bitmapContains(bitmap, value)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `value` — Elemento cuya presencia se debe comprobar. [(U)Int8/16/32/64](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve `1` si el bitmap contiene el valor especificado; de lo contrario, `0` [`UInt8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapContains(bitmapBuild([1, 2, 3]), 2) AS res;
```

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

**Bitmap con signo**

```sql title=Query theme={null}
SELECT bitmapContains(bitmapBuild([-1]::Array(Int8)), 255) AS res;
```

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

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

Introducido en: v20.1.0

Comprueba si el primer bitmap contiene todos los bits activados del segundo bitmap.

**Sintaxis**

```sql theme={null}
bitmapHasAll(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve `1` si todos los bits activados del segundo bitmap están presentes en el primero; de lo contrario, `0` [`UInt8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapHasAll(bitmapBuild([1, 2, 3]), bitmapBuild([2, 3])) AS res;
```

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

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

Introducido en: v20.1.0

Comprueba si el primer bitmap contiene algún bit activado del segundo bitmap.

**Sintaxis**

```sql theme={null}
bitmapHasAny(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve `1` si algún bit del segundo bitmap está presente en el primero; en caso contrario, `0` [`UInt8`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapHasAny(bitmapBuild([1, 2, 3]), bitmapBuild([3, 4, 5])) AS res;
```

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

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

Introducido en: v20.1.0

Devuelve el elemento de mayor valor de un bitmap, interpretado como un entero sin signo del tipo de elemento del bitmap. En los bitmaps con signo, los valores negativos se tratan como sus equivalentes sin signo (por ejemplo, el valor `-1` de `Int8` es `255`). Devuelve `0` si el bitmap está vacío.

**Sintaxis**

```sql theme={null}
bitmapMax(bitmap)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el elemento mayor como un valor sin signo del tipo de elemento del bitmap, o `0` si el bitmap está vacío [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapMax(bitmapBuild([1, 2, 3, 4, 5])) AS res;
```

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

**Bitmap con signo**

```sql title=Query theme={null}
SELECT bitmapMax(bitmapBuild([-128, -1]::Array(Int8))) AS res;
```

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

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

Introducido en: v20.1.0

Devuelve el elemento más pequeño de un bitmap, interpretado como un entero sin signo del tipo de elemento del bitmap. En los bitmaps con signo, los valores negativos se tratan como sus equivalentes sin signo (por ejemplo, el valor `-128` de tipo `Int8` equivale a `128`). Si el bitmap está vacío, devuelve `UINT32_MAX` (`UINT64_MAX` si el tipo de elemento del bitmap tiene más de 32 bits).

**Sintaxis**

```sql theme={null}
bitmapMin(bitmap)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el elemento más pequeño como un valor sin signo del tipo de elemento del bitmap, o `UINT32_MAX`/`UINT64_MAX` si el bitmap está vacío [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapMin(bitmapBuild([3, 5, 2, 6])) AS res;
```

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

**Bitmap con signo**

```sql title=Query theme={null}
SELECT bitmapMin(bitmapBuild([-128, -1]::Array(Int8))) AS res;
```

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

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

Introducido en: v20.1.0

Calcula la disyunción lógica (OR) de dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapOr(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve un bitmap que contiene los bits activados presentes en cualquiera de los bitmaps de entrada [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapOr(bitmapBuild([1, 2, 3]), bitmapBuild([3, 4, 5]))) AS res;
```

```response title=Response theme={null}
┌─res─────────────┐
│ [1, 2, 3, 4, 5] │
└─────────────────┘
```

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

Introducido en: v20.1.0

Devuelve la cardinalidad de la disyunción lógica (OR) de dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapOrCardinality(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el número de bits activados en la unión de los dos bitmaps [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapOrCardinality(bitmapBuild([1,2,3]), bitmapBuild([3,4,5])) AS res;
```

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

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

Introducido en: v20.1.0

Devuelve un subconjunto del bitmap que contiene elementos en el rango de valores `[start, end)`. Los valores de los elementos se comparan como enteros sin signo del tipo de elemento del bitmap.

**Sintaxis**

```sql theme={null}
bitmapSubsetInRange(bitmap, start, end)
```

**Argumentos**

* `bitmap` — Bitmap del que extraer el subconjunto. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `start` — Inicio del rango (inclusivo). [`UInt*`](/es/reference/data-types/int-uint) - `end` — Fin del rango (exclusivo). [`UInt*`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un bitmap que contiene solo los elementos en el rango de valores especificado [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapSubsetInRange(bitmapBuild([1, 2, 3, 4, 5]), 2, 5)) AS res;
```

```response title=Response theme={null}
┌─res───────┐
│ [2, 3, 4] │
└───────────┘
```

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

Introducido en: v20.1.0

Devuelve un subconjunto de como máximo `cardinality_limit` elementos cuyos valores son mayores o iguales que `range_start`, seleccionando los menores valores en orden sin signo.

**Sintaxis**

```sql theme={null}
bitmapSubsetLimit(bitmap, range_start, cardinality_limit)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `range_start` — Inicio del rango (inclusivo). [`UInt32`](/es/reference/data-types/int-uint) - `cardinality_limit` — Cardinalidad máxima del subconjunto. [`UInt32`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un bitmap que contiene como máximo `cardinality_limit` elementos con un valor sin signo igual o superior a `range_start` [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT arraySort(bitmapToArray(bitmapSubsetLimit(bitmapBuild([1, 5, 3, 2, 8]), 3, 2))) AS res;
```

```response title=Response theme={null}
┌─res────┐
│ [3, 5] │
└────────┘
```

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

Introducido en: v20.1.0

Convierte un bitmap en un array de sus elementos. El tipo de elemento del array coincide con el tipo de elemento `T` del bitmap (entero con o sin signo). Es la función opuesta a [`bitmapBuild`](/es/reference/functions/regular-functions/bitmap-functions#bitmapBuild).

**Sintaxis**

```sql theme={null}
bitmapToArray(bitmap)
```

**Argumentos**

* `bitmap` — Bitmap que se convertirá. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve un array de los elementos contenidos en el bitmap [`Array(T)`](/es/reference/data-types/array)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapBuild([1, 2, 3, 4, 5])) AS res;
```

```response title=Response theme={null}
┌─res─────────────┐
│ [1, 2, 3, 4, 5] │
└─────────────────┘
```

**Bitmap con signo**

```sql title=Query theme={null}
SELECT arraySort(bitmapToArray(bitmapBuild([-128, -1]::Array(Int8)))) AS res;
```

```response title=Response theme={null}
┌─res────────┐
│ [-128, -1] │
└────────────┘
```

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

Introducido en: v20.1.0

Reemplaza elementos de un bitmap según una correspondencia entre `from_array` y `to_array`.
Los valores se interpretan como enteros sin signo del tipo de elemento del bitmap (el mismo dominio que [`bitmapContains`](/es/reference/functions/regular-functions/bitmap-functions#bitmapContains)).
En los bitmaps con signo, un elemento negativo coincide con su equivalente sin signo (por ejemplo, el valor `Int8` `-1` coincide con `255`).
Un valor de `to_array` que no cabe en el tipo de elemento del bitmap genera `BAD_ARGUMENTS`. Un valor de `from_array`
que no cabe simplemente no se encuentra, por lo que no se aplica el reemplazo correspondiente.

**Sintaxis**

```sql theme={null}
bitmapTransform(bitmap, from_array, to_array)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `from_array` — Array de bits activados originales que se van a reemplazar. [`Array(T)`](/es/reference/data-types/array). - `to_array` — Array de nuevos bits activados con los que se realizará el reemplazo. [`Array(T)`](/es/reference/data-types/array).

**Valor devuelto**

Devuelve un bitmap cuyos elementos se transforman según el mapeo indicado [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapTransform(bitmapBuild([1, 2, 3, 4, 5]), [2, 4], [20, 40])) AS res;
```

```response title=Response theme={null}
┌─res───────────────┐
│ [1, 3, 5, 20, 40] │
└───────────────────┘
```

**Bitmap con signo**

```sql title=Query theme={null}
SELECT arraySort(bitmapToArray(bitmapTransform(bitmapBuild([-1, 0]::Array(Int8)), [255], [10]))) AS res;
```

```response title=Response theme={null}
┌─res─────┐
│ [0, 10] │
└─────────┘
```

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

Introducido en: v20.1.0

Calcula la diferencia simétrica (XOR) entre dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapXor(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve un bitmap que contiene los bits activados presentes en cualquiera de los bitmap de entrada, pero no en ambos [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(bitmapXor(bitmapBuild([1, 2, 3]), bitmapBuild([3, 4, 5]))) AS res;
```

```response title=Response theme={null}
┌─res──────────┐
│ [1, 2, 4, 5] │
└──────────────┘
```

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

Introducido en: v20.1.0

Devuelve la cardinalidad del XOR (diferencia simétrica) de dos bitmaps.

**Sintaxis**

```sql theme={null}
bitmapXorCardinality(bitmap1, bitmap2)
```

**Argumentos**

* `bitmap1` — Primer objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `bitmap2` — Segundo objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction).

**Valor devuelto**

Devuelve el número de bits activados en la diferencia simétrica de los dos bitmaps [`UInt64`](/es/reference/data-types/int-uint)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapXorCardinality(bitmapBuild([1,2,3]), bitmapBuild([3,4,5])) AS res;
```

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

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

Introducido en: v21.9.0

Devuelve un subconjunto del bitmap tras omitir `offset` elementos en orden ascendente de valores sin signo. La cardinalidad máxima del bitmap devuelto es `cardinality_limit`.

**Sintaxis**

```sql theme={null}
subBitmap(bitmap, offset, cardinality_limit)
```

**Argumentos**

* `bitmap` — Objeto bitmap. [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction). - `offset` — Número de bits activados que se omiten desde el principio (indexado desde cero). [`UInt32`](/es/reference/data-types/int-uint) - `cardinality_limit` — Número máximo de bits activados que se incluirán en el subconjunto. [`UInt32`](/es/reference/data-types/int-uint)

**Valor devuelto**

Devuelve un bitmap que contiene como máximo `cardinality_limit` elementos tras omitir `offset` elementos en orden ascendente de valores sin signo [`AggregateFunction(groupBitmap, T)`](/es/reference/data-types/aggregatefunction)

**Ejemplos**

**Ejemplo de uso**

```sql title=Query theme={null}
SELECT bitmapToArray(subBitmap(bitmapBuild([1, 2, 3, 4, 5]), 2, 2)) AS res;
```

```response title=Response theme={null}
┌─res────┐
│ [3, 4] │
└────────┘
```