Release 10.1A: OpenEdge Development:
Progress 4GL Reference

> ## FILE-INFO system handle

> A handle to an operating system file.

> #### Syntax

>     FILE-INFO [ :attribute ]

> ``attribute``

> Specifies an attribute of the FILE-INFO handle.

> #### Attributes

> FILE-CREATE-DATE attribute | FILE-CREATE-TIME attribute | FILE-MOD-DATE attribute
> FILE-MOD-TIME attribute | FILE-NAME attribute | FILE-SIZE attribute
> FILE-TYPE attribute | FULL-PATHNAME attribute | PATHNAME attribute
> TYPE attribute |  |

> Example

> After you set the value of the FILE-NAME attribute, you can read the values of the other attributes. For example:

> r-osfile.p
>     DEFINE VARIABLE os-file  AS CHARACTER FORMAT "x(60)" LABEL "File".

>     REPEAT:
>       SET os-file WITH FRAME osfile-info.
>       FILE-INFO:FILE-NAME = os-file.
>       DISPLAY FILE-INFO:FULL-PATHNAME FORMAT "x(60)" LABEL "Full Path"
>         FILE-INFO:PATHNAME FORMAT "x(60)" LABEL "Path"
>         FILE-INFO:FILE-TYPE LABEL "Type"
>         WITH FRAME osfile-info SIDE-LABELS TITLE "OS File Info".
>     END.

> #### Notes

> - You cannot use the FILE-INFO handle to by-pass operating system security. You must have read access to the file and the directory that contains it to obtain information through FILE-INFO.

> - These attributes return the Unknown value (`?`) until they are set, and also if the specified file cannot be found or you do not have permission to access the file.

> - If you set the FILE-NAME attribute to a relative pathname, the FILE-INFO handle searches the current `PROPATH` to locate the file.

> - The FILE-TYPE attribute returns a string containing exactly one of the following file type characters:

> - D — If the file is a directory.
> - F — If the file is a standard file or FIFO pipe (UNIX systems).
> - M — If the file is a member of a Progress procedure library.
> - S — If the file is a special device (UNIX systems).
> - X — If the file type is unknown. (Contact your Progress Technical Support representative if you receive this value.)

> The attribute string can contain any of the following file type characters:

> - H — If the file is hidden.
> - L — If the file is a symbolic link (UNIX systems).
> - P — If the file is a pipe file (UNIX systems).
> - R — If the file is readable.
> - W — If the file is writable.
> - The FULL-PATHNAME attribute returns the absolute pathname of the file specified in the FILE-NAME attribute.

> - If the FILE-NAME attribute contains a simple filename or relative pathname, the PATHNAME attribute contains the pathname of the specified file starting with the directory on the `PROPATH` where it is found. Otherwise, the PATHNAME attribute contains the absolute pathname specified in the FILE-NAME attribute.

> - The TYPE attribute returns the widget type, PSEUDO-WIDGET.

Copyright © 2005 Progress Software Corporation www.progress.com Voice: (781) 280-4000 Fax: (781) 280-4095