Class Reference
%Library.File
| Server:basexml |
| Instance:SOAXML |
| User:UnknownUser |
 |
|||
| Private Storage | |||
The
For example,
If ##class(%File).Exists("file.txt") Write "It exists",!
You can also create an instance of a
For example,
Set file=##class(%File).%New("file.txt")
Write file.Size
Do file.Open("WSN")
Do file.WriteLine("This is a line of text")
|
|
|
|
| Properties | ||||
|---|---|---|---|---|
| %Location | AtEnd | Attributes | CanonicalName | DateCreated |
| DateModified | Id | IsOpen | LastModified | LineTerminator |
| Name | Size | |||
|
|
Read only property that returns the canonical filename if the file is open and "" if the file is not open. On VMS this will include the file version number
The creation date for this file.
The last modified date for this file.
True (1) if this file is currently open, false (0) otherwise.
The name of this file.
|
|
Return the attributes of the file. The format of the returned value depends on the underlying operating system.Microsoft Windows® returns a value as a combination of bits whose meaning is:
- 1: 0x00001 - Read-only
- 2: 0x00002 - Hidden
- 4: 0x00004 - System
- 8: 0x00008 - Unused
- 16: 0x00010 - Directory
- 32: 0x00020 - Archive
- 64: 0x00040 - Device
- 128: 0x00080 - Normal
- 256: 0x00100 - Temporary
- 512: 0x00200- Sparse File
- 1024: 0x00400 - Reparse Point
- 2048: 0x00800 - Compressed
- 4096: 0x01000 - Offline
- 8192: 0x02000 - Content Not Indexed
- 16384: 0x04000 - Encrypted
- 32768: 0x08000 - Unused
- 65536: 0x10000 - Virtual
In UNIX®, the returned value represents the mode map:
- 1: 0x0001 - execute permission for others
- 2: 0x0002 - write permission for others
- 4: 0x0004 - read permission for others
- 7: 0x0007 - mask for others permissions
- 8: 0x0008 - execute permission for group
- 16: 0x0010 - write permission for group
- 32: 0x0020 - read permission for group
- 56: 0x0038 - mask for group permissions
- 64: 0x0040 - execute permission for owner
- 128: 0x0080 - write permission for owner
- 256: 0x0100 - read permission for owner
- 448: 0x01C0 - mask for file owner permissions
- 512: 0x0200 - sticky bit
- 1024: 0x0400 - set groupid
- 2048: 0x0800 - set userid
- 4096: 0x1000 - fifo
- 8192: 0x2000 - character device
- 16384: 0x4000 - directory
- 24576: 0x6000 - block device
- 32768: 0x8000 - regular file
- 40960: 0xA000 - symbolic link
- 49152: 0xC000 - socket
- 61440: 0xF000 - mask for file type
On OpenVMS, this is the file protection presented as four 4-bit fields, accessed by the following hexadecimal masks:
where each of these subfields has bit values with the following meanings:
- 000F: system privileges
- 00F0: owner privileges
- 0F00: group privileges
- F000: world privileges
- 1: no read access
- 2: no write access
- 4: no execute access
- 8: no delete access
Note: Individual Operating System vendor differences may exist. The relevant man/help pages or other associated documentation should be consulted for a definitive description of the file attributes on a given system.
VMS specific function, returns the canonical form of the filename, on VMS this will include the version number. If the file can not be opened then it will return ""
This is a Get accessor method for theCanonicalName property.
Clear the contents of this Stream from permanent storage. This will remove the permanent stream storage and any temporary stream and initialise the stream to its initial state that it starts in, including removing all the stream attributes.Returns a
%Status value indicating success or failure.
Close the current file.
Compare two files and return 1 if they are identical and 0 otherwise
Handle delete of cases where filename contains a wildcard. Note: this does not delete subdirectories in the given directory; only files are removed.
Return the canonical form of the directory name filename. When filename is a non-full path directory, it will prefix the filename with Manager Path instead of current directory.
Copy a host directory from pSource to pTarget.
Parameter pOverlay Parameter pDeleteBeforeCopy may be used to specify that any file that already exists in the target directory should be deleted before being overwritten with the source file. The default is 0 or false.
This method returns true if it succeeds and false otherwise.
Note: (1) If the target directory exists and pOverlay is false (default), then the operation fails. Also, if any of the target files exist and pDeleteBeforeCopy is false (default), then the operation may fail usually due to operating system characteristics. (2) The total number of files or directories created/copied during the operation can be gotten by passing a byref value in pCreated.
Copy a host file from to host file to.
Parameter pDeleteBeforeCopy may be used to specify that if the target file already exists then it should be deleted before being overwritten with the source file. The default is 0 or false.
This method returns true if it succeeds and false otherwise.
Method not implemented as it does not make sense in context of %File interface
Creates a directory with name name. Returns true if it succeeds and false otherwise.
Create this directory and all the parent directories if they do not exist. This differs fromCreateDirectory as that method only creates one new directory where as this will create the entire chain of directories. Returns true if it succeeds and false otherwise.
Given a directory name and the name of a new directory create this directory inside the given directory. Return true if it succeeds and false otherwise.
This is a Get accessor method for theDateCreated property.
This is a Get accessor method for theDateModified property.
Deletes the file filename. Returns true if it succeeds and false otherwise.
Tests if filename is a directory. returns 1 if it is a directory, otherwise, returns 0.
Returns true (1) if filename exists.
Given a full directory and filename this will return just the directory portion of this name. This is useful as the parsing of filenames on Unix/Windows/VMS is different.
Return the number of pieces in this directory name
Return the piece of a directory name
Return the amount of total space and free space in either Bytes,MB,GB on a drive or directory
Name = Valid Drive or directory specification
Flag = 0 - Return bytes
Flag = 1 - Return MB (Default)
Flag = 2 - Return GB
MB and GB returned are rounded to 2 decimal places.
Any error status returned is O/S level error.
Return the date created of file filename in $H format. By default this is local time, if you pass utc as true it returns it in UTC time
Return the date last modified of file filename in $H format. By default this is local time, if you pass utc as true it returns it in UTC time
Return the size of file filename in bytes.
Given a full directory and filename this will return just the filename portion of this name. This is useful as the parsing of filenames on Unix/Windows/VMS is different.
This is a Get accessor method for theLastModified property.
Returns the path of the Caché manager directory.
Returns the normalized form of the directory name filename. If you pass directory then it will normalize this filename relative to the provided directory, if no directory is supplied then it is relative to the current default directory. addnull is set to true on VMS if normalizing the directory involves adding [000000] the the name
Returns the normalized form of the filename. If you pass directory then it will normalize this filename relative to the provided directory, if no directory is supplied then it is relative to the current default directory.
Normalize filenames containing spaces for the host platform.
Parameter
pathname : A filename or pathname, specified as a quoted string. You cannot supply a Windows pathname as a doubly-quoted string.
Description
The NormalizeFilenameWithSpaces class method handles spaces in pathnames as appropriate to the host platform. If the pathname contains a space character, pathname handling is platform-dependent.
OpenVMS permits space characters in pathnames; NormalizeFilenameWithSpaces performs no special processing and returns the pathname unchanged.
UNIX only permits space characters in quoted pathnames; if a pathname containing spaces NormalizeFilenameWithSpaces returns the pathname enclosed in double quotes ("pathname"). If a pathname does not contain spaces, the method returns it unchanged. NormalizeFilenameWithSpaces performs no other pathname validation.
On Windows systems, NormalizeFilenameWithSpaces strips spaces from the supplied pathname of an existing file. If a pathname does not contain spaces, the method returns it unchanged in all cases. On Windows systems, the method validates pathnames that contain spaces. If a pathname containing spaces does not exist, NormalizeFilenameWithSpaces returns the pathname unchanged (with its blank spaces), with the entire pathname enclosed in double quotes ("pathname"). If a pathname containing spaces exists, the method returns the short form pathname with spaces removed, such as the following:
In this case, the filename is truncated to the first six non-blank characters, and a tilde (~) and an ordinal number are appending to distinguish similarly named files. For further details on Windows handling of pathname characters, specify cmd /? at the Windows command prompt.WRITE ##class(%File).NormalizeFilenameWithSpaces("C:\My Test File.txt") C:\MYTEST~1.TXT
NormalizefilenameWithSpaces is commonly used with the $ZF(-1) and $ZF(-2) functions.
Open the current file with mode mode.mode is a string containing one or more file modes including:
Note that if the mode contains ':' characters this is a delimiter. For example if the mode="RN:/SHARED" then it will open the file with the equivalent of the COS command 'Open name:("RN":/SHARED):0'. The first piece before the ':' is quoted and the subsequent pieces are not.
R Read W Write S Stream mode N Create a new file (overwrite existing file) A complete discussion of the available options for mode can be found in the online documentation in the book, Caché I/O Devices Guide, specifically the chapter on Sequential File I/O.
Given a directory name, return the name of its parent directory.
If the directory is already the root (e.g., "/" on Unix, "c:\" on Windows or "dka1:" on VMS), return the root.
Read up to len characters from this File.
Return true if the file is read only and false if it is writable
Removes directory name. Returns true if it succeeds and false otherwise.
Recursivel remove directory pTarget. Returns true if it succeeds and false otherwise.
Rename file oldname to newname. Returns true if it succeeds and false otherwise.
Moves the current location to the beginning of the stream.
Set the OS specific attributes of the file. See the Attribute method in this class for file attribute values.
Make this file/directory read only (if we can). If leaveexisting is true then it will add read permissions to the file/directory without changing the existing permissions, by default it will remove all other permissions other than read only flags.
Set umask to the given value and return the previous umask value
Make this file/directory writable (if we can). The writeonly defaults to true in which case this makes the file write only, if you just want to add writable to the existing permissions without modifying the other permissions pass writeonly=0.
This is a Get accessor method for theSize property.
Given a directory name and the name of a sub directory create the name for the subdirectory inside the given directory. Return the new directory name. This is useful as the parsing of filenames on Unix/Windows/VMS is different.
Return a temporary filename in the temp directory. If you specify ext the temp filename will have this extension else it will default to 'tmp'.
Return information on the VMS record format for this file. This function only works on VMS and returns one of returns one of the following strings: "UDF", "FIX", "VAR", "VFC", "STM", "STMLF", "STMCR". This allows a user to determine what OPEN mode should be used to read an unknown file from Cache.
Write data to this%File object.
Write data with a carriage return to this%File object.
Return true if the file/directory is writable and false if it is not
|
|
Selects Drive As%String
Return a list of drives available on this computer. If fullyqualified is true then the drive letters on Windows include the trailing '\' character. The default is false; this is backward compatible and returns 'c:' on Windows. This does not affect the behavior on VMS or Unix.
Selects Name As%String , Type As%String , Size As%BigInt , DateCreated As%TimeStamp , DateModified As%TimeStamp , ItemName As%String
Return the list of files in directory matching the pattern wildcards. The sortby can be one of:The includedirs if true (default is 0) will force the list of all directories to be returned before any files, the directories will ignore the pattern you supplied so it returns them all. If it is false it will return any files that match the pattern you give it, this may include directories if they match the pattern as well. So true forces any directory to be included, but false does not exclude directories. You may also specify the delimiter that is used to separate the wildcards from each other, this defaults to ";".
- Name - the name of the file (the default)
- Type - file type
- DateCreated - the date the file was created
- DateModified - the date the file was last modified
- Size - the file size
Selects Name As%String , IsDrive As%Boolean , Directory As%String
Given a directory name return it pulled apart into individual subdirectories starting at the root node and working down to the last directory name