Syntax:
stringFromList$ = str#(resourceID%, index%)
Description:
This function returns a string element from a resource of type "str#
". The resourceID%
should specify the resource ID number of an "str#
" resource in a currently open resource file. index%
indicates which string element to get; the first element is numbered 1. If the "str#
" resource isn't found, or if index%
is greater than the number of strings in the resource, the str#
function returns an empty (zero-length) string.
"str#
" resources hold lists of strings. Among other things, they're useful in helping you to localize your program so that it supports the native language of your user. You typically use a program like ResEdit to create an "str#
" resource and its strings.
Note:
You can use the following function to determine how many strings are in an "str#
" resource.
local fn GetSTRcount(resID%)
resHndl& = fn GETRESOURCE(_"str#",resID%)
long if resHndl&
resCount% = {[resHndl&]}'Get 1st word in block
xelse
resCount% = 0 'Couldn't get the resource
end if
end fn = resCount%
See Also:
compile _strResource; str&