fauxcompany/escreve_numero

Biblioteca que proporcina escrever um número por extenso com opção de moeda e de nome ser de gênero feminino

0.0.3 2019-08-02 16:19 UTC

Requires

• php: >=5.3.0

Requires (Dev)

• phpunit/phpunit: 4.8.36

Apache-2.0

• Guilherme Fabrin Franco
• Leonardo Motyczka

README

Este projeto objetiva a escrita de um número por extenso. São opções desde:

• Número normativo;
• Número em Moeda (reais);
• Número em gênero feminino;
• Número com suas casas decimais;

Badges

Github

Social

Contribuidores

• guifabrin -
• leomoty

Outros

Instalação:

• Execute: composer require fauxcompany/escreve_numero
• Inclua o autoload.php do vendor no seu arquivo e chame o utilizador da classe Numero.

Limitações

• Quantidade de decimos podem chegar a 18;
• Quantidade de casas decimais podem chegar até 20 e caso sejam maiores que isto são truncadas;

Uso

<?php 
    include "vendor/autoload.php";
    use \fauxcompany\EscreveNumero\Numero;

• Instancie um número, preferencialmente como string dado as limitações de ponto flutuante do PHP:

<?php 
    $numero = new Numero("1.99");

• Escreva:

<?php
    echo $numero->extensoComo(Numero::NORMAL);
    // um com noventa e nove
    echo $numero->extensoComo(Numero::MOEDA);
    // um real com noventa e nove centavos
    echo $numero->extensoComo(Numero::FEMININO);
    // uma com noventa e nove
    echo $numero->extensoComo(Numero::FEMININO);
    // um com noventa e nove centésimos

• Ou chame estaticamente

<?php
    echo Numero::extenso("1.99");
    // um com noventa e nove
    echo Numero::extenso("1.99", Numero::MOEDA);
    // um real com noventa e nove centavos
    echo Numero::extenso("1.99", Numero::FEMININO);
    // uma com noventa e nove
    echo Numero::extenso("1.99", Numero::FEMININO);
    // um com noventa e nove centésimos

• Caso precise da escrita zero:

<?php
    $numero = new Numero("0.99");
    echo $numero->extensoComo(Numero::DECIMAL, true);
    // ou
    echo Numero::extenso("0.99", Numero::NORMAL, true);
    // zero com noventa e nove centésimos

Contribuições

Toda e qualquer contribuição neste projeto é bem vinda. Por favor, siga as seguintes instruções:

• Em caso de dúvida, sugestão ou outra abra uma issue;
• Em caso de proposta de mudança, faça um fork do repositório e crie um pull request;
• Seja específico em ambos e descreva o máximo possível o porquê da proposta.