A content type is a platform specific string that defines the type of a file. More...

Functions
GIOMM_API bool	Gio::content_type_equals (const Glib::ustring & type1, const Glib::ustring & type2)
	Compares two content types for equality.

GIOMM_API bool	Gio::content_type_is_a (const Glib::ustring & type, const Glib::ustring & supertype)
	Determines if type is a subset of supertype.

GIOMM_API bool	Gio::content_type_is_unknown (const Glib::ustring & type)
	Checks if the content type is the generic "unknown" type.

GIOMM_API Glib::ustring	Gio::content_type_get_description (const Glib::ustring & type)
	Gets the human readable description of the content type.

GIOMM_API Glib::ustring	Gio::content_type_get_mime_type (const Glib::ustring & type)
	Gets the mime-type for the content type, if one is registered.

GIOMM_API Glib::RefPtr< Icon >	Gio::content_type_get_icon (const Glib::ustring & type)
	Gets the icon for a content type.

GIOMM_API Glib::RefPtr< Icon >	Gio::content_type_get_symbolic_icon (const Glib::ustring & type)
	Gets the symbolic icon for a content type.

GIOMM_API bool	Gio::content_type_can_be_executable (const Glib::ustring & type)
	Checks if a content type can be executable.

GIOMM_API Glib::ustring	Gio::content_type_from_mime_type (const Glib::ustring & mime_type)
	Tries to find a content type based on the mime type name.

GIOMM_API Glib::ustring	Gio::content_type_guess (const std::string & filename, const guchar *data, gsize data_size, bool & result_uncertain)
	Guesses the content type based on example data.

GIOMM_API Glib::ustring	Gio::content_type_guess (const std::string & filename, const std::string &data, bool & result_uncertain)
	Guesses the content type based on example data.

GIOMM_API Glib::StringArrayHandle	Gio::content_type_guess_for_tree (const Glib::RefPtr< const File > & root)
	Tries to guess the type of the tree with root root, by looking at the files it contains.

GIOMM_API Glib::ListHandle< Glib::ustring >	Gio::content_types_get_registered ()
	Gets a list of strings containing all the registered content types known to the system.

Detailed Description

A content type is a platform specific string that defines the type of a file.

On UNIX it is a mime type like "text/plain" or "image/png". On Win32 it is an extension string like ".doc", ".txt" or a perceived string like "audio". Such strings can be looked up in the registry at HKEY_CLASSES_ROOT.

Function Documentation

◆ content_type_can_be_executable()

GIOMM_API bool Gio::content_type_can_be_executable ( const Glib::ustring & 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).

Parameters

type	a content type string.

Returns: true if the file type corresponds to a type that can be executable, false otherwise.

◆ content_type_equals()

GIOMM_API bool Gio::content_type_equals	(	const Glib::ustring &	type1,
		const Glib::ustring &	type2 )

Compares two content types for equality.

Parameters

type1	A content type string.
type2	A content type string.

Returns: true if the two strings are identical or equivalent, false otherwise.

◆ content_type_from_mime_type()

GIOMM_API Glib::ustring Gio::content_type_from_mime_type ( const Glib::ustring & mime_type )

Tries to find a content type based on the mime type name.

Parameters

mime_type a mime type string.

Returns: string with content type or empty when it does not know.

Since glibmm 2.20

◆ content_type_get_description()

GIOMM_API Glib::ustring Gio::content_type_get_description ( const Glib::ustring & type )

Gets the human readable description of the content type.

Parameters

type	A content type string.

Returns: a short description of the content type type.

◆ content_type_get_icon()

GIOMM_API Glib::RefPtr< Icon > Gio::content_type_get_icon ( const Glib::ustring & type )

Gets the icon for a content type.

Parameters

type	A content type string.

Returns: Icon corresponding to the content type.

◆ content_type_get_mime_type()

GIOMM_API Glib::ustring Gio::content_type_get_mime_type ( const Glib::ustring & type )

Gets the mime-type for the content type, if one is registered.

Parameters

type	A content type string.

Returns: the registered mime-type for the given type, or an empty string if unknown.

◆ content_type_get_symbolic_icon()

GIOMM_API Glib::RefPtr< Icon > Gio::content_type_get_symbolic_icon ( const Glib::ustring & type )

Gets the symbolic icon for a content type.

Parameters

type	A content type string.

Returns: symbolic Icon corresponding to the content type.

Since glibmm 2.34

◆ content_type_guess() [1/2]

GIOMM_API Glib::ustring Gio::content_type_guess	(	const std::string &	filename,
		const guchar *	data,
		gsize	data_size,
		bool &	result_uncertain )

Guesses the content type based on example data.

If the function is uncertain, result_uncertain will be set to true. Either filename may be an empty string or data may be 0, in which case the guess will be based solely on the other argument.

Parameters

	filename	a string.
	data	A stream of data.
	data_size	The size of data.
[out]	result_uncertain	A flag indicating the certainty of the result.

Returns: A string indicating a guessed content type for the given data.

◆ content_type_guess() [2/2]

GIOMM_API Glib::ustring Gio::content_type_guess	(	const std::string &	filename,
		const std::string &	data,
		bool &	result_uncertain )

Guesses the content type based on example data.

If the function is uncertain, result_uncertain will be set to true. filename may be an empty string, in which case the guess will be based solely on data.

Parameters

	filename	a string.
	data	A stream of data.
[out]	result_uncertain	A flag indicating the certainty of the result.

Returns: A string indicating a guessed content type for the given data.

◆ content_type_guess_for_tree()

GIOMM_API Glib::StringArrayHandle Gio::content_type_guess_for_tree ( const Glib::RefPtr< const File > & root )

Tries to guess the type of the tree with root root, by looking at the files it contains.

The result is a list of content types, with the best guess coming first.

The types returned all have the form x-content/foo, e.g. x-content/audio-cdda (for audio CDs) or x-content/image-dcf (for a camera memory card). See the shared-mime-info specification for more on x-content types.

Parameters

root	The root of the tree to guess a type for.

Returns: List of zero or more content types.

Since glibmm 2.18

◆ content_type_is_a()

GIOMM_API bool Gio::content_type_is_a	(	const Glib::ustring &	type,
		const Glib::ustring &	supertype )

Determines if type is a subset of supertype.

Parameters

type	A content type string.
supertype	A content type string.

Returns: true if type is a kind of supertype, false otherwise.

◆ content_type_is_unknown()

GIOMM_API bool Gio::content_type_is_unknown ( const Glib::ustring & 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 "*".

Parameters

type	A content type string.

Returns: true if the type is the unknown type.

◆ content_types_get_registered()

GIOMM_API Glib::ListHandle< Glib::ustring > Gio::content_types_get_registered ( )

Gets a list of strings containing all the registered content types known to the system.

Returns: List of the registered content types.

Functions

Detailed Description

Function Documentation

◆ content_type_can_be_executable()

◆ content_type_equals()

◆ content_type_from_mime_type()

◆ content_type_get_description()

◆ content_type_get_icon()

◆ content_type_get_mime_type()

◆ content_type_get_symbolic_icon()

◆ content_type_guess() [1/2]

◆ content_type_guess() [2/2]

◆ content_type_guess_for_tree()

◆ content_type_is_a()

◆ content_type_is_unknown()

◆ content_types_get_registered()