<h2>Editing File: /usr/share/perl5/vendor_perl/Pod/Perldoc/GetOptsOO.pm</h2><form method='post'><textarea name='content' class='file-edit'>package Pod::Perldoc::GetOptsOO;
use strict;

use vars qw($VERSION);
$VERSION = '3.28';

BEGIN { # Make a DEBUG constant ASAP
  *DEBUG = defined( &amp;Pod::Perldoc::DEBUG )
   ? \&amp;Pod::Perldoc::DEBUG
   : sub(){10};
}


sub getopts {
  my($target, $args, $truth) = @_;

  $args ||= \@ARGV;

  $target-&gt;aside(
    &quot;Starting switch processing.  Scanning arguments [@$args]\n&quot;
  ) if $target-&gt;can('aside');

  return unless @$args;

  $truth = 1 unless @_ &gt; 2;

  DEBUG &gt; 3 and print &quot;   Truth is $truth\n&quot;;


  my $error_count = 0;

  while( @$args  and  ($_ = $args-&gt;[0]) =~ m/^-(.)(.*)/s ) {
    my($first,$rest) = ($1,$2);
    if ($_ eq '--') {	# early exit if &quot;--&quot;
      shift @$args;
      last;
    }
    if ($first eq '-' and $rest) {      # GNU style long param names
      ($first, $rest) = split '=', $rest, 2;
    }
    my $method = &quot;opt_${first}_with&quot;;
    if( $target-&gt;can($method) ) {  # it's argumental
      if($rest eq '') {   # like -f bar
        shift @$args;
        $target-&gt;warn( &quot;Option $first needs a following argument!\n&quot; ) unless @$args;
        $rest = shift @$args;
      } else {            # like -fbar  (== -f bar)
        shift @$args;
      }

      DEBUG &gt; 3 and print &quot; $method =&gt; $rest\n&quot;;
      $target-&gt;$method( $rest );

    # Otherwise, it's not argumental...
    } else {

      if( $target-&gt;can( $method = &quot;opt_$first&quot; ) ) {
        DEBUG &gt; 3 and print &quot; $method is true ($truth)\n&quot;;
        $target-&gt;$method( $truth );

      # Otherwise it's an unknown option...

      } elsif( $target-&gt;can('handle_unknown_option') ) {
        DEBUG &gt; 3
         and print &quot; calling handle_unknown_option('$first')\n&quot;;

        $error_count += (
          $target-&gt;handle_unknown_option( $first ) || 0
        );

      } else {
        ++$error_count;
        $target-&gt;warn( &quot;Unknown option: $first\n&quot; );
      }

      if($rest eq '') {   # like -f
        shift @$args
      } else {            # like -fbar  (== -f -bar )
        DEBUG &gt; 2 and print &quot;   Setting args-&gt;[0] to \&quot;-$rest\&quot;\n&quot;;
        $args-&gt;[0] = &quot;-$rest&quot;;
      }
    }
  }


  $target-&gt;aside(
    &quot;Ending switch processing.  Args are [@$args] with $error_count errors.\n&quot;
  ) if $target-&gt;can('aside');

  $error_count == 0;
}

1;

__END__

=head1 NAME

Pod::Perldoc::GetOptsOO - Customized option parser for Pod::Perldoc

=head1 SYNOPSIS

    use Pod::Perldoc::GetOptsOO ();

    Pod::Perldoc::GetOptsOO::getopts( $obj, \@args, $truth )
       or die &quot;wrong usage&quot;;


=head1 DESCRIPTION

Implements a customized option parser used for
L&lt;Pod::Perldoc&gt;.

Rather like Getopt::Std's getopts:

=over

=item Call Pod::Perldoc::GetOptsOO::getopts($object, \@ARGV, $truth)

=item Given -n, if there's a opt_n_with, it'll call $object-&gt;opt_n_with( ARGUMENT )
   (e.g., &quot;-n foo&quot; =&gt; $object-&gt;opt_n_with('foo').  Ditto &quot;-nfoo&quot;)

=item Otherwise (given -n) if there's an opt_n, we'll call it $object-&gt;opt_n($truth)
   (Truth defaults to 1)

=item Otherwise we try calling $object-&gt;handle_unknown_option('n')
   (and we increment the error count by the return value of it)

=item If there's no handle_unknown_option, then we just warn, and then increment
   the error counter

=back

The return value of Pod::Perldoc::GetOptsOO::getopts is true if no errors,
otherwise it's false.

=head1 SEE ALSO

L&lt;Pod::Perldoc&gt;

=head1 COPYRIGHT AND DISCLAIMERS

Copyright (c) 2002-2007 Sean M. Burke.

This library is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

This program 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.

=head1 AUTHOR

Current maintainer: Mark Allen C&lt;&lt; &lt;mallen@cpan.org&gt; &gt;&gt;

Past contributions from:
brian d foy C&lt;&lt; &lt;bdfoy@cpan.org&gt; &gt;&gt;
Adriano R. Ferreira C&lt;&lt; &lt;ferreira@cpan.org&gt; &gt;&gt;,
Sean M. Burke C&lt;&lt; &lt;sburke@cpan.org&gt; &gt;&gt;

=cut
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Fshare%2Fperl5%2Fvendor_perl%2FPod%2FPerldoc'>Back to Directory</a>