Availability:C-language interface function
int PL_get_file_name(term_t
spec, char **name, int flags)Translate a Prolog term into a file name. The name is stored in the
static buffer ring described with th PL_get_chars()
option
BUF_RING
. Conversion from the internal UNICODE encoding is
done using standard C library functions. flags is a bit-mask
controlling the conversion process. Options are:
PL_FILE_ABSOLUTE
- Return an absolute path to the requested file.
PL_FILE_OSPATH
- Return the name using the hosting OS conventions. On MS-Windows,
\
is used to separate directories rather than
the canonical
/
.
PL_FILE_SEARCH
- Invoke absolute_file_name/3.
This implies rules from file_search_path/2
are used.
PL_FILE_EXIST
- Demand the path to refer to an existing entity.
PL_FILE_READ
- Demand read-access on the result.
PL_FILE_WRITE
- Demand write-access on the result.
PL_FILE_EXECUTE
- Demand execute-access on the result.
PL_FILE_NOERRORS
- Do not raise any exceptions.