Moves a folder with all its contents to another location.
# Metadata
Platforms: desktop, server OS: mac, windows, linux Introduced: 1.1.1 Security:
# Syntax
revMoveFolder folderToMove, destinationFolder
# Params
- folderToMove : The folderToMove specifies the name and location of the folder. If you specify a name but not a location, LiveCode assumes the folder is in the defaultFolder. - destinationFolder : The destinationFolder specifies the name and location of the folder where the folder should be placed. If you specify a name but not a location, LiveCode assumes the destination folder is in the defaultFolder.
# Examples
revMoveFolder "Backup Folder","/Disk/Backups/"
revMoveFolder "My App Prefs",specialFolderPath("Preferences")
# Description
Use the revMoveFolder function to move a folder into another folder.
The revMoveFolder command moves the entire folder, including all files, subfolders, and their contents. The folder is removed from its original location and apppears only in the new location.
>*Note:* When included in a standalone application, the > Common library is implemented as a hidden group and made available > when the group receives its first openBackground message. During the > first part of the application startup process, before > this message is sent, the revMoveFolder command is not yet > available. This may affect attempts to use this command in > startup, preOpenStack, openStack, or preOpenCard > handlers in the main stack. Once the application has > finished starting up, the library is available and the > revMoveFolder command can be used in any handler.
# Tags
# See
- **glossary:** application, standalone application, file, shell, subfolder, platform, command, Windows, main stack, OS X, AppleScript, group, Unix, message, folder, Mac OS, handler - **message:** startup, openBackground, preOpenStack, openStack, preOpenCard - **command:** create alias, delete folder, revDeleteFolder - **function:** result - **library:** Common library, library - **control structure:** function