@agape/string
toPlural Function
Returns a string formatted in its plural form.
API
function toPlural( word: string): stringtoPlural
stringReturns a string formatted in its plural form.
@paramword:
string A singular word to be pluralized.
@returns
stringDescription
Returns a string formatted in its plural form.
Handles common English pluralization rules, including:
- y → ies
- s/x/z/ch/sh → es
- known irregulars (e.g., child → children)
- acronym exceptions (e.g., API → APIs)
The output preserves the casing of the input, especially the prefix.
Usage
toPlural("city"); // "cities"
toPlural("box"); // "boxes"
toPlural("child"); // "children"
toPlural("person"); // "people"
toPlural("API"); // "APIs"
toPlural("ID"); // "IDs"
toPlural("File"); // "Files"
toPlural("buzz"); // "buzzes"
toPlural("CPU"); // "CPUs"
toPlural("DOG"); // "DOGS"
toPlural("A"); // "As"