Futurebasic/Language/Reference/def apndstr

= DEF APNDSTR Statement =

Statement
✔ Appearance ✔ Standard ✔ Console

Description
This statement adds the specified  to the end of the relocatable block specified by. should be a handle to an existing " " resource, or a handle to a block which you intend to save as an  resource. To create a new, empty handle for use with, you should create it like this:

After you have added strings to the new handle, you can save it as a resource by calling the  routine (http://developer.apple.com/documentation/mac/MoreToolbox/MoreToolbox-64.html).

To get a handle to an existing " " resource for use with, you can use any of a variety of Resource Manager functions such as  : http://developer.apple.com/documentation/mac/MoreToolbox/MoreToolbox-50.html.

Note
Never use  on a purgeable resource, unless you first call   (http://developer.apple.com/documentation/mac/Memory/Memory-91.html) to (temporarily) make it unpurgeable. If you think the resource may have been purged before you had a chance to call, then you should also   (http://developer.apple.com/documentation/mac/MoreToolbox/MoreToolbox-56.html) to make sure it's loaded into memory.

If you are using  to update an existing " " resource, then use   (http://developer.apple.com/documentation/mac/MoreToolbox/MoreToolbox-63.html) after using , to cause your changes to be written to disk when the resource file is closed or updated.

could cause a system error if heap memory is very low or very fragmented. You can use the  function periodically to de-fragment memory.