Gecko [ www.vortexaion.com ]

Name	Size	Permission	Date
Number	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Quote	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
QuoteLike	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
Regexp	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
_QuoteEngine	[ DIR ]	drwxrwxrwx	2024-07-26 17:38
ArrayIndex.pm	1.33 KB	-rw-rw-rw-	2019-07-09 19:15
Attribute.pm	3.74 KB	-rw-rw-rw-	2019-07-09 19:15
BOM.pm	2.46 KB	-rw-rw-rw-	2019-07-09 19:15
Cast.pm	1.7 KB	-rw-rw-rw-	2019-07-09 19:15
Comment.pm	3.36 KB	-rw-rw-rw-	2019-07-09 19:15
DashedWord.pm	1.93 KB	-rw-rw-rw-	2019-07-09 19:15
Data.pm	1.93 KB	-rw-rw-rw-	2019-07-09 19:15
End.pm	2.39 KB	-rw-rw-rw-	2019-07-09 19:15
HereDoc.pm	8.79 KB	-rw-rw-rw-	2019-07-09 19:15
Label.pm	1.08 KB	-rw-rw-rw-	2019-07-09 19:15
Magic.pm	5.57 KB	-rw-rw-rw-	2019-07-09 19:15
Number.pm	3.21 KB	-rw-rw-rw-	2019-07-09 19:15
Operator.pm	2.9 KB	-rw-rw-rw-	2019-07-09 19:15
Pod.pm	3.03 KB	-rw-rw-rw-	2019-07-09 19:15
Prototype.pm	2.47 KB	-rw-rw-rw-	2019-07-09 19:15
Quote.pm	2.43 KB	-rw-rw-rw-	2019-07-09 19:15
QuoteLike.pm	1.59 KB	-rw-rw-rw-	2019-07-09 19:15
Regexp.pm	2.48 KB	-rw-rw-rw-	2019-07-09 19:15
Separator.pm	1.29 KB	-rw-rw-rw-	2019-07-09 19:15
Structure.pm	4.7 KB	-rw-rw-rw-	2019-07-09 19:15
Symbol.pm	5.24 KB	-rw-rw-rw-	2019-07-09 19:15
Unknown.pm	12.33 KB	-rw-rw-rw-	2019-07-09 19:15
Whitespace.pm	11.72 KB	-rw-rw-rw-	2019-07-09 19:15
Word.pm	9.13 KB	-rw-rw-rw-	2019-07-09 19:15
_QuoteEngine.pm	5.86 KB	-rw-rw-rw-	2019-07-09 19:15

Rename

package PPI::Token::Number;

=pod

=head1 NAME

PPI::Token::Number - Token class for a number

=head1 SYNOPSIS

$n = 1234;       # decimal integer
  $n = 0b1110011;  # binary integer
  $n = 01234;      # octal integer
  $n = 0x1234;     # hexadecimal integer
  $n = 12.34e-56;  # exponential notation ( currently not working )

=head1 INHERITANCE

PPI::Token::Number
  isa PPI::Token
      isa PPI::Element

=head1 DESCRIPTION

The C<PPI::Token::Number> class is used for tokens that represent numbers,
in the various types that Perl supports.

=head1 METHODS

=cut

use strict;
use PPI::Token ();

our $VERSION = '1.270'; # VERSION

our @ISA = "PPI::Token";

=pod

=head2 base

The C<base> method is provided by all of the ::Number subclasses.
This is 10 for decimal, 16 for hexadecimal, 2 for binary, etc.

=cut

sub base() { 10 }

=pod

=head2 literal

Return the numeric value of this token.

=cut

sub literal {
	return 0 + $_[0]->_literal;
}

sub _literal {
	# De-sugar the string representation
	my $self   = shift;
	my $string = $self->content;
	$string =~ s/^\+//;
	$string =~ s/_//g;
	return $string;
}

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

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

# Allow underscores straight through
	return 1 if $char eq '_';

# Handle the conversion from an unknown to known type.
	# The regex covers "potential" hex/bin/octal number.
	my $token = $t->{token};
	if ( $token->{content} =~ /^-?0_*$/ ) {
		# This could be special
		if ( $char eq 'x' || $char eq 'X' ) {
			$t->{class} = $t->{token}->set_class( 'Number::Hex' );
			return 1;
		} elsif ( $char eq 'b' || $char eq 'B' ) {
			$t->{class} = $t->{token}->set_class( 'Number::Binary' );
			return 1;
		} elsif ( $char =~ /\d/ ) {
			# You cannot have 8s and 9s on octals
			if ( $char eq '8' or $char eq '9' ) {
				$token->{_error} = "Illegal character in octal number '$char'";
			}
			$t->{class} = $t->{token}->set_class( 'Number::Octal' );
			return 1;
		}
	}

# Handle the easy case, integer or real.
	return 1 if $char =~ /\d/o;

if ( $char eq '.' ) {
		$t->{class} = $t->{token}->set_class( 'Number::Float' );
		return 1;
	}
	if ( $char eq 'e' || $char eq 'E' ) {
		$t->{class} = $t->{token}->set_class( 'Number::Exp' );
		return 1;
	}

# Doesn't fit a special case, or is after the end of the token
	# End of token.
	$t->_finalize_token->__TOKENIZER__on_char( $t );
}

=pod

=head1 CAVEATS

Compared to Perl, the number tokenizer is too liberal about allowing
underscores anywhere.  For example, the following is a syntax error in
Perl, but is allowed in PPI:

0_b10

=head1 TO DO

- Treat v-strings as binary strings or barewords, not as "base-256"
  numbers

- Break out decimal integers into their own subclass?

- Implement literal()

=head1 SUPPORT

See the L<support section|PPI/SUPPORT> in the main module.

=head1 AUTHOR

Adam Kennedy E<lt>adamk@cpan.orgE<gt>

=head1 COPYRIGHT

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