GetItem

Object and Type

Object  : FCSession

Type     : Method

Prototype

Public Function GetItem(path_str As String, _
                     start_item As Integer, _
                     stop_item As Integer, _
                     separator As String) As String

Description

Returns all the items between first and last within the specified formatted text list. This provides the same functionality as the ClearBasic Item$ function.

Parameters

Parameter Name	Required?	Description
path_str	Yes	String containing the text from which a range of items is returned.
start_item	Yes	Integer containing the index of the first item to be returned. If first is greater than the number of items in text$, then a zero-length string is returned.
stop_item	Yes	Integer containing the index of the last item to be returned. All of the items between first and last are returned. If last is greater than the number of items in text$, then all items from first to the end of text are returned.
seperator	Yes	String containing different item delimiters.

Example

The following example creates 2 delimited lists, and then extracts a range from each.

JavaScript:

var ilist = "1,2,3,4,5,6,7,8,9,10,11,12,13,14,15";
var slist = "1/2/3/4/5/6/7/8/9/10/11/12/13/14/15";
var list1 = FCSession.GetItem(ilist,5,12,",");
var list2 = FCSession.GetItem(slist,2,9,"/");
var ilist4 = FCSession.GetItem(ilist,4,4,",");

The results of this would be:

list1  = 5,6,7,8,9,10,11,12

list2 = 2/3/4/5/6/7/8/9

ilist4 = 4