Hash::Case::Preserve(3) User Contributed Perl Documentation Hash::Case::Preserve(3)

Hash::Case::Preserve - hash with enforced lower cased keys

Hash::Case::Preserve
  is a Hash::Case
  is a Tie::StdHash

use Hash::Case::Preserve;
tie my(%cphash), 'Hash::Case::Preserve';
$cphash{StraNGeKeY} = 3;
print keys %cphash;         # StraNGeKeY
print $cphash{strangekey};  # 3
print $cphash{STRANGEKEY};  # 3

Hash::Case::Preserve extends Hash::Case, which lets you play various trics with hash keys. This extension implements a fake hash which is case-insentive. The keys are administered in the casing as they were used: case-insensitive but case-preserving.

Extends "DESCRIPTION" in Hash::Case.

Extends "METHODS" in Hash::Case.

Extends "Constructors" in Hash::Case.

Define %hash to be case insensitive, but case preserving. The hash is initialized with the $values, specified as ARRAY (passing flat key-value pairs) or HASH. Improves base, see "Constructors" in Hash::Case 
-Option--Default
 keep    'LAST'
Which casing is the preferred casing? The FIRST appearance or the LAST. Only stores will affect the casing, deletes will undo the definition. Defaults to LAST, which is slightly faster.

Extends "Hidden object access" in Hash::Case.

$obj->addHashData(\%data)
Inherited, see "Hidden object access" in Hash::Case
$obj->addPairs(@pairs)
Inherited, see "Hidden object access" in Hash::Case
$obj->setHash(\%data)
Inherited, see "Hidden object access" in Hash::Case

This module is part of Hash-Case version 1.07, built on January 26, 2026. Website: http://perl.overmeer.net/CPAN/

For contributors see file ChangeLog.

This software is copyright (c) 2002-2026 by Mark Overmeer.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

2026-02-05 perl v5.42.0