Changes between Version 3 and Version 4 of Property

Timestamp:

05/07/12 06:40:06 (13 years ago)

Author:

hopscc

Comment:

--

Property

@@ -3 +3 @@
 They are accessed using the same syntax as fields but do not designate storage locations.[[BR]]
 Instead, properties have accessors that read, write, or compute their values.[[BR]]
-Values can be reflected directly (or indirectly (filtered)) in or out of a backing variable or computed, Its entirely up to the accessor.
+Values can be reflected directly (or indirectly (filtered)) in or out of a backing variable or computed, It's entirely up to the accessor.
 
 There are 3 keywords for defining a property:[[BR]]
@@ -22 +22 @@
 {{{
 #!cobra
-var _nLife  = 47       # protected access
+var _nLife  = 47       # backing variable with (implicit) protected access
 pro nLife from var     # property nLife uses backing var _nLife
-# above same as 
+# above line same as 
 pro nLife  from _nLife
-# but can use a different backing variable name from property name
+# but can use a different backing variable name from the property name
 pro numLife from _nLife
 
-# or use a backing variable with different (shortcutted) accessability
+# or use a backing variable with different (also shortcutted) accessability
 var __nLife0 = 48   # private access
 
+pro nLife0 from var # use protected or private backing variable of same name
+#or alternatively property and backing variable explicitly named
 pro nLife from __nLife0
 }}}
 
-Can implicitly create (a protected) initialised backing variable and property in one line like
+You can implicitly create (a protected) initialised backing variable and property in one line like
 {{{
 #!cobra
@@ -42 +44 @@
 # or explicitly specifying type and initial value
 pro nLife from var as int = 47
+
+# More commonly perhaps a set or get variant can be given in the same manner
+## (assume above prop dcls not made, any one of below is also valid)
+get nLife from var
+get nlifeSource from nLife
+
+set nLife from var   # name same as backing variable
+set nLifeSink from nlife  # any name same or unrelated to backing variable
 }}}
 
 Finally if an accessor needs to translate, filter or modify in some way a backing variable or provide a virtual variable (computed)[[BR]]
 there is a longer syntax variant where either of both the '''get''' and '''set''' accessors can be specified with a block of code to[[BR]]
-store (setter) or generate (getter) the property value. 
+store (setter) or generate (getter) the property value.
+
+Within the setter code block in such a variant an implicit parameter (of the same type as the property) named '''value'''[[BR]]
+is provided that has the value passed or assigned to the property. 
 
 {{{
@@ -57 +70 @@
         return 70 - _seed
    set
+        # implicit parameter 'value' contains the value given to set into the property 
         require value >0 and value <65
         _seed = value
 }}}
 
-Properties can have Attributes and the default [wiki:accessModifiers access modifiers] can be overridden explicitly if desired.
+Properties can have Attributes and the default [wiki:AccessModifiers access modifiers] can be overridden explicitly if desired.
 
 !DocStrings describing the property are both allowed and encouraged.