MoreFiles(3) User Contributed Perl Documentation MoreFiles(3)NAME
Mac::MoreFiles - Sophisticated file management routines
SYNOPSIS
use Mac::MoreFiles;
$application = $Application{"MrPL"};
DESCRIPTION
Variables
%Application
The %Application hash will return the path to the application for a
given signature, searching on all mounted volumes.
Functions
FSpCreateMinimum SPEC
Create a new file with no creator or file type. The
FSpCreateMinimum function creates a new file without attempting to
set the the creator and file type of the new file. This function
is needed to create a file in an AppleShare "dropbox" where the
user can make changes, but cannot see folder or files. The FSSpec
in SPEC is used to create the file.
FSpShare SPEC
Establish a local volume or directory as a share point. The
FSpShare function establishes a local volume or directory as a
share point. SPEC is an FSSpec record specifying the share point.
FSpUnshare SPEC
The FSpUnshare function removes a share point in SPEC.
FSpFileCopy SRCSPEC, DSTSPEC, COPYNAME, PREFLIGHT
The FSpFileCopy function duplicates a file and optionally renames
it. Since the PBHCopyFile() routine is only available on some AFP
server volumes under specific conditions, this routine either uses
PBHCopyFile(), or does all of the work PBHCopyFile() does. The
SRCSPEC is used to determine the location of the file to copy. The
DSTSPEC is used to determine the location of the destination
directory. If COPYNAME <> NIL, then it points to the name of the
new file.
FSpDirectoryCopy SRCSPEC, DSTSPEC, PREFLIGHT, [COPYERRHANDLER]
Make a copy of a directory structure in a new location. The
FSpDirectoryCopy function makes a copy of a directory structure in
a new location. COPYERRHANDLER is the Perl routine name to handle
an error, should one arise. It will be called as:
$bailout = &$COPYERRHANDLER(ERRORCODE,OPERATION,SRCSPEC,DSTSPEC);
FSpIterateDirectory SPEC, MAXLEVELS, ITERATEFILTER, YOURDATAPTR
Iterate (scan) through a directory's content. The
FSpIterateDirectory function performs a recursive iteration (scan)
of the specified directory and calls your ITERATEFILTER function
once for each file and directory found.
The MAXLEVELS parameter lets you control how deep the recursion
goes. If MAXLEVELS is 1, FSpIterateDirectory only scans the
specified directory; if MAXLEVELS is 2, FSpIterateDirectory scans
the specified directory and one subdirectory below the specified
directory; etc. Set MAXLEVELS to zero to scan all levels.
The YOURDATAPTR parameter can point to whatever data structure you
might want to access from within the ITERATEFILTER. Your filter
function will be called as:
$quit = &$filterFunction(YOURDATAPTR, SPEC);
FSpDTGetAPPL VOLUME, CREATOR
The FSpDTGetAPPL function finds an application (file type 'APPL')
with the specified CREATOR on the specified VOLUME. It first tries
to get the application mapping from the desktop database. If that
fails, then it tries to find an application with the specified
creator using the File Manager's CatSearch() routine. If that
fails, then it tries to find an application in the Desktop file.
Returns FSSpec or "undef" on failure.
FSpDTSetComment SPEC, COMMENT
The FSpDTSetComment function sets a file or directory's Finder
comment field. The volume must support the Desktop Manager because
you only have read access to the Desktop file.
FSpDTGetComment SPEC
The FSpDTGetComment function gets a file or directory's Finder
comment field (if any) from the Desktop Manager or if the Desktop
Manager is not available, from the Finder's Desktop file. Returns
Str255, or "undef" on failure.
FSpDTCopyComment SRCSPEC, DSTSPEC
The FSpDTCopyComment function copies the desktop database comment
from the source to the destination object. Both the source and the
destination volumes must support the Desktop Manager.
AUTHOR
Written by Matthias Ulrich Neeracher <neeracher@mac.com>, documentation
by Bob Dalgleish <bob.dalgleish@sasknet.sk.ca>. Currently maintained
by Chris Nandor <pudge@pobox.com>.
perl v5.12.5 2013-08-25 MoreFiles(3)