MaxItemLength (Stringlist property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
m (minor cleanup)
 
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:Stringlist:MaxItemLength subtitle}}
{{Template:Stringlist:MaxItemLength subtitle}}


Under <var class="product">Sirius Mods</var> Version 6.5, this method returns the maximum <var>stringlist</var> item length. Under <var class="product">Sirius Mods</var> Version 6.6, this method returns the part of a <var>stringlist</var> item that is on the first CCATEMP page of the item. While items can be considerably longer than this (up to 2**31-1 bytes), this limit still affects some methods. For example, the <var>[[Locate and LocateUp (Stringlist functions)|Locate]]</var> and <var>[[Locate and LocateUp (Stringlist functions)|LocateUp]]</var> will not search beyond the <var>MaxItemLength</var> column in a <var>stringlist</var> item.
This method returns the maximum length of the part of a <var>Stringlist</var> item that is on the first CCATEMP page of the item. While items can be considerably longer than this (up to 2**31-1 bytes), this limit still affects some methods. For example, the <var>[[Locate and LocateUp (Stringlist functions)|Locate]]</var> and <var>[[Locate and LocateUp (Stringlist functions)|LocateUp]]</var> functions do not search beyond the <var>MaxItemLength</var> column in a <var>Stringlist</var> item.
 
<var>MaxItemLength</var> accepts no arguments, and it returns the maximum length of a <var>stringlist</var> item (currently 6124) or that  part of a <var>stringlist</var> item that is on the first CCATEMP page of the item.


==Syntax==
==Syntax==
{{Template:Stringlist:MaxItemLength syntax}}
{{Template:Stringlist:MaxItemLength syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table>
<tr><th>%max</th>
<tr><th>%max</th>
<td>A numeric variable set to the maximum length of a <var>stringlist</var> item. </td></tr>
<td>A numeric variable to contain the maximum length (currently 6124) of that  part of a <var>Stringlist</var> item that is on the first CCATEMP page of the item.</td></tr>
<tr><th><var>%(Stringlist)</var></th>
 
<tr><th><var class="nobr">%(Stringlist)</var></th>
<td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods|shared]] method. <var>MaxItemLength</var> can also be invoked via a <var>Stringlist</var> object variable, which may be null.</td></tr>
<td>The class name in parentheses denotes a [[Notation conventions for methods#Shared methods|shared]] method. <var>MaxItemLength</var> can also be invoked via a <var>Stringlist</var> object variable, which may be null.</td></tr>
</table>
</table>
Line 17: Line 17:
==Usage notes==
==Usage notes==
<ul>
<ul>
<li><var>MaxItemLength's</var> chief purpose is to avoid having code with a constant (like 6124) whose value is subject to change. Under <var class="product">Sirius Mods</var> Version 6.5, 6124 was the maximum length of a <var>stringlist</var> item. Under <var class="product">Sirius Mods</var> Version 6.6 and later, some methods such as <var>[[Locate and LocateUp (Stringlist functions)|Locate]]</var> and <var>[[Locate and LocateUp (Stringlist functions)|LocateUp]]</var> still only operate on the first 6124 bytes of <var>stringlist</var> items.<li>While Sirius Software is not likely to reduce this value, because of the complex backward compatibility issues, it might someday increase it, as it eliminated the <var>stringlist</var> item length limit in <var class="product">Sirius Mods</var> 6.6.
<li><var>MaxItemLength's</var> chief purpose is to avoid having code with a constant (like 6124) whose value is subject to change. Formerly, 6124 was the maximum length of a <var>Stringlist</var> item. Some methods, such as <var>Locate</var> and <var>LocateUp</var>, still only operate on the first 6124 bytes of <var>Stringlist</var> items. While Rocket Software is not likely to reduce this value, because of the complex backward compatibility issues, it might someday increase it.
</ul>
</ul>


==See also==
==See also==
{{Template:Stringlist:MaxItemLength footer}}
{{Template:Stringlist:MaxItemLength footer}}

Latest revision as of 15:57, 15 April 2016

Maximum Stringlist item length (Stringlist class)


This method returns the maximum length of the part of a Stringlist item that is on the first CCATEMP page of the item. While items can be considerably longer than this (up to 2**31-1 bytes), this limit still affects some methods. For example, the Locate and LocateUp functions do not search beyond the MaxItemLength column in a Stringlist item.

Syntax

%max = %(Stringlist):MaxItemLength

Syntax terms

%max A numeric variable to contain the maximum length (currently 6124) of that part of a Stringlist item that is on the first CCATEMP page of the item.
%(Stringlist) The class name in parentheses denotes a shared method. MaxItemLength can also be invoked via a Stringlist object variable, which may be null.

Usage notes

  • MaxItemLength's chief purpose is to avoid having code with a constant (like 6124) whose value is subject to change. Formerly, 6124 was the maximum length of a Stringlist item. Some methods, such as Locate and LocateUp, still only operate on the first 6124 bytes of Stringlist items. While Rocket Software is not likely to reduce this value, because of the complex backward compatibility issues, it might someday increase it.

See also