Number (FloatNamedArraylist function)

From m204wiki
Revision as of 15:14, 23 September 2020 by DCameron (talk | contribs)
Jump to navigation Jump to search

Item number of specified name (FloatNamedArraylist class)


Number returns the item number (ordinal) of the item that has the specified subscript in the FloatNamedArraylist.

Syntax

%number = fltNal:Number( subscript)

Syntax terms

%number A numeric variable to contain the item number of the fltNal item selected by subscript.
fltNal A FloatNamedArraylist object.
subscript A numeric value that serves as a subscript to identify a fltNal item.

Usage notes

  • If Number is called and there is no item on the FloatNamedArraylist that has the indicated subscript, a 0 is returned, regardless of the setting of UseDefault.

Examples

The following request demonstrates the numerically ordered result produced by a NameByNumber loop over a FloatNamedArraylist versus the alphabetically ordered result using a NamedArraylist:

b %x is collection namedArraylist of string len 32 %y is collection floatNamedArraylist of string len 32 %i is float %x = new %x(7) = 'seven' %x(38) = 'thirty-eight' %x(110) = 'one-hundred-ten' %y = new %y(7) = 'seven' %y(38) = 'thirty-eight' %y(110) = 'one-hundred-ten' for %i from 1 to %x:count print %x:nameByNumber(%i) and %x:itemByNumber(%i) end for for %i from 1 to %y:count print %y:nameByNumber(%i) and %y:itemByNumber(%i) end for end

The request prints:

110 one-hundred-ten 38 thirty-eight 7 seven ----- 7 seven 38 thirty-eight 110 one-hundred-ten


See also

  • The ItemByNumber property lets you retrieve or set an item using the item's ordinal number.
  • The NameByNumber function lets you retrieve an item's name using the item's ordinal number.