getResources

Typefunction
DictionaryLCS
LibraryLiveCode Script
Syntax
getResources(<filePath> [, <resourceType>])
Summary

Returns a list of the resources in a Mac OS file.

Introduced1.0
Changes

The order of items returned by the getResources function was changed in version 1.1. In previous versions, the getResources function returned these items for each resource:

OSmac
Platformsdesktop
Parameters
NameTypeDescription
filePath

The location and name of the file whose resource fork you want to list. If you specify a name but not a location, LiveCode assumes the file is in the defaultFolder.

resourceType

The 4-character type of the resources you want to list. If you don't specify a resourceType, the getResources function lists all the resources of all resource types.

Example
getResources("Project Resources")
getResources(it,"STR#")
Values
NameTypeDescription
return

The getResources function returns a list of resources, one per line. Each line consists of the following items items : - the resource ID - the resource name - the resource size in bytes - the 4-character resource type - one or more resource flag characters. The possible resource flags are as follows: - S System heap - U Purgeable - L Locked - P Protected - R Preload - C Compressed resource If a flag is set to true, its character is included in the last item. If the flag is set to false, its character is not included. If none of these flags is set for a resource, the last item of that resource's line is empty. If the file does not contain any resources, the getResources function returns empty

The result

If the filePath does not exist, the result is set to "can't find file". If the filePath exists, but the file has no resource fork, the result is set to "can't open resource fork". If the file has a resource fork but no resources, the result is empty.

RelatedKeyword: items, file, line
Function: result, setResource
Glossary: resource fork, resource, Mac OS, return
Control Structure: function
Securitydisk
Description

Use the getResources function to find out whether a resource already exists before using it or copying it.

Tagsfile system