4D v13.4
STRING LIST TO ARRAY
- 4D Language Reference
-
- Resources
-
- Resources
- ARRAY TO STRING LIST
- CLOSE RESOURCE FILE
- Create resource file
- DELETE RESOURCE
- Get component resource ID
- GET ICON RESOURCE
- Get indexed string
- GET PICTURE RESOURCE
- GET RESOURCE
- Get resource name
- Get resource properties
- Get string resource
- Get text resource
- Open resource file
- RESOURCE LIST
- RESOURCE TYPE LIST
- SET PICTURE RESOURCE
- SET RESOURCE
- SET RESOURCE NAME
- SET RESOURCE PROPERTIES
- SET STRING RESOURCE
- SET TEXT RESOURCE
- STRING LIST TO ARRAY
STRING LIST TO ARRAY
| STRING LIST TO ARRAY ( resID ; strings {; resFile} ) | ||||||||
| Parameter | Type | Description | ||||||
| resID | Longint |
|
Resource ID number or 'id' attribute of the 'group' element (XLIFF) | |||||
| strings | String array |
|
Strings from the STR# resource or Strings from the 'group' element (XLIFF) | |||||
| resFile | DocRef |
|
Resource file reference number If omitted: all the XLIFF files or open resources files | |||||
The STRING LIST TO ARRAY command populates the array strings with:
- Either the strings stored in the string list ("STR#") resource whose ID is passed in resID.
- Or a string stored in an open XLIFF file whose 'id' attribute of the 'group' element is passed in resID (see "Compatibility with XLIFF architecture" below).
If the resource is not found, the array strings is left unchanged and the OK variable is set to 0 (zero).
If you pass a valid resource file reference number in resFile, the resource is searched for in that file only. If you do not pass resFile, the first occurrence of the resource found in the resource files chain is returned.
Before calling STRING LIST TO ARRAY, you can predeclare the array strings as a String or Text array. If you do not predeclare the array, the command creates strings as a Text array.
Note: Each string of a string list resource can contain up to 255 characters.
Tip: Limit your use of string list resources to those up to 32K in total size, and a maximum of a few hundred strings per resource.
The STRING LIST TO ARRAY command is compatible with the XLIFF architecture of 4D v11: the command first looks for values corresponding to resID and strID in all the open XLIFF files (when the resFile parameter is omitted) and fills the strings array with the corresponding values. In this case, resID specifies the id attribute of the group element and the strings array contains all the strings of the element. If the value is not found, the command continues searching in the open resources files.
For more information about XLIFF architecture in 4D, refer to the Design Reference manual.
If the resource is found, OK is set to 1. Otherwise, it is set to 0 (zero).
Product: 4D
Theme: Resources
Number:
511
Modified: 4D v11 SQL
Get indexed string
Get string resource
Get text resource
