Manual

- Overview
- Tutorials
- FAQs
- History / Changes
- License

Reference

- Language
- Functions
- Operators
- Special Variables
- Pragmas
- Utilities
- Internals
- Platform Specific

Modules

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

News / Blogs

- Perl Buzz
- Perl Iron Man
- Perlsphere
- Planet Perl
- TPF news
- Use Perl

See also

- CPAN
- Perl.org
- Perl.com
- Perl 5 Wiki
- Perl Jobs
- Perl Mongers
- Perl Monks

Contact

- Site designed and maintained by Jon Allen (JJ)
- http://perl.jonallen.info

- View the project page and FAQs

# wantarray

Perl 5 version 10.1 documentation
Go to top

# wantarray

Perl functions A-Z | Perl functions by category | The 'perlfunc' manpage

- wantarray

  Returns true if the context of the currently executing subroutine or `eval` is looking for a list value. Returns false if the context is looking for a scalar. Returns the undefined value if the context is looking for no value (void context).

          return unless defined wantarray;	# don't bother doing more    my @a = complex_calculation();    return wantarray ? @a : "@a";

  `wantarray()`'s result is unspecified in the top level of a file, in a `BEGIN` , `UNITCHECK` , `CHECK` , `INIT` or `END` block, or in a `DESTROY` method.

  This function should have been named wantlist() instead.

Recently read

Tools

- Preferences