<!DOCTYPE File PUBLIC "-//Liam Quin//DTD C API Documentation v1.1//EN" "doc.dtd"><File>
<Entry dir="liblqutil">
<Function File="../../src/liblqutil/isfile.c">
<Name>LQU_IsFile</Name>
<Class>Utilities/Files
<Purpose>
<P>Determines whether the given Path refers to a regular file.
Devices (such as /dev/null or a terminal), and directories in
particular are not regular files.  The Unix command</P>
<P>find filename -type f -print</P>
<P>will print out filename if and only if LQU_IsFile would
return 1 for the same filename.
<Returns>
<LIST>
  <LI>1 if the given Path represents a regular file</LI>
  <LI>zero otherwise</LI>
</LIST>
<Notes>
<P>There is tracing in here so that you can see which files are being
investigated by the calling program; tracing is available if
the liblqutil library was compiled with -DASCIITRACE; if so, you
can set the FindFile trace flag (LQTRACE_FINDFILE) to see tracing for
this routine.
The -t "FindFile|Verbose" command-line option will do this.</P>
<P>On systems that have the trace, strace or truss utility,
investigate using that instead.</P>
</Notes>
</Function>
<Decl>
API int
LQU_IsFile(Path)
    CONST char *Path;
</Decl>
</Entry>
