NAME

       Tie::ToObject - Tie to an existing object.

SYNOPSIS

               use Tie::ToObject;

               my $stolen = tied(%something);

               tie %something_else, 'Tie::ToObject', $stolen;

DESCRIPTION

       While "tie" in perldoc allows tying to an arbitrary object, the class in question must
       support this in it's implementation of "TIEHASH", "TIEARRAY" or whatever.

       This class provides a very tie constructor that simply returns the object it was given as
       it's first argument.

       This way side effects of calling "$object->TIEHASH" are avoided.

       This is used in Data::Visitor in order to tie a variable to an already existing object.
       This is also useful for cloning, when you want to clone the internal state object instead
       of going through the tie interface for that variable.

VERSION CONTROL

       This module is maintained using Darcs. You can get the latest version from
       <http://nothingmuch.woobling.org/code>, and use "darcs send" to commit changes.

AUTHOR

       Yuval Kogman <nothingmuch@woobling.org>

COPYRIGHT

               Copyright (c) 2008 Yuval Kogman. All rights reserved
               This program is free software; you can redistribute
               it and/or modify it under the same terms as Perl itself.