<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
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
365
