Futurebasic/Language/Reference/str pound

STR# edit

Syntax edit

stringFromList$ = STR#(resourceID%, index%)

Description edit

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; you can also add strings to an "STR#" resource using the DEF APNDSTR statement, or remove them using the DEF REMOVESTR statement.

Note edit

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& <spacer type="horizontal" size="48">resCount% = {[resHndl&]}'Get 1st word in block    XELSE <spacer type="horizontal" size="48">resCount% = 0<spacer type="horizontal" size="15">'Couldn't get the resource    END IF END FN = resCount%

See Also edit

DEF APNDSTR; DEF REMOVESTR; COMPILE _strResource; STR&