filename of stack

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

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

set the filename of stack to filePath

# Examples

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

# 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 filename of stack property reports the file path 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, > standalone applications are stored as > application bundles. A application 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 application bundle, not the application bundle > location. For example, if the application bundle > file path is "/Volumes/Disk/MyApp.app/", the filename of the application's > main stack might be "/Volumes/Disk/MyApp.app/Contents/MacOS/MyApp".

# Tags

file system,

# See

- **property:** 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