filename of stack

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the filename of <stack> to <filePath>
Associationsstack
Summary

Reports the file path of the file a stack is stored in.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
local nameToSave
put the filename of this stack into nameToSave
local savedName
if the effective filename of this stack is savedName then beep
set the filename of this stack to "Test.livecode"
set the filename of this stack to "/Volumes/Lizards/Godzilla.livecode"
# set the defaultFolder to the folder containing the stackfile
set the itemDelimiter to slash
get the effective filename of this stack
set the defaultFolder to item 1 to -2 of it
Values
NameTypeDescription
Value

The filename of stack of a stack specifies the name andlocation of the stack file. If you specify a name but not a location, LiveCode assumes the file is in the defaultFolder. By default, the filename of stack property of newly created stacks is set to empty.

RelatedProperty: defaultFolder, itemDelimiter, stackFiles
Message: saveStackRequest
Keyword: effective, item
Constant: empty, slash
Object: stack
Glossary: application bundle, execution error, file, file path, folder, main stack, OS X, property, stack file, standalone application, substack
Function: stacks
Description

Use the filename of stack property to specify where a stack file is stored on the user's system.

If the stack is a main stack, its filename of stack property reports the file path of the file the stack is stored in. If the stack is the main stack of a standalone application, the filenameof stack property reports the name and location of the application.

If the stack is a substack, its filename of stack property is empty. To find out what file a substack is stored in, use the form the effective filename of stack. You cannot set the filename of stack property of a substack and attempting to will result in an execution error being thrown.

If the stack has not yet been saved, its filename of stack property is empty.

*Cross-platform note:* On OS X systems, standalone applications are stored as application bundles. A bundle behaves like a file but is actually a folder, and the main stack of a standalone application is inside this folder. The filename of stack property reports the location of the application inside the bundle, not the bundle's location. For example, if the bundle's file path is "/Volumes/Disk/MyApp.app/", the filename of the application's main stack might be "/Volumes/Disk/MyApp.app/Contents/MacOS/MyApp".

Tagsfile system