项目作者: portujs

项目描述 :
Pluralize Portuguese nouns.
高级语言: JavaScript
项目地址: git://github.com/portujs/pluralizador.js.git
创建时间: 2019-01-20T15:58:49Z
项目社区:https://github.com/portujs/pluralizador.js

开源协议:MIT License

下载


Pluralizador.js

Status
Licença MIT

Pluralizador de substantivos.


Precisando de um desenvolvedor? Entre em contato: theuves@gmail.com


Instalação

Instale-o com npm:

  1. npm install --save pluralizador

…ou com Yarn:

  1. yarn add pluralizador

Uso

Veja alguns exemplos:

  1. const pluralize = require("pluralizador");
  2. pluralize("coração");
  3. //-> "corações"
  4. pluralize("coração", 1);
  5. //-> "coração"
  6. pluralize("coração", 2);
  7. //-> "corações"
  8. pluralize("pastel", 743);
  9. //-> "pastéis"
  10. pluralize("português", 42);
  11. //-> "portugueses"

Exemplo de possível uso

  1. var fs = require("fs");
  2. var pluralize = require("pluralizador");
  3. fs.readdir("./", (err, files) => {
  4. console.log(`Há ${files.length} ${pluralize("arquivo", files.length)}.`);
  5. // retorna "Há 1 arquivo." se tiver 1 arquivo.
  6. // retorna "Há 2 arquivos." se tiver 2 arquivos.
  7. });

API

pluralize(word [, count])

word

string (obrigatório)

Um substantivo português qualquer para ser pluralizado.

count

number (opcional)

Uma quantidade desse substantivo para verificar se deve pluralizar ou não.

Observações

Obs. I:

A língua portuguesa é extremamente irregular e consequentemente há algumas
dificuldades para um algoritmo manipular palavras, sentenças, etc. No caso das
palavras terminadas em /-ão/, não há uma regra geral para a pluralização, pois
isso varia de acordo com a etimologia da palavra. Desse modo, essa ferramenta
se beneficia duma lista predefinida dos substantivos mais irregulares,
portanto, esteja ciente que nesses casos a pluralização está sujeita a falhas
(embora sua ocorrência seja pouco provável).

Sinta-se livre para aumentar a lista enviando um Pull Request.

Obs. II:

Essa ferramenta pluraliza apenas substantivos. Se você deseja pluralizar um verbo
(por exemplo: de amei para amaram, de amarei para amarão, ou qualquer
coisa do gênero), então você pode usar uma outra ferramenta, como o
Conjugador.js que permite que
você conjugue verbos da língua portuguesa.

TODO

  • Opção para escolher plural de palavras terminadas em /-ão/.

Licença

MIT © Matheus Alves e outros.