NAME
Thread::Isolate::Map - Map/link packages of one thread to many other threads.
DESCRIPTION
The idea of this module is to map a package of one thread to many other threads, saving memory through many threads.
Thread::Isolate::Map supports map for SCALAR, ARRAY, HASH, HANDLE (IO) and CODE symbols.
USAGE
use Thread::Isolate ; ## Is recomended to load it before to save memory.
use Thread::Isolate::Map ;
my $thi = Thread::Isolate->new() ;
$thi->eval(q`
package Foo ;
$FOOVAL = 0 ;
`) ;
my $thi1 = Thread::Isolate->new() ;
my $thi2 = Thread::Isolate->new() ;
$thi1->map_package('Foo',$thi) ;
$thi2->map_package('Foo',$thi) ;
$thi1->eval('$Foo::FOOVAL = 10 ;'); ## $FOOVAL is 10 now. (thi1)
$thi2->eval('$Foo::FOOVAL += 10 ;'); ## $FOOVAL is 20 now. (thi2)
$thi->eval('return $Foo::FOOVAL'); ## returns 20. (thi)As you can see in the code above all the 3 threads share the same package, and the package symbols like $FOOVAL.
METHODS
new (PACKAGE , THREAD)
Maps a local package to a thread package.
- PACKAGE
-
The package to map.
- THREAD
-
The Thread::Isolate object that has the real package.
scan_pack_entries ( THREAD? , PACKAGE , RECURSIVE )
Scan the symbol table entries of a package.
- THREAD?
-
If defined will scan the package inside the thread.
- PACKAGE
-
The package to scan.
- RECURSIVE
-
If TRUE will do a recursive scan, getting symbols of sub-packages.
Mapping HANDLEs (IO)
All the mapped HANDLEs (IO) will be automatically flushed ($| = 1), since is not possible to flush from an external thread, also will avoid lose of output data when the HANDLE is not closed explicity when the process goes out.
SEE ALSO
Thread::Isolate, Thread::Isolate::Pool.
AUTHOR
Graciliano M. P. <gmpassos@cpan.org>
I will appreciate any type of feedback (include your opinions and/or suggestions). ;-P
COPYRIGHT
This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.