noble (3) Debian::Control::Stanza::CommaSeparated.3pm.gz

NAME

       Debian::Control::Stanza::CommaSeparated - comma separated debian/control field abstraction

SYNOPSIS

           my $f = Debian::Control::Stanza::CommaSeparated->new(
               'Joe M <joem@there.not>');
           $f->add('"Smith, Agent" <asmith@hasyou.not>, Joe M <joem@there.not>');
           print $f->as_string;
               # 'Joe M <joem@there.not>, "Smith, Agent" <asmith@hasyou.not>'
           print "$f";     # the same
           $f->sort;

DESCRIPTION

       Debian::Control::Stanza::CommaSeparated abstracts handling of comma-separated list of values, often found
       in debian/control file fields like Uploaders.  Note that the various dependency fields in debian/control
       also use comma-separated values, but the Debian::Dependencies class is more suitable for these as it is
       for example also capable of finding overlapping dependency declarations.

CONSTRUCTOR

       new (initial values)
           The initial values list is parsed and may contain strings that are in fact comma-separated lists.
           These are split appropriately using Text::ParseWords' quotewords routine.

METHODS

       as_string
           Returns text representation of the list. A simple join of the elements by ", ".

           The same function is used for overloading the stringification operation.

       add @items
           Adds the given items to the list. Items that are already present are not added, keeping the list
           unique.

       sort
           A handy method for sorting the list.