This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Document differences between Tie::Scalar and Tie::StdScalar
authorAbigail <abigail@abigail.be>
Sat, 20 Feb 2010 17:54:15 +0000 (18:54 +0100)
committerAbigail <abigail@abigail.be>
Sat, 20 Feb 2010 17:54:15 +0000 (18:54 +0100)
lib/Tie/Scalar.pm

index 9bf03f9..8048569 100644 (file)
@@ -73,6 +73,18 @@ destruction of an instance.
 
 =back
 
 
 =back
 
+=head2 Tie::Scalar vs Tie::StdScalar
+
+C<< Tie::Scalar >> provides all the necessary methods, but one should realize
+they do not do anything useful. Calling C<< Tie::Scalar::FETCH >> or 
+C<< Tie::Scalar::STORE >> results in a (trappable) croak. And if you inherit
+from C<< Tie::Scalar >>, you I<must> provide either a C<< new >> or a
+C<< TIESCALAR >> method. 
+
+If you are looking for a class that does everything for you you don't
+define yourself, use the C<< Tie::StdScalar >> class, not the
+C<< Tie::Scalar >> one.
+
 =head1 MORE INFORMATION
 
 The L<perltie> section uses a good example of tying scalars by associating
 =head1 MORE INFORMATION
 
 The L<perltie> section uses a good example of tying scalars by associating