Availability:C-language interface function
bool 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
buffer stack described with the PL_get_chars()
option BUF_STACK, which is popped upon return from the
foreign predicate to Prolog. Conversion from the internal UNICODE
encoding is done using standard C library functions. flags is
a bit-mask controlling the conversion process. On failure, PL_FILE_NOERRORS
controls whether an exception is raised. 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,
\/
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.
