<HTML ><HEAD ><TITLE >gnome-util</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK REL="HOME" TITLE="Gnome Library Reference Manual" HREF="book1.html"><LINK REL="UP" TITLE="Gnome Library" HREF="libgnome.html"><LINK REL="PREVIOUS" TITLE="gnome-url" HREF="gnome-gnome-url.html"><LINK REL="NEXT" TITLE="libgnome" HREF="gnome-libgnome.html"></HEAD ><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF" ><DIV CLASS="NAVHEADER" ><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TH COLSPAN="4" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="5" >Gnome Library Reference Manual</FONT ></TH ></TR ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-url.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ></TABLE ></DIV ><H1 ><A NAME="GNOME-GNOME-UTIL" >gnome-util</A ></H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN4387" ></A ><H2 >Name</H2 >gnome-util -- Miscellaneous utility functions for GNOME and C programs.</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN4390" ></A ><H2 >Synopsis</H2 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="SYNOPSIS" > #include <gnome.h> #define <A HREF="gnome-gnome-util.html#PATH-SEP-CAPS" >PATH_SEP</A > #define <A HREF="gnome-gnome-util.html#PATH-SEP-STR-CAPS" >PATH_SEP_STR</A > char* <A HREF="gnome-gnome-util.html#GNOME-LIBDIR-FILE" >gnome_libdir_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-DATADIR-FILE" >gnome_datadir_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-SOUND-FILE" >gnome_sound_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-PIXMAP-FILE" >gnome_pixmap_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-CONFIG-FILE" >gnome_config_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-UNCONDITIONAL-LIBDIR-FILE" >gnome_unconditional_libdir_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-UNCONDITIONAL-DATADIR-FILE" >gnome_unconditional_datadir_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-UNCONDITIONAL-SOUND-FILE" >gnome_unconditional_sound_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-UNCONDITIONAL-PIXMAP-FILE" >gnome_unconditional_pixmap_file</A > (const char *filename); char* <A HREF="gnome-gnome-util.html#GNOME-UNCONDITIONAL-CONFIG-FILE" >gnome_unconditional_config_file</A > (const char *filename); int <A HREF="gnome-gnome-util.html#G-FILE-TEST" >g_file_test</A > (const char *filename, int test); int <A HREF="gnome-gnome-util.html#G-FILE-EXISTS" >g_file_exists</A > (const char *filename); #define <A HREF="gnome-gnome-util.html#G-COPY-STRINGS" >g_copy_strings</A > const char* <A HREF="gnome-gnome-util.html#G-UNIX-ERROR-STRING" >g_unix_error_string</A > (int error_num); char* <A HREF="gnome-gnome-util.html#G-CONCAT-DIR-AND-FILE" >g_concat_dir_and_file</A > (const char *dir, const char *file); #define <A HREF="gnome-gnome-util.html#G-FILENAME-INDEX" >g_filename_index</A > (path) #define <A HREF="gnome-gnome-util.html#G-FILENAME-POINTER" >g_filename_pointer</A > const char* <A HREF="gnome-gnome-util.html#G-EXTENSION-POINTER" >g_extension_pointer</A > (const char *path); char** <A HREF="gnome-gnome-util.html#G-COPY-VECTOR" >g_copy_vector</A > (char **vec); #define <A HREF="gnome-gnome-util.html#G-FLATTEN-VECTOR" >g_flatten_vector</A > #define <A HREF="gnome-gnome-util.html#GNOME-UTIL-USER-HOME" >gnome_util_user_home</A > () #define <A HREF="gnome-gnome-util.html#GNOME-UTIL-PREPEND-USER-HOME" >gnome_util_prepend_user_home</A > (x) #define <A HREF="gnome-gnome-util.html#GNOME-UTIL-HOME-FILE" >gnome_util_home_file</A > (afile) char* <A HREF="gnome-gnome-util.html#GNOME-UTIL-USER-SHELL" >gnome_util_user_shell</A > (void); <GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > <A HREF="gnome-gnome-util.html#G-IS-IMAGE-FILENAME" >g_is_image_filename</A > (const char *path);</PRE ></TD ></TR ></TABLE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4421" ></A ><H2 >Description</H2 ><P ></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN4424" ></A ><H2 >Details</H2 ><DIV CLASS="REFSECT2" ><A NAME="AEN4426" ></A ><H3 ><A NAME="PATH-SEP-CAPS" ></A >PATH_SEP</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define PATH_SEP '/'</PRE ></TD ></TR ></TABLE ><P >A <SPAN CLASS="TYPE" >int</SPAN > macro that represents the character used as the path separator in this operating system</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4432" ></A ><H3 ><A NAME="PATH-SEP-STR-CAPS" ></A >PATH_SEP_STR</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define PATH_SEP_STR "/"</PRE ></TD ></TR ></TABLE ><P >A <SPAN CLASS="TYPE" >char *</SPAN > string that represents the character used as the path separator in this operating system. This comes in string fashion.</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4438" ></A ><H3 ><A NAME="GNOME-LIBDIR-FILE" ></A >gnome_libdir_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_libdir_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P >Locates a shared file either in the GNOMEDIR tree, the GNOME installation directory or in the current directory</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4444" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > filename to locate in libdir</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated pathname pointing to a file in the gnome libdir or NULL if the file does not exist.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4457" ></A ><H3 ><A NAME="GNOME-DATADIR-FILE" ></A >gnome_datadir_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_datadir_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P >Locates a shared file either in the GNOMEDIR tree, the GNOME installation directory or in the current directory</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4463" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > shared filename to locate</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated pathname pointing to a file in the gnome sharedir or NULL if the file does not exist.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4476" ></A ><H3 ><A NAME="GNOME-SOUND-FILE" ></A >gnome_sound_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_sound_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P >Locates a sound file either in the GNOMEDIR tree, the GNOME installation directory or in the current directory</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4482" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > sound filename to locate.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated pathname pointing to a file in the gnome sound directory or NULL if the file does not exist.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4495" ></A ><H3 ><A NAME="GNOME-PIXMAP-FILE" ></A >gnome_pixmap_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_pixmap_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4501" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > pixmap filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated filename from the GNOMEDIR tree or from the GNOME installation directory for the pixmap directory ($prefix/share/pixmaps), or NULL if the file does not exist.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4514" ></A ><H3 ><A NAME="GNOME-CONFIG-FILE" ></A >gnome_config_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_config_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P >Locates a configuration file ($prefix/etc) in the GNOMEDIR tree, the GNOME installation direcory or the current directory.</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4520" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > config filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated filename from the GNOMEDIR tree or from the GNOME installation directory</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4533" ></A ><H3 ><A NAME="GNOME-UNCONDITIONAL-LIBDIR-FILE" ></A >gnome_unconditional_libdir_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_unconditional_libdir_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4539" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > library filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated pathname pointing to a (possibly non-existent) file from the GNOMEDIR tree or from the GNOME installation directory</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4552" ></A ><H3 ><A NAME="GNOME-UNCONDITIONAL-DATADIR-FILE" ></A >gnome_unconditional_datadir_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_unconditional_datadir_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4558" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > datadir filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated pathname pointing to a (possibly non-existent) file from the GNOMEDIR tree or from the GNOME installation directory</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4571" ></A ><H3 ><A NAME="GNOME-UNCONDITIONAL-SOUND-FILE" ></A >gnome_unconditional_sound_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_unconditional_sound_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4577" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > sound filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated filename from the GNOMEDIR tree or from the GNOME installation directory</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4590" ></A ><H3 ><A NAME="GNOME-UNCONDITIONAL-PIXMAP-FILE" ></A >gnome_unconditional_pixmap_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_unconditional_pixmap_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4596" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > pixmap filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated filename from the GNOMEDIR tree or from the GNOME installation directory for the pixmap directory ($prefix/share/pixmaps)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4609" ></A ><H3 ><A NAME="GNOME-UNCONDITIONAL-CONFIG-FILE" ></A >gnome_unconditional_config_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_unconditional_config_file (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4615" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > configuration filename</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated filename pointing to a (possibly non-existent) file from the GNOMEDIR tree or from the GNOME installation directory for the configuration directory ($prefix/etc).</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4628" ></A ><H3 ><A NAME="G-FILE-TEST" ></A >g_file_test ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >int g_file_test (const char *filename, int test);</PRE ></TD ></TR ></TABLE ><P >test is one of: G_FILE_TEST_ISFILE, to check if the pathname is a file G_FILE_TEST_ISLINK, to check if the pathname is a symlink G_FILE_TEST_ISDIR, to check if the pathname is a directory</P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4634" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > filename to test</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >test</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > test to perform on the file</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >true if filename passes the specified test (an or expression of tests)</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4651" ></A ><H3 ><A NAME="G-FILE-EXISTS" ></A >g_file_exists ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >int g_file_exists (const char *filename);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4657" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >filename</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > pathname to test for existance.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >true if filename exists left in for binary compatibility for a while FIXME: remove</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4670" ></A ><H3 ><A NAME="G-COPY-STRINGS" ></A >g_copy_strings</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define g_copy_strings</PRE ></TD ></TR ></TABLE ><P ></P ><P >Deprecated. Use <TT CLASS="FUNCTION" ><GTKDOCLINK HREF="G-STRCONCAT" >g_strconcat</GTKDOCLINK >()</TT >.</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4678" ></A ><H3 ><A NAME="G-UNIX-ERROR-STRING" ></A >g_unix_error_string ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const char* g_unix_error_string (int error_num);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4684" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >error_num</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > The errno number.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a pointer to a static buffer containing the description of the error reported by the errno.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4697" ></A ><H3 ><A NAME="G-CONCAT-DIR-AND-FILE" ></A >g_concat_dir_and_file ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* g_concat_dir_and_file (const char *dir, const char *file);</PRE ></TD ></TR ></TABLE ><P ></P ><P ></P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4703" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >dir</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > directory name</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >file</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > filename.</TD ></TR ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a new allocated string that is the concatenation of dir and file, takes care of the exact details for concatenating them.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4720" ></A ><H3 ><A NAME="G-FILENAME-INDEX" ></A >g_filename_index()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define g_filename_index(path)</PRE ></TD ></TR ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4724" ></A ><H3 ><A NAME="G-FILENAME-POINTER" ></A >g_filename_pointer</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define g_filename_pointer</PRE ></TD ></TR ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4728" ></A ><H3 ><A NAME="G-EXTENSION-POINTER" ></A >g_extension_pointer ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >const char* g_extension_pointer (const char *path);</PRE ></TD ></TR ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4732" ></A ><H3 ><A NAME="G-COPY-VECTOR" ></A >g_copy_vector ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char** g_copy_vector (char **vec);</PRE ></TD ></TR ></TABLE ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4736" ></A ><H3 ><A NAME="G-FLATTEN-VECTOR" ></A >g_flatten_vector</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define g_flatten_vector</PRE ></TD ></TR ></TABLE ><P >Deprecated. Use <TT CLASS="FUNCTION" ><GTKDOCLINK HREF="G-STRJOINV" >g_strjoinv</GTKDOCLINK >()</TT >.</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4743" ></A ><H3 ><A NAME="GNOME-UTIL-USER-HOME" ></A >gnome_util_user_home()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define gnome_util_user_home()</PRE ></TD ></TR ></TABLE ><P >Deprecated. Use <TT CLASS="FUNCTION" ><GTKDOCLINK HREF="G-GET-HOME-DIR" >g_get_home_dir</GTKDOCLINK >()</TT >.</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4750" ></A ><H3 ><A NAME="GNOME-UTIL-PREPEND-USER-HOME" ></A >gnome_util_prepend_user_home()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define gnome_util_prepend_user_home(x)</PRE ></TD ></TR ></TABLE ><P >Deprecated. Use <TT CLASS="FUNCTION" ><GTKDOCLINK HREF="G-GET-HOME-DIR" >g_get_home_dir</GTKDOCLINK >()</TT > and <TT CLASS="FUNCTION" ><A HREF="gnome-gnome-util.html#G-CONCAT-DIR-AND-FILE" >g_concat_dir_and_file</A >()</TT >.</P ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4759" ></A ><H3 ><A NAME="GNOME-UTIL-HOME-FILE" ></A >gnome_util_home_file()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >#define gnome_util_home_file(afile)</PRE ></TD ></TR ></TABLE ><P >Deprecated.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4764" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><TT CLASS="PARAMETER" ><I >afile</I ></TT > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" > </TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4773" ></A ><H3 ><A NAME="GNOME-UTIL-USER-SHELL" ></A >gnome_util_user_shell ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" >char* gnome_util_user_shell (void);</PRE ></TD ></TR ></TABLE ><P ></P ><P >Get the user's shell.</P ><DIV CLASS="INFORMALTABLE" ><A NAME="AEN4779" ></A ><P ></P ><TABLE BORDER="0" WIDTH="100%" BGCOLOR="#FFD0D0" CELLSPACING="0" CELLPADDING="4" CLASS="CALSTABLE" ><TBODY ><TR ><TD WIDTH="20%" ALIGN="RIGHT" VALIGN="TOP" ><SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >Returns</I ></SPAN > :</TD ><TD WIDTH="80%" ALIGN="LEFT" VALIGN="TOP" >a newly allocated string that is the path to the user's preferred shell.</TD ></TR ></TBODY ></TABLE ><P ></P ></DIV ></DIV ><HR><DIV CLASS="REFSECT2" ><A NAME="AEN4788" ></A ><H3 ><A NAME="G-IS-IMAGE-FILENAME" ></A >g_is_image_filename ()</H3 ><TABLE BORDER="0" BGCOLOR="#D6E8FF" WIDTH="100%" CELLPADDING="6" ><TR ><TD ><PRE CLASS="PROGRAMLISTING" ><GTKDOCLINK HREF="GBOOLEAN" >gboolean</GTKDOCLINK > g_is_image_filename (const char *path);</PRE ></TD ></TR ></TABLE ><P >Deprecated. Extra lame way of figuring if a filename is an image file. You should use the gnome_mime functions instead and match against "image/".</P ><P >Deprecated. Use gnome-mime stuff instead.</P ></DIV ></DIV ><DIV CLASS="NAVFOOTER" ><BR CLEAR="all"><BR><TABLE WIDTH="100%" BORDER="0" BGCOLOR="#000000" CELLPADDING="1" CELLSPACING="0" ><TR ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="left" ><A HREF="gnome-gnome-url.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><<< Previous Page</B ></FONT ></A ></TD ><TD WIDTH="25%" BGCOLOR="#0000C0" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="book1.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Home</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#00C000" ALIGN="center" ><FONT COLOR="#FFFFFF" SIZE="3" ><B ><A HREF="libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Up</B ></FONT ></A ></B ></FONT ></TD ><TD WIDTH="25%" BGCOLOR="#C00000" ALIGN="right" ><A HREF="gnome-libgnome.html" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >Next Page >>></B ></FONT ></A ></TD ></TR ><TR ><TD COLSPAN="2" ALIGN="left" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >gnome-url</B ></FONT ></TD ><TD COLSPAN="2" ALIGN="right" ><FONT COLOR="#FFFFFF" SIZE="3" ><B >libgnome</B ></FONT ></TD ></TR ></TABLE ></DIV ></BODY ></HTML >