is_uk_postcode: Is the string a valid UK postcode?

Description Usage Arguments Value Note References Examples

Description

Checks that the input contains UK postcodes.

Usage

1
2
3
4
5
6
7
assert_all_are_uk_postcodes(x, na_ignore = FALSE,
  severity = getOption("assertive.severity", "stop"))

assert_any_are_uk_postcodes(x, na_ignore = FALSE,
  severity = getOption("assertive.severity", "stop"))

is_uk_postcode(x)

Arguments

x

Input to check.

na_ignore

A logical value. If FALSE, NA values cause an error; otherwise they do not. Like na.rm in many stats package functions, except that the position of the failing values does not change.

severity

How severe should the consequences of the assertion be? Either "stop", "warning", "message", or "none".

Value

is_uk_postcode returns TRUE if the input string contains a valid UK postcode. The assert_* function returns nothing but throws an error when the is_* function returns FALSE.

Note

The function doesn't guarantee that the postcode actually exists. It should correctly return TRUE for genuine postcodes, and will weed out most badly formatted strings and non-existent areas, but some non-existent districts may incorrectly return TRUE. If you need 100 check against an up-to-date postcode database.

References

Regexes taken from https://en.wikipedia.org/wiki/Postcodes_in_the_United_Kingdom#Validation.

Examples

1
2
3
4
5
postcodes <- c(
  "SW1A 1AA", "SK11 9DW", "M34FP", "Le45ns", "TS25 2BZ", "gir 0aa"
)
is_uk_postcode(postcodes)
assert_all_are_uk_postcodes(postcodes)


Search within the assertive.data.uk package
Search all R packages, documentation and source code

Questions? Problems? Suggestions? or email at ian@mutexlabs.com.

Please suggest features or report bugs with the GitHub issue tracker.

All documentation is copyright its authors; we didn't write any of that.