NAME

Regex::Common::SEN -- provide regexes for Social-Economical Numbers.

SYNOPSIS

use Regex::Common qw /SEN/;

while (<>) {
    /^$RE{SEN}{USA}{SSN}$/    and  print "Social Security Number\n";
}

DESCRIPTION

Please consult the manual of Regex::Common for a general description of the works of this interface.

Do not use this module directly, but load it via Regex::Common.

$RE{SEN}{USA}{SSN}{-sep}

Returns a pattern that matches an American Social Security Number (SSN). SSNs consist of three groups of numbers, separated by a hyphen (-). This pattern only checks for a valid structure, that is, it validates whether a number is valid SSN, was a valid SSN, or maybe a valid SSN in the future. There are almost a billion possible SSNs, and about 400 million are in use, or have been in use.

If -sep=P is specified, the pattern P is used as the separator between the groups of numbers.

Under -keep (see Regex::Common):

$1

captures the entire SSN.

$2

captures the first group of digits (the area number).

$3

captures the second group of digits (the group number).

$4

captures the third group of digits (the serial number).

SEE ALSO

Regex::Common for a general description of how to use this interface.

AUTHOR

Alceu Rodrigues de Freitas Junior <glasswalk3r@yahoo.com.br>

LICENSE and COPYRIGHT

This software is copyright (c) 2024 of Alceu Rodrigues de Freitas Junior, glasswalk3r at yahoo.com.br

This file is part of regex-common project.

regex-commonis free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

regex-common is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with regex-common. If not, see (http://www.gnu.org/licenses/).

The original project [Regex::Common](https://metacpan.org/pod/Regex::Common) is licensed through the MIT License, copyright (c) Damian Conway (damian@cs.monash.edu.au) and Abigail (regexp-common@abigail.be).