Hydrogen::HashRef - a standard library for hashrefs
This documentation is for Hydrogen::HashRef 0.016, which is based on Sub::HandlesVia::HandlerLibrary::Hash 0.037.
Each function expects a reference to a hash as its first argument.
accessor( $hashref, $key, $value? )
Additional arguments: Str, Optional[Any].
Acts like get if given one argument, or set if given two arguments.
get
set
all( $hashref )
Returns the hash in list context.
clear( $hashref )
Empties the hash.
count( $hashref )
Returns the number of keys in the hash.
defined( $hashref, $key )
Additional arguments: Str.
Indicates whether a value exists and is defined in the hashref by its key.
delete( $hashref, $key )
Removes a value from the hashref by its key.
delete_where( $hashref, $match )
Additional arguments: CodeRef|RegexpRef.
Removes values from the hashref by matching keys against a coderef or regexp.
elements( $hashref )
exists( $hashref, $key )
Indicates whether a value exists in the hashref by its key.
for_each_key( $hashref, $coderef )
Additional arguments: CodeRef.
Function which calls the coderef for each key in the hash, passing just the key to the coderef.
for_each_pair( $hashref, $coderef )
Function which calls the coderef for each key in the hash, passing the key and value to the coderef.
for_each_value( $hashref, $coderef )
Function which calls the coderef for each value in the hash, passing just the value to the coderef.
get( $hashref, $key )
Returns a value from the hashref by its key.
is_empty( $hashref )
Returns true iff there are no keys in the hash.
keys( $hashref )
Returns the list of keys in the hash.
kv( $hashref )
Returns a list of arrayrefs, where each arrayref is a key-value pair.
reset( $hashref )
Resets the original value to its default value, or an empty hashref if it has no default.
set( $hashref, $key, $value, ... )
Given a key and value, adds the key to the hashref with the given value.
shallow_clone( $hashref )
Creates a new hashref with the same keys and values as the original.
sorted_keys( $hashref )
Returns an alphabetically sorted list of keys in the hash.
values( $hashref )
Returns the list of values in the hash.
No functions are exported by this module by default. To import them all (this is usually a bad idea), use:
use Hydrogen::HashRef -all;
To import a particular function, use:
use Hydrogen::HashRef 'clear';
To rename functions:
use Hydrogen::HashRef 'clear' => { -as => 'myfunc' };
On Perl 5.37.2+, you can import lexically:
use Hydrogen::HashRef -lexical, 'clear';
See Exporter::Tiny::Manual::Importing for more hints on importing.
Please report any bugs to http://github.com/tobyink/p5-hydrogen/issues.
Hydrogen, Hydrogen::Hash, Hydrogen::Curry::HashRef, Hydrogen::Topic::HashRef, Sub::HandlesVia::HandlerLibrary::Hash, Hash::Util.
Toby Inkster <tobyink@cpan.org>.
This software is copyright (c) 2022 by Toby Inkster.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
THIS PACKAGE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
To install Hydrogen, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Hydrogen
CPAN shell
perl -MCPAN -e shell install Hydrogen
For more information on module installation, please visit the detailed CPAN module installation guide.