PARSESET$

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Core Language > BuiltIn Functions > String functions >

PARSESET$

 

Description

 

Change a delimited field in a string expression with a new value returning the modified resulting string.

 

Syntax

 

s = PARSESET$(MainString, [ANY] Delimiter, Index, NewString)

 

Returns

 

String

 

Parameters

 

Name

Type

Optional

Meaning

MainString

String

No

The string to be parsed

Delimiter

String

No

The field delimiter, which may be one or more characters long.

If the ANY option is present, each appearance of any single character comprising Delimiter is considered a valid delimiter.

Index

Number

No

The delimited field number to return.  The first field is 1.

The maximum number of fields contained in MainString can be determined with the PARSECOUNT function.

 

NewString

String

No

The new string to set at Index position

 

Remarks

 

If Index is > number of elements found in MainString, returned string will be redimensioned adding new Delimiter(s) in order to include Index position.

 

Restrictions

 

If ANY is used and specified delimiter is a multi char string, only first char of delimiter will be used in returned string.

 

See also

 

String Handling,

 

Examples