README
1This is the README file for Tie::IxHash, the Perl module that
2implements ordered in-memory associative arrays.
3
4It requires:
5 Perl Version 5.005 or later.
6
7If you have been led to believe that associative arrays in perl
8don't preserve order, and if you have ever craved for that feature,
9this module is for you. Simply declare a "tie" for the hash variable
10that you want to be order-preserving, and forget that limitation
11ever existed. You can do other nifty things with the tied hash object
12that you may be used to doing with arrays, like Push(), Pop() and
13Splice().
14
15If you don't know what "tie" means, you should look at the
16perltie(1) manpage in a recent perl distribution, or in the
17index of one of the numerous books on perl.
18
19If you don't know what "perl" is, you don't need this software.
20
21See the embedded documentation in the module file for details.
22
23Don't forget to send your comments!
24
25 - Sarathy.
26 gsar@umich.edu
27
28-----------
29
30Installation:
31
32 perl Makefile.PL
33 make install
34
35If you run into problems due to whatever reason in running the above,
36simply move the file IxHash.pm over into $PERL5LIB/Tie/IxHash.pm (where
37$PERL5LIB stands for the place where your standard perl library files
38are located) and you'll be okay.
39
40