warnings::method - Produces warnings if methods are called as functions
This document describes warnings::method version 0.10
use warnings::method; # installs the check routine lexically use warnings::method -global; # or installs it globally use warnings 'syntax'; # enables the check routine package Foo; sub bar :method{ # ... } Foo->bar(); # OK # the following cases warnings "Method Foo::bar() called as a function" Foo::bar(); # WARN my $method_ref = \&Foo::bar; # WARN sub f{ goto &Foo::bar; # WARN }
You shouldn't call a method as a function, e.g. UNIVERSAL::isa($o, 'ARRAY'). It's considered harmful, because such code doesn't call overridden methods in any classes. This pragmatic module produces warnings if methods are called as functions. Here, methods are subroutines declared with the :method attribute.
UNIVERSAL::isa($o, 'ARRAY')
This module scans the compiled syntax tree, checks function calls and produces warnings when dangerous function calls are detected. All the processes finish in compile time, so this module has no effect on run-time behavior.
The UNIVERSAL::isa and UNIVERSAL::can distributions are modules based on the same concept, but they produce warnings at run time.
UNIVERSAL::isa
UNIVERSAL::can
use warnings::method
use warnings::method -lexical
Installs the method check routine with lexical scope.
method
Note that the lexicality is limited before 5.10.0.
use warnings::method -global
Installs the method check routine with global scope, where this pragma checks all programs.
use/no warnings 'syntax';
Enables/Disables the method check routine.
Note that the syntax warning is defined by default, so you can always use it even if warnings::method is not loaded.
syntax
warnings::method
Perl 5.8.1 or later, and a C compiler.
No bugs have been reported.
Please report any bugs or feature requests to bug-warnings-method@rt.cpan.org/, or through the web interface at http://rt.cpan.org/.
bug-warnings-method@rt.cpan.org/
UNIVERSAL.
UNIVERSAL::isa.
UNIVERSAL::can.
perllexwarn.
warnings::unused.
Goro Fuji <gfuji(at)cpan.org>
Copyright (c) 2008, Goro Fuji <gfuji(at)cpan.org>. Some rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install warnings::method, copy and paste the appropriate command in to your terminal.
cpanm
cpanm warnings::method
CPAN shell
perl -MCPAN -e shell install warnings::method
For more information on module installation, please visit the detailed CPAN module installation guide.