Type: Package
Title: Implementation of the 'Verhoeff' Check Digit Algorithm
Version: 0.4.0
Author: Conor Neilson
Maintainer: Conor Neilson <condwanaland@gmail.com>
Description: An implementation of the 'Verhoeff' algorithm for calculating check digits (Verhoeff, J. (1969) <doi:10.1002/zamm.19710510323>). Functions are provided to calculate a check digit given an input number, calculate and append a check digit to an input number, and validate that a check digit is correct given an input number.
License: GPL-3
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.1.1
Suggests: testthat, dplyr
NeedsCompilation: no
Packaged: 2021-01-22 21:25:33 UTC; conorneilson
Repository: CRAN
Date/Publication: 2021-01-26 12:20:02 UTC

calculate_digit

Description

Calculates a single Verhoeff Check Digit. This function is exported, but it would usually be called from one of the 'verhoeff_*' wrapper functions

Usage

calculate_digit(number, d5, d5_p, inv_v)

Arguments

number

A number you want to calculate the check digit for

d5

The verhoeff d5 matrix. Retrievable with create_verhoeff_matrices()$d5

d5_p

The verhoeff p matrix. Retrievable with create_verhoeff_matrices()$d5_p

inv_v

The verhoeff inv matrix. Retrievable with create_verhoeff_matrices()$inv_v

Value

A single integer

Examples

dat <- verhoeff::create_verhoeff_matrices()
calculate_digit(5, dat$d5, dat$d5_p, dat$inv_v)

create_verhoeff_matrices

Description

create_verhoeff_matrices

Usage

create_verhoeff_matrices()

Value

An object with three fields; d5, d5_p, and inv_v

Examples

verhoeff::create_verhoeff_matrices()$d5
verhoeff::create_verhoeff_matrices()$d5_p
verhoeff::create_verhoeff_matrices()$inv_v

prepare_number

Description

Takes a number and prepares it for input to the verhoeff algorithim by reversing it

Usage

prepare_number(number)

Arguments

number

A single number that can be coerced to numeric

Value

A numeric vector of length equal to number of digits in the input

Examples

prepare_number(1234)

verhoeff_append

Description

Return a number with its check digit appended

Usage

verhoeff_append(number, sep = "-")

Arguments

number

The number to calculate a check digit for

sep

A separator for the two numbers

Value

Numeric vector of length equal to its input

Examples

verhoeff::verhoeff_append(123)

verhoeff_calculate

Description

verhoeff_calculate

Usage

verhoeff_calculate(number, as_list = FALSE)

Arguments

number

The vector of numbers you want a check digit for

as_list

Return the results as a list? Defaults to false

Value

Vector or list of check digits

Examples

verhoeff_calculate(1234)

verhoeff_validate

Description

Enter a number, and an existing check digit. Function will return true if the supplied check digit is a correct verhoeff check digit for the given number

Usage

verhoeff_validate(number, check_digit)

Arguments

number

A numerical input

check_digit

An existing check digit for the input number

Value

Logical vector

Examples

verhoeff::verhoeff_validate(123, 3)