Author: leo
Date: Thu Sep 28 01:39:18 2006
New Revision: 14781
Modified:
trunk/docs/pdds/clip/pddXX_cstruct.pod
Log:
pddXX_cstruct - clarify a few items
Modified: trunk/docs/pdds/clip/pddXX_cstruct.pod
==============================================================================
--- trunk/docs/pdds/clip/pddXX_cstruct.pod (original)
+++ trunk/docs/pdds/clip/pddXX_cstruct.pod Thu Sep 28 01:39:18 2006
@@ -97,7 +97,7 @@
char "b";
DEF
-The generalization of arbitrary attribute names would of course be
+The generalization of quoted attribute names would of course be
possible too, but isn't likely needed.
=head2 Syntax variant
@@ -139,13 +139,13 @@
bar_cs = subclass 'CStruct', 'bar'
addattribute(s) bar_cs, <<'DEF'
double x;
- foo foo; # the foo class is already defined
- foo *fptr;
+ foo cfoo; # contained foo structure
+ foo *fptr; # a pointer to a foo struct
DEF
o = new 'bar'
- setattribute o, 'x', 3.14
- setattribute o, ['foo'; 'a'], 4711 # o.foo.a = 4711
- setattribute o, ['fptr'; 'b'], 255
+ setattribute o, 'x', 3.14 # C-ish equivalent:
+ setattribute o, ['cfoo'; 'a'], 4711 # o.foo.a = 4711
+ setattribute o, ['fptr'; 'b'], 255 # o.fptr->b = 255
Attribute access is similar to current *ManagedStruct's hash syntax
but with a syntax matching ParrotObjects.
@@ -158,6 +158,8 @@
char b[100];
DEF
+Access to array elements automatically does bounds checking.
+
=head2 Possible future extemsios
cs = subclass 'CStruct', 'todo'
