MarksStoreArray class - Revision history

Alex at 19:46, 4 February 2011

2011-02-04T19:46:49Z

← Older revision		Revision as of 19:46, 4 February 2011
Line 4:		Line 4:

	However, if the items in a collection are, themselves, objects the <var>MarksStoreArray</var> cannot be used and, instead, a <var>NamedArrayList</var> should be used, with the store codes as the "names" (index values).		However, if the items in a collection are, themselves, objects the <var>MarksStoreArray</var> cannot be used and, instead, a <var>NamedArrayList</var> should be used, with the store codes as the "names" (index values).
			[[List of MarksStoreArray methods]] lists all the methods in this class.
	===Example===		===Example===
	The following example sets the value of an item associated with store code <code>ABC</code> to 22:		The following example sets the value of an item associated with store code <code>ABC</code> to 22:

Alex at 16:04, 4 February 2011

2011-02-04T16:04:54Z

← Older revision		Revision as of 16:04, 4 February 2011
Line 1:		Line 1:
	The <var>MarksStoreArray</var> class was written for [http://en.wikipedia.org/wiki/Marks_%26_Spencer Marks and Spencer] a UK retailer. The index for <var>MarksStoreArray</var> items is a a three-digit Marks and Spencer store code so is not likely to be useful to anyone other than Marks and Spencer.		The <var>MarksStoreArray</var> class was written for [http://en.wikipedia.org/wiki/Marks_%26_Spencer Marks and Spencer] a UK retailer. The index for <var>MarksStoreArray</var> items is a a three-digit Marks and Spencer store code so is not likely to be useful to anyone other than Marks and Spencer.

	The <var>MarksStoreArray</var> class is a limited collection class — the declaration of a <var>MarksStoreArray</var> variable requires an <var>Of</var> clause follow by a datatype, where the datatype can only be a <var>String</var>, <var>Float</var>, or <var>Fixed</var> datatype. As such, it is considerably less useful than the [[NamedArraylist class]]. It's main advantage over <var>NamedArraylists</var> is that all collection items are stored in STBL so that the access path for a <var>MarksStoreArray</var> object is very efficient, indeed, and so can be useful in situations where there is heavy access to lots of different string or numeric values, based on frequently changing store codes.		The <var>MarksStoreArray</var> class is a limited collection class — the declaration of a <var>MarksStoreArray</var> variable requires an <var>Of</var> clause follow by a datatype, where the datatype can only be a <var>String</var>, <var>Float</var>, or <var>Fixed</var> datatype. As such, it is considerably less useful than the [[NamedArraylist class]]. It's main advantage over <var>NamedArraylists</var> is that all collection items are stored in STBL so that the access path for a <var>MarksStoreArray</var> object is very efficient, indeed, and so can be useful in situations where there is heavy access to lots of different string or numeric values, based on frequently changing store codes.

			However, if the items in a collection are, themselves, objects the <var>MarksStoreArray</var> cannot be used and, instead, a <var>NamedArrayList</var> should be used, with the store codes as the "names" (index values).
	===Example===		===Example===
	The following example sets the value of an item associated with store code <code>ABC</code> to 22:		The following example sets the value of an item associated with store code <code>ABC</code> to 22:

Alex at 15:56, 4 February 2011

2011-02-04T15:56:06Z

@@ Line 1: / Line 1: @@
-A <var>MarksStoreArray</var> class object contains a mapping of characters to characters.
+The <var>MarksStoreArray</var> class was written for [http://en.wikipedia.org/wiki/Marks_%26_Spencer Marks and Spencer] a UK retailer. The index for <var>MarksStoreArray</var> items is a a three-digit Marks and Spencer store code so is not likely to be useful to anyone other than Marks and Spencer.
-Each character in an In string
-(the &ldquo;input table&rdquo;) is associated with, or mapped to, an individual character
+The <var>MarksStoreArray</var> class is a limited collection class &mdash; the declaration of a <var>MarksStoreArray</var> variable requires an <var>Of</var> clause follow by a datatype, where the datatype can only be a <var>String</var>, <var>Float</var>, or <var>Fixed</var> datatype. As such, it is considerably less useful than the [[NamedArraylist class]]. It's main advantage over <var>NamedArraylists</var> is that all collection items are stored in STBL so that the access path for a <var>MarksStoreArray</var> object is very efficient, indeed, and so can be useful in situations where there is heavy access to lots of different string or numeric values, based on frequently changing store codes.
 ===Example===
-Most of these methods are shown in the following example,
+The following example sets the value of an item associated with store code <code>ABC</code> to 22:
-which features the intrinsic String [[Translate (String function)|Translate]] function.
-In the example, a new CharacterMap is the argument for the Translate method;
+<p class="code">begin
-then that map is copied and modified, and the modified map is used in a
+%quantity   is collection marksStoreArray of float
-second Translate call:
-    begin
+end
-    %map is object characterMap
+</p>
 [[Category:System classes]]

PaulWebb: Created page with "A `MarksStoreArray` class object contains a mapping of characters to characters. Each character in an In string (the “input table”) is associated with, or ma..."

2011-02-01T12:22:33Z

Created page with "A <var>MarksStoreArray</var> class object contains a mapping of characters to characters. Each character in an In string (the “input table”) is associated with, or ma..."

New page

A <var>MarksStoreArray</var> class object contains a mapping of characters to characters.
Each character in an In string
(the “input table”) is associated with, or mapped to, an individual character
from an Out string (the “output table”).
The output table may be supplemented with instances of a pad character
to ensure a one-to-one mapping with the input table characters.

[[List of CharacterMap methods]] lists all the methods in this class.

CharacterMap includes a constructor, copy methods, and an update method
for modifying the map.
===Example===
Most of these methods are shown in the following example,
which features the intrinsic String [[Translate (String function)|Translate]] function.
In the example, a new CharacterMap is the argument for the Translate method;
then that map is copied and modified, and the modified map is used in a
second Translate call:

begin
%map is object characterMap
%map2 is object characterMap
%ls is longstring

%map = New(in='x-', out='!c')
%ls = 'xu--exx'
[[Targeted Text statements|printtext]] {~} = '{%ls:translate(%map)}'

%map2 = %map:Copy
%map2:Update(in='x',out='s')
printtext {~} = '{%ls:translate(%map2)}'

end

The result is:
<pre>
%ls:translate(%map) = '!ucce!!'
%ls:translate(%map2) = 'success'
</pre>

This class is new as of version 7.3 of the ''Sirius Mods''.
[[Category:System classes]]

MarksStoreArray class - Revision history

Alex at 19:46, 4 February 2011

Alex at 16:04, 4 February 2011

Alex at 15:56, 4 February 2011

PaulWebb: Created page with "A MarksStoreArray class object contains a mapping of characters to characters. Each character in an In string (the “input table”) is associated with, or ma..."

PaulWebb: Created page with "A `MarksStoreArray` class object contains a mapping of characters to characters. Each character in an In string (the “input table”) is associated with, or ma..."