Lines Matching full:pod
6 #pod =head1 SYNOPSIS
7 #pod
8 #pod require 5.004;
9 #pod use Tie::RefHash;
10 #pod tie HASHVARIABLE, 'Tie::RefHash', LIST;
11 #pod tie HASHVARIABLE, 'Tie::RefHash::Nestable', LIST;
12 #pod
13 #pod untie HASHVARIABLE;
14 #pod
15 #pod =head1 DESCRIPTION
16 #pod
17 #pod This module provides the ability to use references as hash keys if you
18 #pod first C<tie> the hash variable to this module. Normally, only the
19 #pod keys of the tied hash itself are preserved as references; to use
20 #pod references as keys in hashes-of-hashes, use Tie::RefHash::Nestable,
21 #pod included as part of Tie::RefHash.
22 #pod
23 #pod It is implemented using the standard perl TIEHASH interface. Please
24 #pod see the C<tie> entry in perlfunc(1) and perltie(1) for more information.
25 #pod
26 #pod The Nestable version works by looking for hash references being stored
27 #pod and converting them to tied hashes so that they too can have
28 #pod references as keys. This will happen without warning whenever you
29 #pod store a reference to one of your own hashes in the tied hash.
30 #pod
31 #pod =head1 EXAMPLE
32 #pod
33 #pod use Tie::RefHash;
34 #pod tie %h, 'Tie::RefHash';
35 #pod $a = [];
36 #pod $b = {};
37 #pod $c = \*main;
38 #pod $d = \"gunk";
39 #pod $e = sub { 'foo' };
40 #pod %h = ($a => 1, $b => 2, $c => 3, $d => 4, $e => 5);
41 #pod $a->[0] = 'foo';
42 #pod $b->{foo} = 'bar';
43 #pod for (keys %h) {
44 #pod print ref($_), "\n";
45 #pod }
46 #pod
47 #pod tie %h, 'Tie::RefHash::Nestable';
48 #pod $h{$a}->{$b} = 1;
49 #pod for (keys %h, keys %{$h{$a}}) {
50 #pod print ref($_), "\n";
51 #pod }
52 #pod
53 #pod =head1 THREAD SUPPORT
54 #pod
55 #pod L<Tie::RefHash> fully supports threading using the C<CLONE> method.
56 #pod
57 #pod =head1 STORABLE SUPPORT
58 #pod
59 #pod L<Storable> hooks are provided for semantically correct serialization and
60 #pod cloning of tied refhashes.
61 #pod
62 #pod =head1 AUTHORS
63 #pod
64 #pod Gurusamy Sarathy <gsar@activestate.com>
65 #pod
66 #pod Tie::RefHash::Nestable by Ed Avis <ed@membled.com>
67 #pod
68 #pod =head1 SEE ALSO
69 #pod
70 #pod perl(1), perlfunc(1), perltie(1)
71 #pod
72 #pod =cut
261 =pod