%MOVEFILE Move or rename file or folder.
%   [STATUS,MESSAGE,MESSAGEID] = MOVEFILE(SOURCE) moves the file or folder
%   SOURCE to the current folder. MOVEFILE does not preserve the archive 
%   attribute of SOURCE. MOVEFILE cannot move a file onto itself.
%
%   [STATUS,MESSAGE,MESSAGEID] = MOVEFILE(SOURCE,DESTINATION) moves 
%   SOURCE to the file or folder DESTINATION. If SOURCE and DESTINATION 
%   are in the same location, then MOVEFILE renames SOURCE to DESTINATION.
%   If SOURCE ends in a wildcard (*), all matching file objects are moved to 
%   DESTINATION.
%
%   [STATUS,MESSAGE,MESSAGEID] = MOVEFILE(SOURCE,DESTINATION,'f') moves 
%   SOURCE to DESTINATION, as above, even if DESTINATION is read-only. The
%   state of the writable attribute of DESTINATION is preserved.
%
%   INPUT ARGUMENTS:
%       SOURCE:      Character vector or string scalar specifying the source 
%                    file or folder. SOURCE can be an absolute or relative path. 
%                    UNC paths are supported. To copy multiple files or folders, 
%                    use wildcards (*).
%       DESTINATION: Character vector or string scalar specifying the destination 
%                    file or folder. DESTINATION can be an absolute or 
%                    relative path, but cannot include wildcards (*). UNC paths 
%                    are supported.
%
%   OUTPUT ARGUMENTS:
%       STATUS:      Logical scalar indicating if the attempt to move 
%                    the file or folder is successful. If the attempt
%                    is successful, STATUS is 1. Otherwise, STATUS is 0.
%       MESSAGE:     Character vector containing the error message. If an 
%                    error or warning occurs, MESSAGE contains the message text 
%                    of the error or warning. Otherwise, MESSAGE is empty ('').
%       MESSAGEID:   Character vector containing the error message identifier.
%                    If an error or warning occurs, MESSAGEID contains the
%                    message identifier of the error or warning. Otherwise, 
%                    MESSAGEID is empty ('').
%
%   See also CD, COPYFILE, DELETE, DIR, FILEATTRIB, MKDIR, RMDIR.

%   Copyright 1984-2019 The MathWorks, Inc.

%   Package: libmwbuiltins
%   Built-in function.
