UniBasic Commands Reference - Rocket Software
UniBasic Commands Reference - Rocket Software UniBasic Commands Reference - Rocket Software
Examples The following program segment is taken from the sample program in Appendix A, “Sample Program,” in Developing UniBasic Applications. The variable ENTRY is used to extract the user-requested values from the ORDERS record. 1-278 UniBasic Commands Reference DISPLAY_DATA: * Display the current information in the desired record. This is * determined by the number the user entered (ORDER_NUMBER). ... NUM_ENTRIES = DCOUNT(ORDER.REC,@VM) FOR ENTRY = 1 TO NUM_ENTRIES PRODUCT_NUMBER = ORDER.REC COLOR = ORDER.REC QUANTITY = ORDER.REC PRICE = OCONV(ORDER.REC,"MD2$,") In the following example, the program segment assigns the string Joan to the variable MID. Joan is the second attribute in the dynamic array ARR. The value and subvalue expressions are 0, resulting in the extraction of an attribute. ARR = "#543":@AM:"Joan":@AM:"D’Arc" MID = EXTRACT(ARR,2,0,0) In the next example, the program segment assigns the string Dagny, the second value of the third attribute, to the variable MID: ARRAY = "#143":@AM:"Gustav":@AM:"Mahler":@VM:"Dagny":@VM:"Jens" MID = EXTRACT(ARRAY,3,2) Related Commands UniBasic DEL, INSERT, REMOVE, REPLACE, SUBSTRINGS
FIELD Syntax FIELD(string.expr,delim.expr,field.expr [,rep.expr]) Description The UniBasic FIELD function treats a string as an array, with fields delimited by any specified ASCII character (for example, spaces, commas, or periods), and returns a substring or group of substrings. FIELD supports multibyte languages. Parameters The following table describes each parameter of the syntax. Parameter Description string.expr Specifies the string expression to search. delim.expr Specifies the field delimiter. field.expr Specifies the field at which to begin the search. ,rep.expr Specifies the number of fields to return. If you do not specify rep.expr, or it is less than 1, UniData returns a default of 1 substring. FIELD Parameters Examples In the following example, the program segment assigns the third value (“Guy”) in the array ARR to the array NARRAY: ARR = "#999":@VM:"Charlemagne":@VM:"Guy":@VM:"Pierre" NARRAY = FIELD(ARR,@VM,2,1) FIELD 1-247
- Page 234 and 235: Return Codes The following table de
- Page 236 and 237: Output Variable The following table
- Page 238 and 239: Output Variables The following tabl
- Page 240 and 241: EDADRV_GetDBInfo Syntax RETCODE EDA
- Page 242 and 243: EDADRV_GetEDAAttr Syntax RETCODE ED
- Page 244 and 245: EDADRV_GetErrmsg Syntax RETCODE EDA
- Page 246 and 247: Input Variables The following table
- Page 248 and 249: EDADRV_LoadSymbols Syntax RETCODE E
- Page 250 and 251: Output Variables The following tabl
- Page 252 and 253: Return Codes The following table de
- Page 254 and 255: Input Variables The following table
- Page 256 and 257: STATUS Codes ENABLEDEC has the foll
- Page 258 and 259: Parameter Description dataLoc 1 - D
- Page 260 and 261: Parameters he following table descr
- Page 262 and 263: END Syntax END Description The UniB
- Page 264 and 265: Related Commands UniBasic CALL, CHA
- Page 266 and 267: Examples In the following example,
- Page 268 and 269: EQU Syntax EQU constant1 TO value1
- Page 270 and 271: In the next example, UniData replac
- Page 272 and 273: EXECUTE Syntax EXECUTE "str.expr" [
- Page 274 and 275: Parameter Description Reminder: The
- Page 276 and 277: Related Commands UniBasic COMMON, E
- Page 278 and 279: Parameter Description Examples In t
- Page 280 and 281: The program output is: 1-274 UniBas
- Page 282 and 283: EXP Syntax EXP(expr) Description Th
- Page 286 and 287: In the next example, the program se
- Page 288 and 289: Options The value of option determi
- Page 290 and 291: FILEINFO Syntax FILEINFO(file.var,
- Page 292 and 293: Code 9 Merge factor percentage 10 S
- Page 294 and 295: FILELOCK Syntax FILELOCK [file.var]
- Page 296 and 297: FILEUNLOCK Syntax FILEUNLOCK [file.
- Page 298 and 299: FIND Syntax FIND expr IN dyn.array[
- Page 300 and 301: Related Commands UniBasic [], FINDS
- Page 302 and 303: Parameter Description Examples In t
- Page 304 and 305: FMT Syntax FMT(expr, "len [f.char]
- Page 306 and 307: STATUS Function Return Values After
- Page 308 and 309: FOOTING Syntax FOOTING [ON num.expr
- Page 310 and 311: Related Commands UniBasic GETPTR, H
- Page 312 and 313: This program segment produces the f
- Page 314 and 315: Parameter Description Examples The
- Page 316 and 317: FUNCTION Syntax FUNCTION function.n
- Page 318 and 319: The following program calls the pre
- Page 320 and 321: GE Syntax expr1 GE expr2 Synonyms #
- Page 322 and 323: generateKey Syntax generateKey(priv
- Page 324 and 325: Return Code Status 1-286 UniBasic C
- Page 326 and 327: GET Syntax GET[X] var[,length] [SET
- Page 328 and 329: Example In the following example, t
- Page 330 and 331: Parameters The following table desc
- Page 332 and 333: getHTTPDefault Syntax getHTTPDefaul
FIELD<br />
Syntax<br />
FIELD(string.expr,delim.expr,field.expr [,rep.expr])<br />
Description<br />
The <strong>UniBasic</strong> FIELD function treats a string as an array, with fields delimited by any<br />
specified ASCII character (for example, spaces, commas, or periods), and returns a<br />
substring or group of substrings. FIELD supports multibyte languages.<br />
Parameters<br />
The following table describes each parameter of the syntax.<br />
Parameter Description<br />
string.expr Specifies the string expression to search.<br />
delim.expr Specifies the field delimiter.<br />
field.expr Specifies the field at which to begin the search.<br />
,rep.expr Specifies the number of fields to return. If you do not specify rep.expr, or it<br />
is less than 1, UniData returns a default of 1 substring.<br />
FIELD Parameters<br />
Examples<br />
In the following example, the program segment assigns the third value (“Guy”) in the<br />
array ARR to the array NARRAY:<br />
ARR = "#999":@VM:"Charlemagne":@VM:"Guy":@VM:"Pierre"<br />
NARRAY = FIELD(ARR,@VM,2,1)<br />
FIELD 1-247