X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlfaq7.pod;h=a144457de98423191582deeadcbe0cf8934aad18;hb=bea985324a3cd895f8e0a0c38e90ab3d09433415;hp=69bc17f4738267c786ba4829bbe2dbf57434a587;hpb=704c0804a967b2728151b3623fbefd13baa4f816;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlfaq7.pod b/pod/perlfaq7.pod index 69bc17f..a144457 100644 --- a/pod/perlfaq7.pod +++ b/pod/perlfaq7.pod @@ -1,6 +1,6 @@ =head1 NAME -perlfaq7 - Perl Language Issues ($Revision: 1.5 $, $Date: 2002/01/01 22:26:45 $) +perlfaq7 - General Perl Language Issues ($Revision: 1.13 $, $Date: 2003/01/26 17:45:46 $) =head1 DESCRIPTION @@ -38,7 +38,7 @@ really type specifiers: Note that is I the type specifier for files nor the name of the handle. It is the C<< <> >> operator applied to the handle FILE. It reads one line (well, record--see -L) from the handle FILE in scalar context, or I lines +L>) from the handle FILE in scalar context, or I lines in list context. When performing open, close, or any other operation besides C<< <> >> on files, or even when talking about the handle, do I use the brackets. These are correct: C, C pragma @@ -298,37 +303,21 @@ reference to an existing or anonymous variable or function: =item Passing Filehandles -To pass filehandles to subroutines, use the C<*FH> or C<\*FH> notations. -These are "typeglobs"--see L -and especially L for more information. +As of Perl 5.6, you can represent filehandles with scalar variables +which you treat as any other scalar. -Here's an excerpt: - -If you're passing around filehandles, you could usually just use the bare -typeglob, like *STDOUT, but typeglobs references would be better because -they'll still work properly under C. For example: - - splutter(\*STDOUT); - sub splutter { - my $fh = shift; - print $fh "her um well a hmmm\n"; - } + open my $fh, $filename or die "Cannot open $filename! $!"; + func( $fh ); - $rec = get_rec(\*STDIN); - sub get_rec { - my $fh = shift; - return scalar <$fh>; - } + sub func { + my $passed_fh = shift; -If you're planning on generating new filehandles, you could do this: + my $line = <$fh>; + } - sub openit { - my $path = shift; - local *FH; - return open (FH, $path) ? *FH : undef; - } - $fh = openit('< /etc/motd'); - print <$fh>; +Before Perl 5.6, you had to use the C<*FH> or C<\*FH> notations. +These are "typeglobs"--see L +and especially L for more information. =item Passing Regexes @@ -486,28 +475,38 @@ In summary, local() doesn't make what you think of as private, local variables. It gives a global variable a temporary value. my() is what you're looking for if you want private variables. -See L and +See L and L for excruciating details. =head2 How can I access a dynamic variable while a similarly named lexical is in scope? -You can do this via symbolic references, provided you haven't set -C. So instead of $var, use C<${'var'}>. +If you know your package, you can just mention it explicitly, as in +$Some_Pack::var. Note that the notation $::var is B the dynamic $var +in the current package, but rather the one in the "main" package, as +though you had written $main::var. - local $var = "global"; - my $var = "lexical"; + use vars '$var'; + local $var = "global"; + my $var = "lexical"; - print "lexical is $var\n"; + print "lexical is $var\n"; + print "global is $main::var\n"; - no strict 'refs'; - print "global is ${'var'}\n"; +Alternatively you can use the compiler directive our() to bring a +dynamic variable into the current lexical scope. -If you know your package, you can just mention it explicitly, as in -$Some_Pack::var. Note that the notation $::var is I the dynamic -$var in the current package, but rather the one in the C
-package, as though you had written $main::var. Specifying the package -directly makes you hard-code its name, but it executes faster and -avoids running afoul of C. + require 5.006; # our() did not exist before 5.6 + use vars '$var'; + + local $var = "global"; + my $var = "lexical"; + + print "lexical is $var\n"; + + { + our $var; + print "global is $var\n"; + } =head2 What's the difference between deep and shallow binding? @@ -520,7 +519,7 @@ However, dynamic variables (aka global, local, or package variables) are effectively shallowly bound. Consider this just one more reason not to use them. See the answer to L<"What's a closure?">. -=head2 Why doesn't "my($foo) = ;" work right? +=head2 Why doesn't "my($foo) = EFILEE;" work right? C and C give list context to the right hand side of C<=>. The read operation, like so many of Perl's @@ -604,7 +603,7 @@ construct like this: elsif (/pat2/) { } # do something else elsif (/pat3/) { } # do something else else { } # default - } + } Here's a simple example of a switch based on pattern matching, this time lined up in a way to make it look more like a switch statement. @@ -641,7 +640,7 @@ in $whatchamacallit: } -See C for many other +See C for many other examples in this style. Sometimes you should change the positions of the constant and the variable. @@ -659,7 +658,7 @@ C<"STOP"> here: elsif ("LIST" =~ /^\Q$answer/i) { print "Action is list\n" } elsif ("EDIT" =~ /^\Q$answer/i) { print "Action is edit\n" } -A totally different approach is to create a hash of function references. +A totally different approach is to create a hash of function references. my %commands = ( "happy" => \&joy, @@ -674,33 +673,18 @@ A totally different approach is to create a hash of function references. $commands{$string}->(); } else { print "No such command: $string\n"; - } + } -=head2 How can I catch accesses to undefined variables/functions/methods? +=head2 How can I catch accesses to undefined variables, functions, or methods? The AUTOLOAD method, discussed in L and L, lets you capture calls to undefined functions and methods. When it comes to undefined variables that would trigger a warning -under C<-w>, you can use a handler to trap the pseudo-signal -C<__WARN__> like this: - - $SIG{__WARN__} = sub { - - for ( $_[0] ) { # voici un switch statement +under C, you can promote the warning to an error. - /Use of uninitialized value/ && do { - # promote warning to a fatal - die $_; - }; - - # other warning cases to catch could go here; - - warn $_; - } - - }; + use warnings FATAL => qw(uninitialized); =head2 Why can't a method included in this same file be found? @@ -741,7 +725,8 @@ not necessarily the same as the one in which you were compiled): =head2 How can I comment out a large block of perl code? -Use embedded POD to discard it: +You can use embedded POD to discard it. The =for directive +lasts until the next paragraph (two consecutive newlines). # program is here @@ -750,6 +735,9 @@ Use embedded POD to discard it: # program continues +The =begin and =end directives can contain multiple +paragraphs. + =begin comment text all of this stuff @@ -759,11 +747,12 @@ Use embedded POD to discard it: =end comment text - =cut +The pod directives cannot go just anywhere. You must put a +pod directive where the parser is expecting a new statement, +not just in the middle of an expression or some other +arbitrary s grammar production. -This can't go just anywhere. You have to put a pod directive where -the parser is expecting a new statement, not just in the middle -of an expression or some other arbitrary yacc grammar production. +See L for more details. =head2 How do I clear a package? @@ -772,7 +761,7 @@ Use this code, provided by Mark-Jason Dominus: sub scrub_package { no strict 'refs'; my $pack = shift; - die "Shouldn't delete main package" + die "Shouldn't delete main package" if $pack eq "" || $pack eq "main"; my $stash = *{$pack . '::'}{HASH}; my $name; @@ -787,7 +776,7 @@ Use this code, provided by Mark-Jason Dominus: } } -Or, if you're using a recent release of Perl, you can +Or, if you're using a recent release of Perl, you can just use the Symbol::delete_package() function instead. =head2 How can I use a variable as a variable name? @@ -855,7 +844,7 @@ wanted to use another scalar variable to refer to those by name. $name = "fred"; $$name{WIFE} = "wilma"; # set %fred - $name = "barney"; + $name = "barney"; $$name{WIFE} = "betty"; # set %barney This is still a symbolic reference, and is still saddled with the @@ -879,7 +868,7 @@ can play around with the symbol table. For example: for my $name (@colors) { no strict 'refs'; # renege for the block *$name = sub { "@_" }; - } + } All those functions (red(), blue(), green(), etc.) appear to be separate, but the real code in the closure actually was compiled only once. @@ -892,7 +881,7 @@ you probably only want to use hard references. =head1 AUTHOR AND COPYRIGHT -Copyright (c) 1997-1999 Tom Christiansen and Nathan Torkington. +Copyright (c) 1997-2002 Tom Christiansen and Nathan Torkington. All rights reserved. This documentation is free; you can redistribute it and/or modify it