Skeleton Tie::Array

p4raw-id: //depot/ansiperl@419

1 files changed, 40 insertions, 0 deletions

diff --git a/lib/Tie/Array.pm b/lib/Tie/Array.pm
new file mode 100644
index 0000000000..c3ddfa9a8a
--- /dev/null
+++ b/lib/Tie/Array.pm
@@ -0,0 +1,40 @@
+package Tie::Array; 
+
+# No content yet - just pod skeleton.
+
+1;
+
+__END__
+
+=head1 NAME
+
+Tie::Array - base class for tied arrays
+
+=head1 SYNOPSIS  
+
+    use Tie::Array;
+    @ISA = 'Tie::Array';
+
+    sub SIZE  { ... } 
+    sub FETCH { ... } 
+    sub STORE { ... } 
+    sub CLEAR { ... } 
+    sub PUSH { ... } 
+    sub POP { ... } 
+    sub SHIFT { ... } 
+    sub UNSHIFT { ... } 
+    sub SPLICE { ... } 
+
+=head1 DESCRIPTION       
+
+This module provides some skeletal methods for array-tying classes.
+
+
+=head1 CAVEATS
+
+There is no support at present for tied @ISA. There is a potential conflict 
+between magic entries needed to notice setting of @ISA, and those needed to
+implement 'tie'. 
+
+=cut 
+