NAME

X500::DN::Marpa::RDN - Backcompat module to emulate the RDN part of X500::DN

Synopsis

See "Synopsis" in X500::DN::Marpa::DN.

Description

X500::DN::Marpa::RDN provides a Marpa::R2-based parser for parsing X.500 Relative Distinguished Names.

This module emulates the RDN parts of X500::DN.

Actually, objects of type X500::DN::Marpa::RDN are returned by "getRDN($n)" in X500::DN::Marpa::DN, so you may not need to use this module directly at all.

But if you do create such an object directly, you must call $rdn -> parse($an_rdn) before calling any other methods.

See also X500::DN::Marpa and X500::DN::Marpa::DN.

Distributions

This module is available as a Unix-style distro (*.tgz).

See http://savage.net.au/Perl-modules/html/installing-a-module.html for help on unpacking and installing distros.

Installation

Install X500::DN::Marpa as you would any Perl module:

Run:

        cpanm X500::DN::Marpa

or run:

        sudo cpan X500::DN::Marpa

or unpack the distro, and then either:

        perl Build.PL
        ./Build
        ./Build test
        sudo ./Build install

or:

        perl Makefile.PL
        make (or dmake or nmake)
        make test
        make install

Constructor and Initialization

new() is called as my($parser) = X500::DN::Marpa::RDN -> new(k1 => v1, k2 => v2, ...).

It returns a new object of type X500::DN::Marpa::RDN.

Key-value pairs accepted in the parameter list (see corresponding methods for details:

o (None)

Methods

This module is a subclass of X500::DN::Marpa and shares all its options to new(), and all its methods. See "Constructor and Initialization" in X500::DN::Marpa and "Methods" in X500::DN::Marpa.

Further, it has these methods:

getAttributeTypes()

In scalar context, returns the number of types in the RDN passed in to "parse([$string])" in X500::DN::Marpa.

In list context, returns all those types.

getAttributeValue($key)

In scalar context, returns the number of values in the RDN passed in to "parse([$string])" in X500::DN::Marpa, whose type matches $key.

In list context, returns all those values.

new()

See "Constructor and Initialization" for details on the parameters accepted by "new()".

FAQ

See "FAQ" in X500::DN::Marpa::DN and "FAQ" in X500::DN::Marpa.

References

See "References" in X500::DN::Marpa.

See Also

X500::DN::Marpa.

X500::DN::Marpa::DN.

X500::DN.

Machine-Readable Change Log

The file Changes was converted into Changelog.ini by Module::Metadata::Changes.

Version Numbers

Version numbers < 1.00 represent development versions. From 1.00 up, they are production versions.

Repository

https://github.com/ronsavage/X500-DN-Marpa

Support

Email the author, or log a bug on RT:

https://rt.cpan.org/Public/Dist/Display.html?Name=X500::DN::Marpa.

Author

X500::DN::Marpa was written by Ron Savage <ron@savage.net.au> in 2015.

Marpa's homepage: http://savage.net.au/Marpa.html.

My homepage: http://savage.net.au/.

Copyright

Australian copyright (c) 2015, Ron Savage.

        All Programs of mine are 'OSI Certified Open Source Software';
        you can redistribute them and/or modify them under the terms of
        The Artistic License 2.0, a copy of which is available at:
        http://opensource.org/licenses/alphabetical.

cpanm X500::DN::Marpa

perl -MCPAN -e shell
install X500::DN::Marpa