Text::SuDocs - Parse and normalize SuDocs numbers
The United States Government Printing Office uses a "Superintendent of Documents (SuDocs)" classification system to uniquely identify, categorize, and sort documents it tracks. This package is used for parsing and normalizing these identifiers.
Creates a new Text::SuDocs object. Its sole argument is a scalar containing a SuDocs string.
These accessor methods are available to retrieve individual components of the SuDocs identifier.
Accessor method for retrieving the original identifier.
This method returns the normalized expression of the SuDocs string. Normalization trims off whitespace, uppercases all alphas, and removes unneeded whitespace.
This method returns the sortable expression of the SuDocs string. A sortable string is a normalized one with all the whitespace converted to underscores and all the numbers padded out with zeros. The default pad is eight digits, but this can be altered by passing in a single scalar for the pad length.
Please submit bug reports to https://github.com/ctfliblime/Text-SuDocs/issues. Pull requests with fixes and enhancements are also welcome.
http://www.access.gpo.gov/su_docs/fdlp/pubs/explain.html
This code may be distributed under the same terms as Perl itself.
Please note that these modules are not products of or supported by the employers of the various contributors to the code.
Copyright 2011 LibLime, a Division of PTFS, Inc.
Clay Fouts (cfouts@liblime.com)
1 POD Error
The following errors were encountered while parsing the POD:
=over without closing =back
To install Text::SuDocs, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Text::SuDocs
CPAN shell
perl -MCPAN -e shell install Text::SuDocs
For more information on module installation, please visit the detailed CPAN module installation guide.