4D v14.3

STRING LIST TO ARRAY

Home

 
4D v14.3
STRING LIST TO ARRAY

STRING LIST TO ARRAY 


 

STRING LIST TO ARRAY ( resID ; strings {; resFile} ) 
Parameter Type   Description
resID  Longint in Resource ID number or 'id' attribute of the 'group' element (XLIFF)
strings  String array in Strings from the STR# resource or Strings from the 'group' element (XLIFF)
resFile  DocRef in 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).

 
PROPERTIES 

Product: 4D
Theme: Resources
Number: 511

The OK variable is changed by the command

 
HISTORY 

Modified: 4D v11 SQL

 
SEE ALSO 

Get indexed string
Get string resource
Get text resource

 
ARTICLE USAGE

4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v13.5)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)

Inherited from : STRING LIST TO ARRAY ( 4D v12.4)