foo
[gitmo/Moose-Autobox.git] / lib / Moose / Autobox / Hash.pm
1 package Moose::Autobox::Hash;
2 use Moose::Role 'with';
3
4 our $VERSION = '0.01';
5
6 with 'Moose::Autobox::Ref',
7      'Moose::Autobox::Indexed';
8
9 sub delete { 
10     my ($hash, $key) = @_;
11     CORE::delete $hash->{$key}; 
12 }
13
14 # ::Indexed implementation
15
16 sub at {
17     my ($hash, $index) = @_;
18     $hash->{$index};
19
20
21 sub put {
22     my ($hash, $index, $value) = @_;
23     $hash->{$index} = $value;
24 }
25
26 sub exists { 
27     my ($hash, $key) = @_;
28     CORE::exists $hash->{$key}; 
29 }
30
31 sub keys { 
32     my ($hash) = @_;
33     [ CORE::keys %$hash ];
34 }
35
36 sub values { 
37     my ($hash) = @_;    
38     [ CORE::values %$hash ]; 
39 }
40
41 sub kv {
42     my ($hash) = @_;    
43     [ CORE::map { [ $_, $hash->{$_} ] } CORE::keys %$hash ];    
44 }
45
46 1;
47
48 __END__
49
50 =pod
51
52 =head1 NAME 
53
54 Moose::Autobox::Hash - the Hash role
55
56 =head1 SYNOPOSIS
57
58   use Moose::Autobox;
59   use autobox;
60   
61   { one => 1, two => 2 }->keys->join(', ')->print; # prints 'one, two'
62
63 =head1 DESCRIPTION
64
65 =head1 METHODS
66
67 =over 4
68
69 =item B<meta>
70
71 =item B<delete>
72
73 =back
74
75 =head2 Indexed
76
77 =over 4
78
79 =item B<at>
80
81 =item B<put>
82
83 =item B<exists>
84
85 =item B<keys>
86
87 =item B<values>
88
89 =item B<kv>
90
91 =back
92
93 =head1 BUGS
94
95 All complex software has bugs lurking in it, and this module is no 
96 exception. If you find a bug please either email me, or add the bug
97 to cpan-RT.
98
99 =head1 AUTHOR
100
101 Stevan Little E<lt>stevan@iinteractive.comE<gt>
102
103 =head1 COPYRIGHT AND LICENSE
104
105 Copyright 2006 by Infinity Interactive, Inc.
106
107 L<http://www.iinteractive.com>
108
109 This library is free software; you can redistribute it and/or modify
110 it under the same terms as Perl itself.
111
112 =cut