UniBasic Commands Reference - Rocket Software
UniBasic Commands Reference - Rocket Software UniBasic Commands Reference - Rocket Software
MATCHFIELD Syntax MATCHFIELD(str.expr,"[~] {len [X | ,A | ,N]} [text]", field.expr) Description The UniBasic MATCHFIELD function returns a substring that matches a pattern or literal. If no match is made, UniData returns an empty string. MATCHFIELD supports multibyte languages. You can mix the codes and a text string to search for specific patterns separated by characters. With null value handling on, if a function encounters the null value in a parameter when a number is expected (field.expr), a warning message displays and UniBasic uses 0. Parameters The following table describes each parameter of the syntax. Paramete r Description 1-444 UniBasic Commands Reference str.expr Specifies the variable to compare with the MATCH expression. ~ Inverses the pattern. To match 4N, a string must contain four numeric characters. To match ~4N, a string must contain four characters that are not numeric. len Specifies the number of characters to match. X Specifies that characters can be of any data type. A Specifies that only alphabetic characters match the pattern. MATCHFIELD Parameters
Paramete r Description N Specifies that only numbers match the pattern. text Specifies a literal string to search for. field.expr Specifies a portion of the str.expr to return. Each code segment is considered to be a field for the purposes of field.expr. Examples MATCHFIELD Parameters (continued) In the following example, the program segment returns the value 56 because the entire string matches the specified criteria, and the third field contains the number 56: SSN = "534-56-5565" MID = MATCHFIELD(SSN,"3N'-'2N'-'4N",3) In the next example, the program segment searches the string and returns the second and fourth fields and prints “99922”: STRING = "ALL999WERE22ABSENT" NUM1 = MATCHFIELD(STRING,'3A3N4A2N6A',2) NUM2 = MATCHFIELD(STRING,'3A3N4A2N6A',4) PRINT NUM1:NUM2 MATCHFIELD 1-445
- Page 434 and 435: INPUTTRAP Syntax INPUTTRAP string.e
- Page 436 and 437: INS Syntax INS expr BEFORE dyn.arra
- Page 438 and 439: INSERT Syntax INSERT(dyn.array.expr
- Page 440 and 441: INT Syntax INT(num.expr) Descriptio
- Page 442 and 443: ISNV Syntax ISNV(expr) Description
- Page 444 and 445: ISNVS Syntax ISNVS(dynamic.array) D
- Page 446 and 447: ITYPE Syntax ITYPE(itype.expr) Desc
- Page 448 and 449: LE Syntax expr1 LE expr2 Synonyms #
- Page 450 and 451: LEN Syntax LEN(str.expr) Descriptio
- Page 452 and 453: LENS Syntax LENS(dyn.array) Descrip
- Page 454 and 455: LISTUSER Syntax LISTUSER() Descript
- Page 456 and 457: LN Syntax LN(num.expr) Description
- Page 458 and 459: The following table describes the s
- Page 460 and 461: Parameters The following table desc
- Page 462 and 463: LOCATE in BASICTYPEs U, P, and M Th
- Page 464 and 465: However, in the following array, th
- Page 466 and 467: Parameters The following table desc
- Page 468 and 469: LOOP/REPEAT Syntax LOOP [statements
- Page 470 and 471: Examples The following example is t
- Page 472 and 473: LOWER Syntax LOWER(dyn.array.expr)
- Page 474 and 475: Related Command UniBasic LTS 1-434
- Page 476 and 477: MAT Syntax MAT dim.array = expr MAT
- Page 478 and 479: the values assigned to FEE1 would b
- Page 480 and 481: Parameter Description Examples In t
- Page 482 and 483: MATCH Syntax var MATCH "[~] len [X,
- Page 486 and 487: MATPARSE Syntax MATPARSE dim.array
- Page 488 and 489: The preceding program segment produ
- Page 490 and 491: Parameter Description INMAT Functio
- Page 492 and 493: MATREADL Syntax MATREADL dim.array
- Page 494 and 495: Example In the following example, t
- Page 496 and 497: Parameters The following table desc
- Page 498 and 499: Related Commands UniBasic DIM, INMA
- Page 500 and 501: Parameter Description STATUS Functi
- Page 502 and 503: MATWRITEU Syntax MATWRITEU dim.arra
- Page 504 and 505: MAXIMUM Syntax MAXIMUM(dyn.array.va
- Page 506 and 507: MDPERFORM Syntax MDPERFORM str.expr
- Page 508 and 509: Parameter Description Examples In t
- Page 510 and 511: MINIMUM Syntax MINIMUM(dyn.array.va
- Page 512 and 513: NE Syntax expr1 NE expr2 Synonyms #
- Page 514 and 515: NEG Syntax NEG(expr) Description Th
- Page 516 and 517: NFAUSER Syntax NFAUSER(“username
- Page 518 and 519: DCOUNT INDEX LEN SEQ SWAP 1-480
- Page 520 and 521: NOTS Syntax NOTS(dyn.array) Descrip
- Page 522 and 523: NUM Syntax NUM(expr) Description Th
- Page 524 and 525: NUMS Syntax NUMS(dyn.array) Descrip
- Page 526 and 527: OCONV Syntax OCONV(expr, conv.code.
- Page 528 and 529: OCONV Date (D) Syntax OCONV(integer
- Page 530 and 531: Note: Following SMA standards, Mond
- Page 532 and 533: Related Commands UniBasic DATE, ICO
MATCHFIELD<br />
Syntax<br />
MATCHFIELD(str.expr,"[~] {len [X | ,A | ,N]} [text]", field.expr)<br />
Description<br />
The <strong>UniBasic</strong> MATCHFIELD function returns a substring that matches a pattern or<br />
literal. If no match is made, UniData returns an empty string. MATCHFIELD<br />
supports multibyte languages.<br />
You can mix the codes and a text string to search for specific patterns separated by<br />
characters.<br />
With null value handling on, if a function encounters the null value in a parameter<br />
when a number is expected (field.expr), a warning message displays and <strong>UniBasic</strong><br />
uses 0.<br />
Parameters<br />
The following table describes each parameter of the syntax.<br />
Paramete<br />
r Description<br />
1-444 <strong>UniBasic</strong> <strong>Commands</strong> <strong>Reference</strong><br />
str.expr Specifies the variable to compare with the MATCH expression.<br />
~ Inverses the pattern. To match 4N, a string must contain four numeric<br />
characters. To match ~4N, a string must contain four characters that are not<br />
numeric.<br />
len Specifies the number of characters to match.<br />
X Specifies that characters can be of any data type.<br />
A Specifies that only alphabetic characters match the pattern.<br />
MATCHFIELD Parameters