<commit_before># extenso

![Build Status](https://api.travis-ci.org/theuves/extenso.svg)
![NPM version](https://badge.fury.io/js/extenso.svg)

> Escrever um número por extenso.

Instale-o com `npm install --save extenso`.

## Caracteristicas

* aceita número de até 66 digitos
* aceita números negativos e decimais

## Uso

Exija a dependência com:

```js
var extenso = require('extenso');
```

### extenso(*número*[, *opções*])

Onde `número` deve ser um número válido (*number* ou *string*).

E `opções` pode ser:

* `feminino` - para retornar números escritos no feminino
 * para *um* (*uma*) e *dois* (*duas*).

## Exemplos

Veja alguns exemplos abaixo:

```js
extenso(123); //=> 'cento e vinte e três'
extenso(-123); //=> 'menos cento e vinte e três'
```

```js
extenso('1000000'); //=> 'um milhâo'
extenso('1.000.000'); //=> 'um milhâo'
```

```js
extenso('1,0'); //=> 'um'
extenso('0,5'); //=> 'cinco décimos'
extenso('1,5'); //=> 'um inteiro e cinco décimos'
```

```js
extenso(1, {feminino: true}); //=> 'uma'
extenso(2, {feminino: true}); //=> 'duas'
```

Números com mais de 15 dígitos **devem** ser passados como *string*:

```js
extenso('10000000000000001'); //=> 'dez quatrilhões e um'
```

## Observações

Use `,` para separar decimais e `.` para separar milhares.

## Licença

MIT ([veja o conteúdo](https://git.io/extenso))
<commit_msg>Adiciona mais informações<commit_after># extenso

![Build Status](https://api.travis-ci.org/theuves/extenso.svg)
![NPM version](https://badge.fury.io/js/extenso.svg)

> Escrever um número por extenso.

Instale-o com `npm i extenso` ou `bower i extenso`.

## Caracteristicas

* aceita número de até 66 digitos
* aceita números negativos e decimais

## Uso

Exija a dependência com:

```js
var extenso = require('extenso');
```

### extenso(*número*[, *opções*])

Onde `número` deve ser um número válido (*number* ou *string*).

E `opções` pode ser:

* `feminino` - para retornar números escritos no feminino
 * para *um* (*uma*) e *dois* (*duas*).

## Exemplos

Veja alguns exemplos abaixo:

```js
extenso(123); //=> 'cento e vinte e três'
extenso(-123); //=> 'menos cento e vinte e três'
```

```js
extenso(1000000); //=> 'um milhâo'
extenso('1000000'); //=> 'um milhâo'
extenso('1.000.000'); //=> 'um milhâo'
```

```js
extenso('1,0'); //=> 'um'
extenso('0,5'); //=> 'cinco décimos'
extenso('1,5'); //=> 'um inteiro e cinco décimos'
```

```js
extenso(1, {feminino: true}); //=> 'uma'
extenso(2, {feminino: true}); //=> 'duas'
```

Números com mais de 15 dígitos **devem** ser passados como *string*:

```js
extenso('10000000000000001'); //=> 'dez quatrilhões e um'
```

## Observações

Use `,` para separar decimais e `.` para separar milhares.

## Licença

MIT ([veja o conteúdo](https://git.io/extenso))

{'fraction_non_alphanumeric': 0.20463600144875047, 'fraction_numerical': 0.03802969938428106, 'mean_word_length': 4.352713178294573, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 26, 'https://': 6, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 2, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1390103', 'n_tokens_mistral': 1226, 'n_tokens_neox': 1131, 'n_words': 298}