Adriano Ferreira > Business-BR-Ids > Business::BR::PIS

Download:
Business-BR-Ids-0.0022.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.0022   Source  

NAME ^

Business::BR::PIS - Perl module to test for correct PIS numbers

SYNOPSIS ^

  use Business::BR::PIS; 

  print "ok " if test_pis('121.51144.13-7'); # prints 'ok '
  print "bad " unless test_pis('121.51144.13-0'); # prints 'bad '

DESCRIPTION ^

This module handles PIS numbers, testing, formatting, etc.

EXPORT

test_pis is exported by default. canon_pis, format_pis, parse_pis and random_pis can be exported on demand.

THE CHECK EQUATIONS ^

A correct PIS number has a check digit which is computed from the base 10 first digits. Consider the PIS number written as 11 digits

  c[1] c[2] c[3] c[4] c[5] c[6] c[7] c[8] c[9] c[10] dv[1]

To check whether a PIS is correct or not, it has to satisfy the check equation:

  c[1]*3+c[2]*2+c[3]*9+c[4]*8+c[5]*7+
          c[6]*6+c[7]*5+c[8]*4+c[9]*3+c[10]*2+dv[1] = 0 (mod 11) or
                                                   = 1 (mod 11) (if dv[1]=0)

BUGS ^

Absolute lack of documentation by now.

SEE ALSO ^

Please reports bugs via CPAN RT, http://rt.cpan.org/NoAuth/Bugs.html?Dist=Business-BR-Ids By doing so, the author will receive your reports and patches, as well as the problem and solutions will be documented.

AUTHOR ^

A. R. Ferreira, <ferreira@cpan.org>

COPYRIGHT AND LICENSE ^

Copyright (C) 2005 by A. R. Ferreira

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

syntax highlighting: