summaryrefslogtreecommitdiff
path: root/documentation
diff options
context:
space:
mode:
authorMatthias Melcher <fltk@matthiasm.com>2007-01-22 11:14:29 +0000
committerMatthias Melcher <fltk@matthiasm.com>2007-01-22 11:14:29 +0000
commite4586d1572fe52fa16f5a6538f215e7d45c898af (patch)
treef043ad575b969d9223ce927229df414d6612d35a /documentation
parent9e79fd13d2b56f25e893298e6476f2a858f6adf6 (diff)
Removed 'optimization' for fl_filename_isdir which would break the original purpose of the fuction (testing the *existence* of a directory). But I did not want to lose the performance in the directory chooser where I *know* that a directory exists, just not if it is a file or directory, so I added the function fl_filename_isdir_quick() to do just that. Please verify that the new version works as expected, especially with regard to the directory chooser.
git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@5630 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation')
-rw-r--r--documentation/functions.html34
1 files changed, 32 insertions, 2 deletions
diff --git a/documentation/functions.html b/documentation/functions.html
index 35c285aa9..c7d8b9e9f 100644
--- a/documentation/functions.html
+++ b/documentation/functions.html
@@ -58,11 +58,11 @@ A</A>.
<LI><A HREF="drawing.html#fl_draw_image"><TT>fl_draw_image</TT></A></LI>
<LI><A HREF="drawing.html#fl_draw_image"><TT>fl_draw_image_mono</TT></A></LI>
<LI><A HREF="drawing.html#fl_draw_pixmap"><TT>fl_draw_pixmap</TT></A></LI>
+ <LI><A HREF="common.html#fl_draw_symbol"><TT>fl_draw_symbol</TT></A></LI>
</UL>
</TD>
<TD width=33%>
<UL>
- <LI><A HREF="common.html#fl_draw_symbol"><TT>fl_draw_symbol</TT></A></LI>
<LI><A HREF="drawing.html#fl_begin_complex_polygon"><TT>fl_end_complex_polygon</TT></A></LI>
<LI><A HREF="drawing.html#fl_begin_line"><TT>fl_end_line</TT></A></LI>
<LI><A HREF="drawing.html#fl_begin_loop"><TT>fl_end_loop</TT></A></LI>
@@ -76,6 +76,7 @@ A</A>.
<LI><A HREF="#fl_filename_expand"><TT>fl_filename_expand</TT></A></LI>
<LI><A HREF="#fl_filename_ext"><TT>fl_filename_ext</TT></A></LI>
<LI><A HREF="#fl_filename_isdir"><TT>fl_filename_isdir</TT></A></LI>
+ <LI><A HREF="#fl_filename_isdir_quick"><TT>fl_filename_isdir_quick</TT></A></LI>
<LI><A HREF="#fl_filename_list"><TT>fl_filename_list</TT></A></LI>
<LI><A HREF="#fl_filename_match"><TT>fl_filename_match</TT></A></LI>
<LI><A HREF="#fl_filename_name"><TT>fl_filename_name</TT></A></LI>
@@ -104,11 +105,11 @@ A</A>.
<LI><A HREF="drawing.html#fl_measure_pixmap"><TT>fl_measure_pixmap</TT></A></LI>
<LI><A HREF="#fl_message"><TT>fl_message</TT></A></LI>
<LI><A HREF="#fl_message_font"><TT>fl_message_font</TT></A></LI>
+ <LI><A HREF="#fl_message_icon"><TT>fl_message_icon</TT></A></LI>
</UL>
</TD>
<TD width=30%>
<UL>
- <LI><A HREF="#fl_message_icon"><TT>fl_message_icon</TT></A></LI>
<LI><A HREF="drawing.html#fl_scale"><TT>fl_mult_matrix</TT></A></LI>
<LI><A HREF="drawing.html#fl_not_clipped"><TT>fl_not_clipped</TT></A></LI>
<LI><A HREF="#fl_numericsort"><TT>fl_numericsort</TT></A></LI>
@@ -309,6 +310,7 @@ A</A>.
<LI><A HREF="#fl_filename_expand"><TT>fl_filename_expand</TT></A></LI>
<LI><A HREF="#fl_filename_ext"><TT>fl_filename_ext</TT></A></LI>
<LI><A HREF="#fl_filename_isdir"><TT>fl_filename_isdir</TT></A></LI>
+ <LI><A HREF="#fl_filename_isdir_quick"><TT>fl_filename_isdir_quick</TT></A></LI>
<LI><A HREF="#fl_filename_list"><TT>fl_filename_list</TT></A></LI>
<LI><A HREF="#fl_filename_match"><TT>fl_filename_match</TT></A></LI>
<LI><A HREF="#fl_filename_name"><TT>fl_filename_name</TT></A></LI>
@@ -935,6 +937,34 @@ int fl_filename_isdir(const char *f);
<!-- NEED 4in -->
+<H2><A NAME="fl_filename_isdir_quick">fl_filename_isdir_quick</A></H2>
+
+<HR>
+
+<H3>Include Files</H3>
+
+<UL><PRE>
+#include &lt;FL/filename.H&gt;
+</PRE></UL>
+
+<H3>Prototype</H3>
+
+<UL><PRE>
+int fl_filename_isdir_quick(const char *f);
+</PRE></UL>
+
+<H3>Description</H3>
+
+<P>Returns non-zero if the file is a directory. If the
+filename ends in a directory seperator (usually the
+slash '/'), the existence of the directory will not
+be verified and '1' is returned. This is much faster
+than <tt>fl_filename_isdir</tt> if the file is known
+to exist, because its filename was obtained via
+<tt>fl_filename_list</tt> or similar.
+
+
+<!-- NEED 4in -->
<H2><A NAME="fl_filename_list">fl_filename_list</A></H2>
<HR>