Utilitários Array

As funções utilitárias para arrays fornecem uma variedade de métodos para manipular e transformar arrays. Elas ajudam a simplificar operações comuns, como dividir, achatar, embaralhar e encontrar diferenças entre arrays, entre outras.

Instalação

Para instalar as funções utilitárias para arrays, use um dos seguintes comandos, dependendo do seu gerenciador de pacotes:

::: code-group

npm install @utilify/array

yarn add @utilify/array

pnpm add @utilify/array

:::

Após a instalação, você pode importar as funções no seu projeto, utilizando ESM ou CJS.

Uso

Esta biblioteca suporta tanto o sistema de módulos ESM quanto CJS. Use o método de importação que corresponda à configuração do seu projeto.

::: code-group

import { shuffle } from '@utilify/array'; 

const { shuffle } = require('@utilify/array');  

:::

Visão Geral

Aqui está uma visão geral das funções disponíveis no pacote de utilitários para arrays:

after

function after(array: any[], n: number): any[]  

Retorna os elementos do array após o índice n.

before

function before(array: any[], n: number): any[]  

Retorna os elementos do array antes do índice n.

chunk

function chunk(array: any[], size: number): any[][]  

Divide o array em pedaços menores de tamanho size.

difference

function difference(array: any[], values: any[]): any[]  

Retorna os elementos do array que não estão presentes no segundo array.

first

function first(array: any[], n?: number): any[]  

Retorna os primeiros n elementos do array.

flattenArr

function flattenArr(array: any[], depth?: number): any[]  

Achata o array até a profundidade especificada.

getRandom

function getRandom(array: any[]): any  

Retorna um elemento aleatório do array.

isIterable

function isIterable(obj: any): boolean  

Verifica se o objeto é iterável.

last

function last(array: any[], n?: number): any[]  

Retorna os últimos n elementos do array.

rotate

function rotate(array: any[], n: number): any[]  

Rotaciona os elementos do array n posições.

sanitizeArr

function sanitizeArr(array: any[], values: any[], replaceValue?: any): any[]  

Remove ou substitui os valores especificados no array.

shuffle

function shuffle(array: any[]): any[]  

Embaralha os elementos do array.

swap

function swap(array: any[], index1: number, index2: number): any[]  

Troca os elementos nas posições index1 e index2.

union

function union(...arrays: any[][]): any[]  

Retorna a união de múltiplos arrays.

unique

function unique(array: any[]): any[]  

Retorna um array com elementos únicos.