Initializing help system before first use

parseextn

Purpose
Initialise an object of a module type from a text.
Synopsis
procedure parseextn(txt:text,start:integer,e:mtype)
procedure parseextn(txt:text,e:mtype)
procedure parseextn(txt:text,pctx:parsectx,e:mtype)
procedure parseextn(txt:text,ta:textarea,e:mtype)
Arguments
txt 
A text object
pctx 
A parser context
ta 
A text area object
start 
Starting position in the text (default value depends on which other arguments are used)
e 
An object of an external type
Example
The following: 
d:=date(SYS_NOW)
t:=text("1-Oct-2015")
setparam("datefmt", "%d-%N-%y")
parseextn(t,1,d)
if getsysstat<>0 then
 writeln("Error")
else
 writeln("year:",d.year)
end-if
produces this output: 
year:2015
Further information
1. This function can only be used with types supporting initialisation from a string (like date or time for instance). The parsing begins at the specified starting position and stops as soon as an invalid character is found or when the end of the text is reached.
  • Standard (initial two) versions: if start is not provided then the value of the control parameter sys_endparse is used as starting position; the location where parsing stops is stored in the parameter sys_endparse.
  • Version using a parser context: the information contained in the parser context is used instead of the global parameters (see Section The type parsectx); the context property endparse indicates the starting position and is updated with the location where parsing stops.
  • Version using a textarea object: the routine uses the start property of the object (see Section The type textarea) as the starting position but it does not store the position where parsing stops, in particular it does not modify the parameter sys_endparse.
2. In case of error the system status is set with a non-zero value (see getsysstat).
Related topics
parseint, parsereal, parsetext, nextfield, sys_endparse
Module
mmsystem

Parent Topic Procedures and functions

© 2001-2025 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.