|
|
|
GIO Reference Manual | |
|---|---|---|---|---|
#include <gio/gio.h> gboolean g_content_type_equals (const char *type1, const char *type2); gboolean g_content_type_is_a (const char *type, const char *supertype); gboolean g_content_type_is_unknown (const char *type); char* g_content_type_get_description (const char *type); char* g_content_type_get_mime_type (const char *type); GIcon* g_content_type_get_icon (const char *type); gboolean g_content_type_can_be_executable (const char *type); char* g_content_type_guess (const char *filename, const guchar *data, gsize data_size, gboolean *result_uncertain); GList* g_content_types_get_registered (void);
A content type is a platform specific string that defines the type of a file. On unix it is a mime type, on win32 it is an extension string like ".doc", ".txt" or a percieved string like "audio". Such strings can be looked up in the registry at HKEY_CLASSES_ROOT.
gboolean g_content_type_equals (const char *type1,
const char *type2);
Compares two content types for equality.
| type1 : | a content type string. |
| type2 : | a content type string. |
| Returns : | TRUE if the two strings are identical or equivalent, FALSE otherwise. |
gboolean g_content_type_is_a (const char *type,
const char *supertype);
Determines if type is a subset of supertype.
| type : | a content type string. |
| supertype : | a string. |
| Returns : | TRUE if type is a kind of supertype, FALSE otherwise. |
gboolean g_content_type_is_unknown (const char *type);
Checks if the content type is the generic "unknown" type. On unix this is the "application/octet-stream" mimetype, while on win32 it is "*".
| type : | a content type string. |
| Returns : | TRUE if the type is the unknown type. |
char* g_content_type_get_description (const char *type);
Gets the human readable description of the content type.
| type : | a content type string. |
| Returns : | a short description of the content type type. |
char* g_content_type_get_mime_type (const char *type);
Gets the mime-type for the content type. If one is registered
| type : | a content type string. |
| Returns : | the registered mime-type for the given type, or NULL if unknown. |
GIcon* g_content_type_get_icon (const char *type);
Gets the icon for a content type.
| type : | a content type string. |
| Returns : | GIcon corresponding to the content type. |
gboolean g_content_type_can_be_executable (const char *type);
Checks if a content type can be executable. Note that for instance things like text files can be executables (i.e. scripts and batch files).
| type : | a content type string. |
| Returns : | TRUE if the file type corresponds to a type that can be executable, FALSE otherwise. |
char* g_content_type_guess (const char *filename,
const guchar *data,
gsize data_size,
gboolean *result_uncertain);
Guesses the content type based on example data. If the function is uncertain, result_uncertain will be set to TRUE.
| filename : | a string. |
| data : | a stream of data. |
| data_size : | the size of data. |
| result_uncertain : | a flag indicating the certainty of the result. |
| Returns : | a string indicating a guessed content type for the given data. |
GList* g_content_types_get_registered (void);
Gets a list of strings containing all the registered content types known to the system. The list and its data should be freed using g_list_foreach(list, g_free, NULL) and g_list_free(list)
| Returns : | GList of the registered content types. |