Mathias Weidner > Algorithm-CheckDigits-v1.2.1 > Algorithm::CheckDigits::MXX_006

Download:
Algorithm-CheckDigits-v1.2.1.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  1
View/Report Bugs
Module Version: v1.1.2   Source   Latest Release: Algorithm-CheckDigits-v1.3.0

NAME ^

CheckDigits::MXX_006 - compute check digits with Verhoeff scheme

SYNOPSIS ^

  use Algorithm::CheckDigits;

  $verhoeff = CheckDigits('verhoeff');

  if ($verhoeff->is_valid('14567894')) {
        # do something
  }

  $cn = $verhoeff->complete('1456789');
  # $cn = '14567894'

  $cd = $verhoeff->checkdigit('14567894');
  # $cd = '4'

  $bn = $verhoeff->basenumber('14567894');
  # $bn = '1456789'

DESCRIPTION ^

ALGORITHM

  1. Right to left all digits are permutated according to a permutation table.
  2. The permutated digits are combined using a diëder table. The first with the second, the result with the third, this result with the fourth and so on.
  3. The result of the last combination in the diëder table is in such a way combined that the result is 0 (zero). The number used for this combination is the checksum.

For details look at the source.

METHODS

is_valid($number)

Returns true only if $number consists solely of numbers and the last digit is a valid check digit according to the algorithm given above.

Returns false otherwise,

complete($number)

The check digit for $number is computed and concatenated to the end of $number.

Returns the complete number with check digit or '' if $number does not consist solely of digits.

basenumber($number)

Returns the basenumber of $number if $number has a valid check digit.

Return '' otherwise.

checkdigit($number)

Returns the checkdigit of $number if $number has a valid check digit.

Return '' otherwise.

EXPORT

None by default.

AUTHOR ^

Mathias Weidner, <mamawe@cpan.org>

THANKS ^

Jonathan Peters wrote Algorithm::Verhoeff from which I took the routine to compute the checkdigits.

SEE ALSO ^

perl, CheckDigits, http://www.cs.utsa.edu/~wagner/laws/verhoeff.html, http://www.cs.nmsu.edu/~cssem/Dickcheckdoc.pdf

syntax highlighting: