<h2>Editing File: /usr/local/cpanel/3rdparty/perl/542/cpanel-lib/PPI/Token/Attribute.pm</h2><form method='post'><textarea name='content' class='file-edit'>package PPI::Token::Attribute;

=pod

=head1 NAME

PPI::Token::Attribute - A token for a subroutine attribute

=head1 INHERITANCE

  PPI::Token::Attribute
  isa PPI::Token
      isa PPI::Element

=head1 DESCRIPTION

In Perl, attributes are a relatively recent addition to the language.

Given the code C&lt; sub foo : bar(something) {} &gt;, the C&lt;bar(something)&gt;
part is the attribute.

A C&lt;PPI::Token::Attribute&gt; token represents the entire of the attribute,
as the braces and its contents are not parsed into the tree, and are
treated by Perl (and thus by us) as a single string.

=head1 METHODS

This class provides some additional methods beyond those provided by its
L&lt;PPI::Token&gt; and L&lt;PPI::Element&gt; parent classes.

=cut

use strict;
use PPI::Token ();

our $VERSION = '1.279';

our @ISA = &quot;PPI::Token&quot;;


#####################################################################
# PPI::Token::Attribute Methods

=pod

=head2 identifier

The C&lt;identifier&gt; attribute returns the identifier part of the attribute.

That is, for the attribute C&lt;foo(bar)&gt;, the C&lt;identifier&gt; method would
return C&lt;&quot;foo&quot;&gt;.

=cut

sub identifier {
	my $self = shift;
	$self-&gt;{content} =~ /^(.+?)\(/ ? $1 : $self-&gt;{content};
}

=pod

=head2 parameters

The C&lt;parameters&gt; method returns the parameter string for the attribute.

That is, for the attribute C&lt;foo(bar)&gt;, the C&lt;parameters&gt; method would
return C&lt;&quot;bar&quot;&gt;.

Returns the parameters as a string (including the null string C&lt;''&gt; for
the case of an attribute such as C&lt;foo()&gt;.)

Returns C&lt;undef&gt; if the attribute does not have parameters.

=cut

sub parameters {
	my $self = shift;
	$self-&gt;{content} =~ /\((.*)\)$/ ? $1 : undef;
}


#####################################################################
# Tokenizer Methods

sub __TOKENIZER__on_char {
	my $class = shift;
	my $t     = shift;
	my $char  = substr( $t-&gt;{line}, $t-&gt;{line_cursor}, 1 );

	# Unless this is a '(', we are finished.
	unless ( $char eq '(' ) {
		# Finalise and recheck
		return $t-&gt;_finalize_token-&gt;__TOKENIZER__on_char( $t );
	}

	# This is a bar(...) style attribute.
	# We are currently on the ( so scan in until the end.
	# We finish on the character AFTER our end
	my $string = $class-&gt;__TOKENIZER__scan_for_end( $t );
	if ( ref $string ) {
		# EOF
		$t-&gt;{token}-&gt;{content} .= $$string;
		$t-&gt;_finalize_token;
		return 0;
	}

	# Found the end of the attribute
	$t-&gt;{token}-&gt;{content} .= $string;
	$t-&gt;_finalize_token-&gt;__TOKENIZER__on_char( $t );
}

# Scan for a close braced, and take into account both escaping,
# and open close bracket pairs in the string. When complete, the
# method leaves the line cursor on the LAST character found.
sub __TOKENIZER__scan_for_end {
	my $t = $_[1];

	# Loop as long as we can get new lines
	my $string = '';
	my $depth = 0;
	while ( exists $t-&gt;{line} ) {
		# Get the search area
		pos $t-&gt;{line} = $t-&gt;{line_cursor};

		# Look for a match
		unless ( $t-&gt;{line} =~ /\G((?:\\.|[^()])*?[()])/gc ) {
			# Load in the next line and push to first character
			$string .= substr( $t-&gt;{line}, $t-&gt;{line_cursor} );
			$t-&gt;_fill_line(1) or return \$string;
			$t-&gt;{line_cursor} = 0;
			next;
		}

		# Add to the string
		$string .= $1;
		$t-&gt;{line_cursor} += length $1;

		# Alter the depth and continue if we aren't at the end
		$depth += ($1 =~ /\($/) ? 1 : -1 and next;

		# Found the end
		return $string;
	}

	# Returning the string as a reference indicates EOF
	\$string;
}

1;

=pod

=head1 SUPPORT

See the L&lt;support section|PPI/SUPPORT&gt; in the main module.

=head1 AUTHOR

Adam Kennedy E&lt;lt&gt;adamk@cpan.orgE&lt;gt&gt;

=head1 COPYRIGHT

Copyright 2001 - 2011 Adam Kennedy.

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

The full text of the license can be found in the
LICENSE file included with this module.

=cut
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Fcpanel%2F3rdparty%2Fperl%2F542%2Fcpanel-lib%2FPPI%2FToken'>Back to Directory</a>