Project

General

Profile

1
/*
2
This source file is part of Scol
3
For the latest info, see http://www.scolring.org
4

    
5
Copyright (c) 2010 Stephane Bisaro, aka Iri <iri@irizone.net>
6

    
7
This program is free software; you can redistribute it and/or modify it under
8
the terms of the GNU Lesser General Public License as published by the Free Software
9
Foundation; either version 2 of the License, or (at your option) any later
10
version.
11

    
12
This program is distributed in the hope that it will be useful, but WITHOUT
13
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14
FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
15

    
16
You should have received a copy of the GNU Lesser General Public License along with
17
this program; if not, write to the Free Software Foundation, Inc., 59 Temple
18
Place - Suite 330, Boston, MA 02111-1307, USA, or go to
19
http://www.gnu.org/copyleft/lesser.txt
20

    
21
For others informations, please contact us from http://www.scolring.org/
22
*/
23

    
24

    
25
#include "../include/scol_glib_misc.h"
26

    
27

    
28
/**
29
 * \brief Returns the name of the executable Scol. The filename should NOT be freed
30
 * It should return "scol.exe" (or "unsmwin.exe" on the old Scol version) on MS Windows
31
 * On GNU/ Linux, it should return "scol" or "usmunix"
32
 * \return gchar * : this filename
33
 */
34
const gchar * scol_glib_name_scolexe ()
35
{
36
    return g_get_application_name ();
37
}
38

    
39
/**
40
 * \brief Returns the filename of the current Scol. The filename should be freed with g_free
41
 * \return gchar * : this filename
42
 */
43
gchar * scol_glib_filename_scol ()
44
{
45
    return g_find_program_in_path (scol_glib_name_scolexe ());
46
}
47

    
48
/**
49
 * \brief Returns the directory of the current Scol. The filename should be freed with g_free
50
 * \return gchar * : this filename
51
 */
52
gchar * scol_glib_dirname_scol ()
53
{
54
    gchar * f = scol_glib_filename_scol ();
55
    gchar * p;
56

    
57
    p = g_path_get_dirname (f);
58
    g_free (f);
59
    return p;
60
}
61

    
62
/**
63
 * \brief Returns the basename of any filename. The result should be freed with g_free
64
 * \param : const gchar * : any filename
65
 * \return gchar * : this base name
66
 */
67
gchar * scol_glib_basename (const gchar *f)
68
{
69
    return g_path_get_basename (f);
70
}
71

    
72
/**
73
 * \brief Returns the value of any environment variable or NULL if not found
74
 * \param  const gchar * : an environment variable, without "$" on Linux and without "%" on Windows
75
 * \return const gchar * : the value or NULL if not ound
76
 * This is an alias of g_getenv ()
77
 * The result should not be freed
78
 */
79
const gchar * scol_glib_get_env (const gchar *v)
80
{
81
    return g_getenv (v);
82
}
83

    
84
/**
85
 * \brief Returns the name ofthe current user
86
 * \return const gchar * : the name
87
 * This is an alias of g_get_user_name ()
88
 */
89
const gchar * scol_glib_get_username ()
90
{
91
   return g_get_user_name ();
92
}
93

    
94
/**
95
 * \brief Returns the host name. Don't free !
96
 * \return const gchar * : the result.
97
 */
98
const gchar * scol_glib_get_hostname ()
99
{
100
    return g_get_host_name ();
101
}
102

    
103
/**
104
 * \brief Returns TRUE if the given path is an absolute path, otherwise FALSE
105
 * \param const gchar * : any path
106
 * \return gboolean
107
 */
108
gboolean scol_glib_isabsolutepath (const gchar * p)
109
{
110
    return g_path_is_absolute (p);
111
}
112

    
113
/**
114
 * \brief Returns a string with an easy sizenumber (from bytes to KB, MO, ..)
115
 * \param int : an integer (by example a Scol value)
116
 * \return char *
117
 * The result should be freed with g_free
118
 */
119
char * scol_glib_get_sizefordisplay (int v)
120
{
121
    return g_format_size_for_display ((goffset) v);
122
}
123

    
124

    
125

    
(1-1/2)