PPI::Token::Prototype(3pm)

PPI::Token::Prototype3pm

A subroutine prototype descriptor

Usage

  sub ($@) prototype;

Inheritance

  PPI::Token::Prototype
  isa PPI::Token::Quote::Literal
      isa PPI::Token::Quote
          isa PPI::Token
              isa PPI::Element

Overview

Although it sort of looks like a list or condition, a subroutine prototype is a lot more like a string. Its job is to provide hints to the perl compiler on what type of arguments a particular subroutine expects, which the compiler uses to validate parameters at compile-time, and allows programmers to use the functions without explicit parameter parens.

Due to the rise of OO Perl coding, which ignores these prototypes, they are most often used to allow for constant-like things, and to "extend" the language and create things that act like keywords and core functions.

  # Create something that acts like a constant
  sub MYCONSTANT () { 10 }
  
  # Create the "any" core-looking function
  sub any (&@) { ... }
  
  if ( any { $_->cute } @babies ) {
        ...
  }

Methods

This class provides one additional method beyond those defined by the PPI::Token and PPI::Element parent classes.

prototype

The "prototype" accessor returns the actual prototype pattern, stripped of flanking parens and of all whitespace. This mirrors the behavior of the Perl "prototype" builtin function.

Note that stripping parens and whitespace means that the return of "prototype" can be an empty string.

Support

See the support section in the main module.

Releases

11 releases since Debian 4.0 (Etch); the text changed 10 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8
  6. 9
  7. 10
  8. 11
  9. 12
  10. 13
  11. Arch

Author

Adam Kennedy <[email protected]>

From perl-ppi 1.291-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.