The function extracts a String specified by a text before and after from an array of characters with extended options.
LGF_ExtractStringFromCharArrayAdv (FC) | ||||||||
---|---|---|---|---|---|---|---|---|
String | textBefore | Ret_Val | Word | |||||
String | textAfter | extractedString | String | |||||
Bool | includeBeforeAfter | position | DInt | |||||
DInt | startPos | length | Int | |||||
status | Word | |||||||
Variant | searchIn | Variant | ||||||
Identifier | Data type | Description |
---|---|---|
textBefore | String | Text in front of the characters which has to be extracted |
textAfter | String | Text behind the characters which has to be extracted |
includeBeforeAfter | Bool | TRUE: `textBefore` and `textAfter` are included in the extracted string |
startPos | DInt | Position within the array to start search from (index zero based) |
Identifier | Data type | Description |
---|---|---|
Ret_Val | Word | Return value: 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
extractedString | String | Extracted string |
position | DInt | Position (index) within the array where text begins (index zero based) |
length | Int | Length of text that was extracted |
status | Word | 16#0000-16#7FFF: Status of the FB 16#8000-16#FFFF: Error identification (see following Table) |
Identifier | Data type | Description |
---|---|---|
searchIn | Variant | Array of Character or Byte to search in |
Code / Value | Identifier / Description |
---|---|
16#0000 | STATUS_TEXT_FOUND Successful, start text and end text were found |
16#0000 | STATUS_NO_ERROR Status: Execution finished without errors |
16#8200 | ERR_NO_ARRAY Error: No array of Char or Byte is present at the input `searchIn` |
16#9001 | WARNING_ONLY_START Unsuccessful, only start text was found, extracted String is filled with characters after start text |
16#9002 | WARNING_NOTHING_FOUND Unsuccessful, neither text was found |
Version & Date | Change description | |
---|---|---|
01.00.00 | Siemens Online Support | |
01.04.2019 | First released version (LHttp) | |
01.01.00 | Siemens Online Support | |
10.06.2022 | Adaption and integration into LGF |