4D v16.3
Get indexed string
- 4D Language Reference
-
- Resources
-
- Resources
- CLOSE RESOURCE FILE
- 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
- STRING LIST TO ARRAY
- _o_ARRAY TO STRING LIST
- _o_Create resource file
- _o_DELETE RESOURCE
- _o_Get component resource ID
- _o_SET PICTURE RESOURCE
- _o_SET RESOURCE
- _o_SET RESOURCE NAME
- _o_SET RESOURCE PROPERTIES
- _o_SET STRING RESOURCE
- _o_SET TEXT RESOURCE
Get indexed string
| Get indexed string ( resID ; strID {; resFile} ) -> Function result | ||||||||
| Parameter | Type | Description | ||||||
| resID | Longint |
|
Resource ID number or 'id' attribute of the 'group' element (XLIFF) | |||||
| strID | Longint |
|
String number or 'id' attribute of the 'trans-unit' element (XLIFF) | |||||
| resFile | DocRef |
|
Resource file reference number If omitted: all the XLIFF files or open resource files | |||||
| Function result | String |
|
Value of the indexed string | |||||
The Get indexed string command returns:
- Either one of 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).
You pass the number of the string in strID. The strings of a string list resource are numbered from 1 to N. To get all the strings (and their numbers) of a string list resource, use the STRING LIST TO ARRAY command.
If the resource or the string within the resource is not found, an empty string is returned 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.
Note: A string of a string list resource can contain up to 255 characters.
The Get indexed string command is compatible with the XLIFF architecture of 4D beginning with version 11: the command first looks for values corresponding to resID and strID in all the open XLIFF files (when the resFile parameter is omitted). In this case, resID specifies the id attribute of the group element and strID specifies the id attribute of the trans-unit 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).
Get localized string
Get string resource
Get text resource
STRING LIST TO ARRAY
Product: 4D
Theme: Resources
Number:
510
Modified: 4D v11 SQL
4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)
