Manual

Reference

Modules

  • A • B • C • D • E
  • F • G • H • I • L
  • M • N • O • P • S
  • T • U • X

Tools

attrs

Perl 5 version 10.1 documentation
Go to top
Show page index • Show recent pages
Recently read

attrs

NAME

attrs - set/get attributes of a subroutine (deprecated)

SYNOPSIS

  1.     sub foo {
  2.         use attrs qw(locked method);
  3.         ...
  4.     }
  6.     @a = attrs::get(\&foo);

DESCRIPTION

NOTE: Use of this pragma is deprecated. Use the syntax

  1.     sub foo : locked method { }

to declare attributes instead. See also attributes.

This pragma lets you set and get attributes for subroutines. Setting attributes takes place at compile time; trying to set invalid attribute names causes a compile-time error. Calling attrs::get on a subroutine reference or name returns its list of attribute names. Notice that attrs::get is not exported. Valid attributes are as follows.

  • method

    Indicates that the invoking subroutine is a method.

  • locked

    Setting this attribute is only meaningful when the subroutine or method is to be called by multiple threads. When set on a method subroutine (i.e. one marked with the method attribute above), perl ensures that any invocation of it implicitly locks its first argument before execution. When set on a non-method subroutine, perl ensures that a lock is taken on the subroutine itself before execution. The semantics of the lock are exactly those of one explicitly taken with the lock operator immediately after the subroutine is entered.

Page index