PPI::Token::Quote - String quote abstract base class


PPI documentation Contained in the PPI distribution.

Index


Code Index:

NAME

Top

PPI::Token::Quote - String quote abstract base class

INHERITANCE

Top

  PPI::Token::Quote
  isa PPI::Token
      isa PPI::Element

DESCRIPTION

Top

The PPI::Token::Quote class is never instantiated, and simply provides a common abstract base class for the four quote classes. In PPI, a "quote" is limited to only the quote-like things that themselves directly represent a string. (although this includes double quotes with interpolated elements inside them).

The subclasses of PPI::Token::Quote are:

'' - PPI::Token::Quote::Single
q{} - PPI::Token::Quote::Literal
"" - PPI::Token::Quote::Double
qq{} - PPI::Token::Quote::Interpolate

The names are hopefully obvious enough not to have to explain what each class is here. See their respective pages for more details.

Please note that although the here-doc does represent a literal string, it is such a nasty piece of work that in PPI it is given the honor of its own token class (PPI::Token::HereDoc).

METHODS

Top

string

The string method is provided by all four ::Quote classes. It won't get you the actual literal Perl value, but it will strip off the wrapping of the quotes.

  # The following all return foo from the ->string method
  'foo'
  "foo"
  q{foo}
  qq <foo>

literal

The literal method is provided by ::Quote:Literal and ::Quote::Single. This returns the value of the string as Perl sees it: without the quote marks and with \\ and \' resolved to \ and '.

The literal method is not implemented by ::Quote::Double or ::Quote::Interpolate yet.

SUPPORT

Top

See the support section in the main module.

AUTHOR

Top

Adam Kennedy <adamk@cpan.org>

COPYRIGHT

Top


PPI documentation Contained in the PPI distribution.
package PPI::Token::Quote;

use strict;
use PPI::Token ();

use vars qw{$VERSION @ISA};
BEGIN {
	$VERSION = '1.215';
	@ISA     = 'PPI::Token';
}





#####################################################################
# PPI::Token::Quote Methods

#sub string {
#	my $class = ref $_[0] || $_[0];
#	die "$class does not implement method ->string";
#}

1;