returns the amount of free space on the disk that holds the defaultFolder.
# Metadata
Platforms: desktop, server OS: mac, windows, linux Introduced: 1.0 Security: disk
# Syntax
the diskSpace
# Examples
the diskSpace
put the diskSpace div (1024^2) into megabytesAvailable
if the diskSpace < spaceNeeded then exit mouseUp
# Description
Use the diskSpace function to determine whether there is enough free space to complete an action (such as download data).
The value returned by the diskSpace function is in bytes. To convert to kilobytes (K), divide the return value by 1024. To convert to megabytes (M), divide by 1024^2. To convert to gigabytes (G), divide by 1024^3:
function humanReadableDiskSpace theUnits set the caseSensitive to false switch char 1 of theUnits case "k" return the diskSpace div 1024 break case "m" return the diskSpace div (1024^2) break case "g" return the diskSpace div (1024^3) break default return the diskSpace break end switch end humanReadableDiskSpace
# Tags
# See
- **keyword:** integer - **property:** freeSize, size, defaultFolder - **function:** hasMemory, volumes, stackSpace - **glossary:** download, return value, return, byte - **control structure:** function