diff options
| author | Jeff Pinyan <japhy@pobox.com> | 2001-03-08 08:18:55 -0500 |
|---|---|---|
| committer | Jarkko Hietaniemi <jhi@iki.fi> | 2001-03-09 01:16:51 +0000 |
| commit | be16fac9c9469295c8c71e007edeeaf65dd86c84 (patch) | |
| tree | 0dedd66ab59128eafc53f53bd4829091323943b3 /pod/perldata.pod | |
| parent | 3bd709b1a63d554f3d98d5394be78ed628eb46da (diff) | |
| download | perl-be16fac9c9469295c8c71e007edeeaf65dd86c84.tar.gz | |
perldata.pod here-doc docs
Message-ID: <Pine.GSO.4.21.0103081317530.20957-100000@crusoe.crusoe.net>
p4raw-id: //depot/perl@9083
Diffstat (limited to 'pod/perldata.pod')
| -rw-r--r-- | pod/perldata.pod | 31 |
1 files changed, 24 insertions, 7 deletions
diff --git a/pod/perldata.pod b/pod/perldata.pod index 1744ff7fc9..315f716ed8 100644 --- a/pod/perldata.pod +++ b/pod/perldata.pod @@ -413,20 +413,20 @@ string may be either an identifier (a word), or some quoted text. If quoted, the type of quotes you use determines the treatment of the text, just as in regular quoting. An unquoted identifier works like double quotes. There must be no space between the C<< << >> and -the identifier. (If you put a space it will be treated as a null -identifier, which is valid, and matches the first empty line.) The -terminating string must appear by itself (unquoted and with no -surrounding whitespace) on the terminating line. +the identifier, unless the identifier is quoted. (If you put a space it +will be treated as a null identifier, which is valid, and matches the first +empty line.) The terminating string must appear by itself (unquoted and +with no surrounding whitespace) on the terminating line. print <<EOF; The price is $Price. EOF - print <<"EOF"; # same as above + print << "EOF"; # same as above The price is $Price. EOF - print <<`EOC`; # execute commands + print << `EOC`; # execute commands echo hi there echo lo there EOC @@ -437,7 +437,7 @@ surrounding whitespace) on the terminating line. I said bar. bar - myfunc(<<"THIS", 23, <<'THAT'); + myfunc(<< "THIS", 23, <<'THAT'); Here's a line or two. THIS @@ -478,6 +478,23 @@ you have to write the other E +If the terminating identifier is on the last line of the program, you +must be sure there is a newline after it; otherwise, Perl will give the +warning B<Can't find string terminator "END" anywhere before EOF...>. + +Additionally, the quoting rules for the identifier are not related to +Perl's quoting rules -- C<q()>, C<qq()>, and the like are not supported +in place of C<''> and C<"">, and the only interpolation is for backslashing +the quoting character: + + print << "abc\"def"; + testing... + abc"def + +Finally, quoted strings cannot span multiple lines. The general rule is +that the identifier must be a string literal. Stick with that, and you +should be safe. + =head2 List value constructors List values are denoted by separating individual values by commas |