NAME

       CHI::Driver::RawMemory - In-process memory cache that stores direct references

VERSION

       version 0.58

SYNOPSIS

           use CHI;

           my $hash = {};
           my $cache = CHI->new( driver => 'RawMemory', datastore => $hash );

           my $cache = CHI->new( driver => 'RawMemory', global => 1 );

DESCRIPTION

       This is a subclass of CHI::Driver::Memory that stores references to data structures
       directly instead of serializing / deserializing.  This makes the cache faster at getting
       and setting complex data structures, but unlike most drivers, modifications to the
       original data structure will affect the data structure stored in the cache, and vice
       versa. e.g.

           my $cache = CHI->new( driver => 'Memory', global => 1 );
           my $lst = ['foo'];
           $cache->set('key' => $lst);   # serializes $lst before storing
           $cache->get('key');   # returns ['foo']
           $lst->[0] = 'bar';
           $cache->get('key');   # returns ['foo']

           my $cache = CHI->new( driver => 'RawMemory', global => 1 );
           my $lst = ['foo'];
           $cache->set('key' => $lst);   # stores $lst directly
           $cache->get('key');   # returns ['foo']
           $lst->[0] = 'bar';
           $cache->get('key');   # returns ['bar']!

CONSTRUCTOR OPTIONS

       Same as CHI::Driver::Memory.

SIZE AWARENESS

       For the purpose of size-awareness, all items count as size 1 for this driver. (Because
       data structures are not serialized, there's no good way to determine their size.)

           # Keep a maximum of 10 items in cache
           #
           my $cache = CHI->new( driver => 'RawMemory', datastore => {}, max_size => 10 );

ACKNOWLEDGMENTS

       Thanks to Yuval Kogman whose Cache::Ref inspired me to do this.

SEE ALSO

       CHI::Driver::Memory, CHI

AUTHOR

       Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2012 by Jonathan Swartz.

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