summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDaniel Chetlin <daniel@chetlin.com>2000-08-03 17:22:44 -0700
committerJarkko Hietaniemi <jhi@iki.fi>2000-08-04 12:26:33 +0000
commit90fdbbb75512007b809510f03fc507ff5c145e16 (patch)
tree49ec382ac772ca6ab35d1efbd12fadd4a242db02
parent9300ef0fea165be49d88144848cf782932f9cfb9 (diff)
downloadperl-90fdbbb75512007b809510f03fc507ff5c145e16.tar.gz
Re: Array vs. List context
Message-ID: <20000804002244.A5924@ilmd.chetlin.org> p4raw-id: //depot/perl@6522
-rw-r--r--pod/perlapi.pod4
-rw-r--r--pod/perlcall.pod8
-rw-r--r--pod/perlembed.pod4
-rw-r--r--pod/perlfaq4.pod2
4 files changed, 9 insertions, 9 deletions
diff --git a/pod/perlapi.pod b/pod/perlapi.pod
index e0b7c2b4f7..4a7573babd 100644
--- a/pod/perlapi.pod
+++ b/pod/perlapi.pod
@@ -478,7 +478,7 @@ Found in file op.h
=item GIMME_V
The XSUB-writer's equivalent to Perl's C<wantarray>. Returns C<G_VOID>,
-C<G_SCALAR> or C<G_ARRAY> for void, scalar or array context,
+C<G_SCALAR> or C<G_ARRAY> for void, scalar or list context,
respectively.
U32 GIMME_V
@@ -579,7 +579,7 @@ Found in file gv.c
=item G_ARRAY
-Used to indicate array context. See C<GIMME_V>, C<GIMME> and
+Used to indicate list context. See C<GIMME_V>, C<GIMME> and
L<perlcall>.
=for hackers
diff --git a/pod/perlcall.pod b/pod/perlcall.pod
index 148b24b51b..94edd342f4 100644
--- a/pod/perlcall.pod
+++ b/pod/perlcall.pod
@@ -201,8 +201,8 @@ As with G_SCALAR, this flag has 2 effects:
=item 1.
-It indicates to the subroutine being called that it is executing in an
-array context (if it executes I<wantarray> the result will be true).
+It indicates to the subroutine being called that it is executing in a
+list context (if it executes I<wantarray> the result will be true).
=item 2.
@@ -355,7 +355,7 @@ use of this flag.
As mentioned above, you can determine the context of the currently
executing subroutine in Perl with I<wantarray>. The equivalent test
can be made in C by using the C<GIMME_V> macro, which returns
-C<G_ARRAY> if you have been called in an array context, C<G_SCALAR> if
+C<G_ARRAY> if you have been called in a list context, C<G_SCALAR> if
in a scalar context, or C<G_VOID> if in a void context (i.e. the
return value will not be used). An older version of this macro is
called C<GIMME>; in a void context it returns C<G_SCALAR> instead of
@@ -806,7 +806,7 @@ Notes
=item 1.
-We wanted array context, so G_ARRAY was used.
+We wanted list context, so G_ARRAY was used.
=item 2.
diff --git a/pod/perlembed.pod b/pod/perlembed.pod
index dce785e6c2..1787e4b2eb 100644
--- a/pod/perlembed.pod
+++ b/pod/perlembed.pod
@@ -356,7 +356,7 @@ made.
int matches(SV *string, char *pattern, AV **matches);
Given an C<SV>, a pattern, and a pointer to an empty C<AV>,
-matches() evaluates C<$string =~ $pattern> in an array context, and
+matches() evaluates C<$string =~ $pattern> in a list context, and
fills in I<matches> with the array elements, returning the number of matches found.
Here's a sample program, I<match.c>, that uses all three (long lines have
@@ -434,7 +434,7 @@ been wrapped here):
/** matches(string, pattern, matches)
**
- ** Used for matches in an array context.
+ ** Used for matches in a list context.
**
** Returns the number of matches,
** and fills in **matches with the matching substrings
diff --git a/pod/perlfaq4.pod b/pod/perlfaq4.pod
index ecbd65243e..112b1edabf 100644
--- a/pod/perlfaq4.pod
+++ b/pod/perlfaq4.pod
@@ -370,7 +370,7 @@ you can. Is that the pencil's fault? Of course it isn't.
The date and time functions supplied with Perl (gmtime and localtime)
supply adequate information to determine the year well beyond 2000
(2038 is when trouble strikes for 32-bit machines). The year returned
-by these functions when used in an array context is the year minus 1900.
+by these functions when used in a list context is the year minus 1900.
For years between 1910 and 1999 this I<happens> to be a 2-digit decimal
number. To avoid the year 2000 problem simply do not treat the year as
a 2-digit number. It isn't.