Eenvoudig strings en arrays delen

Een lichtgewicht utilitybibliotheek om strings en arrays op meerdere manieren te verdelen

Installatie

npm

npm install @nyaomaru/divider

Gebruik

basic

import { divider } from '@nyaomaru/divider';

// divide a string by index position
const helloArray = divider('hello', 1, 3);
// ['h', 'el', 'lo']

const [hello1, hello2, ...restHello] = divider('hello', 1, 3, 4);
// hello1 = 'h'
// hello2 = 'el'
// restHello = ['l', 'o']

// split string using character delimiter
const divideWithString = divider('hello', 'e');
// ['h', 'llo']

const divideWithMultipleString = divider('hello', 'l');
// ['he', 'o']

// divide the array of strings
const words = ['hello', 'world'];
const dividedWords = divider(words, 2);
// [['he', 'llo'], ['wo', 'rld']]

const dividedWordsWithFlattenOption = divider(words, 2, { flatten: true });
// ['he', 'llo', 'wo', 'rld']

const dividedWithTrimOption = divider([' hello ', ' world '], 2, { trim: true });
// ['h', 'ello', 'w', 'orld']

Kenmerken

String Divisie

Verdeel strings door indexposities of karakterscheidingstekens met een eenvoudige API.

Array Verwerking

Verwerk matrices van strings met dezelfde intuïtieve interface.

Geneste Array

Verwerk complexe gegevens structuren met ondersteuning voor geneste arrays.

Flexibele uitvoer

Verkrijg resultaten als arrays of gebruik destructurering voor individuele variabelen.

Afvlakken Optie

Vereenvoudig de resultaten met de optie Afvlakken om een array op één niveau te krijgen.

Gemengde scheidingstekens

Combineer indexposities en teken scheidingstekens in dezelfde bewerking.

API Referentie

divider(input, ...dividers, options?)

Splitst een string of array van strings op basis van opgegeven scheidingstekens en retourneert een array of geneste array.

Parameters:

input : String of Array om te delen
dividers : Numbers (index posities) of strings (karakter scheidingstekens)
options : Optioneel configuratieobject

Options:

flatten : Boolean - Indien waar, maakt het resultaat plat in een enkele matrix
trim : Boolean - Indien waar, worden witregels uit elk opgedeeld segment verwijderd
exclude : `'none' | 'empty' | 'whitespace'` - Hoe lege segmenten en witruimtes uit het resultaat te verwijderen

dividerFirst(input, ...dividers)

Geeft het eerste element van de gesplitste string terug.

Parameters:

input : String of Array om te delen
dividers : Numbers (index posities) of strings (karakter scheidingstekens)

dividerLast(input, ...dividers)

Geeft het laatste element van de gesplitste string terug.

Parameters:

input : String of Array om te delen
dividers : Numbers (index posities) of strings (karakter scheidingstekens)

dividerLoop(input, size, options?)

Verdeelt de invoer in stukken van gelijke grootte op basis van het opgegeven aantal. Handig voor het splitsen op vaste lengte.

Parameters:

input : String of Array om te delen
size : De lengte (aantal tekens) van elk stuk. Moet een positief geheel getal zijn.
options : Optioneel configuratieobject

Options:

flatten : Boolean - Indien waar, maakt het resultaat plat in een enkele matrix
trim : Boolean - Indien waar, worden witregels uit elk opgedeeld segment verwijderd
exclude : `'none' | 'empty' | 'whitespace'` - Hoe lege segmenten en witruimtes uit het resultaat te verwijderen
startOffset : Nummer - Startindex offset bij het splitsen in stukken (alleen voor `dividerLoop`)
maxChunks : Nummer - Maximale aantal toegestane stukken. Extra stukken worden samengevoegd in het laatste stuk

dividerNumberString(input, options?)

Verdeelt invoer van number en string.

Parameters:

input : String of Array om te delen
options : Optioneel configuratieobject

Options:

flatten : Boolean - Indien waar, maakt het resultaat plat in een enkele matrix
trim : Boolean - Indien waar, worden witregels uit elk opgedeeld segment verwijderd
exclude : `'none' | 'empty' | 'whitespace'` - Hoe lege segmenten en witruimtes uit het resultaat te verwijderen

📘 Volledige API-documentatie bekijken op GitHub Pages

Voorinstellingen

Veelvoorkomende splitsers uit de echte wereld die zijn gebouwd bovenop `divider`.

emailDivider()

Verdeel een e-mailadres in lokale en domeindelen, met optionele TLD-splitsing.

csvDivider()

CSV-compatibele splitsing met ondersteuning voor geciteerde velden, aangepaste scheidingstekens/citaten en trimming.

pathDivider()

Verdeel bestands paden door `/` of `|`, met opties om lege segmenten te trimmen of te behouden.

🧪 Try these in the Playground