What is plur?
The plur npm package is designed to easily pluralize words. It allows you to get the plural form of a word based on the count provided. This can be particularly useful in applications where you need to display text that dynamically changes based on a quantity (e.g., item counts, messages, etc.).
What are plur's main functionalities?
Pluralizing a word
This feature allows you to pluralize a single word based on a count. If the count is more than one, it returns the plural form of the word.
"const plur = require('plur');\nconsole.log(plur('unicorn', 2)); // 'unicorns'"
Custom plural forms
This feature allows you to specify a custom plural form for a word. This is useful for words that do not follow regular pluralization rules.
"const plur = require('plur');\nconsole.log(plur('radius', 2, 'radii')); // 'radii'"
Other packages similar to plur
pluralize
The pluralize package offers similar functionality to plur, allowing for the pluralization of words. It goes a step further by also supporting singularization, counting, and adding functionality to work with irregular words and uncountable nouns. This makes it a bit more versatile compared to plur.
inflection
Inflection is another npm package that provides methods for transforming words between singular and plural forms, among other string transformations like camelizing, underscoring, and humanizing. It offers a broader set of string manipulation functionalities compared to plur, making it suitable for applications that require more than just pluralization.
plur
Pluralize a word
Install
npm install plur
Usage
import plur from 'plur';
plur('unicorn', 4);
plur('puppy', 2);
plur('box', 2);
plur('cactus', 2);
API
plur(word, plural?, count)
word
Type: string
The word to pluralize.
plural
Type: string
Default:
- Irregular nouns will use this list.
- Words ending in s, x, z, ch, sh will be pluralized with -es (eg. foxes).
- Words ending in y that are preceded by a consonant will be pluralized by replacing y with -ies (eg. puppies).
- All other words will have "s" added to the end (eg. days).
Explicitly provide the pluralized word.
The plural suffix will match the case of the last letter in the word.
This option is only for extreme edge-cases. You probably won't need it.
count
Type: number
The count to determine whether to use singular or plural.