|  |  |  | GtkSourceView 3 Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <gtksourceview/gtksourcelanguage.h> struct GtkSourceLanguage; const gchar * gtk_source_language_get_id (GtkSourceLanguage *language); const gchar * gtk_source_language_get_name (GtkSourceLanguage *language); const gchar * gtk_source_language_get_section (GtkSourceLanguage *language); gboolean gtk_source_language_get_hidden (GtkSourceLanguage *language); const gchar * gtk_source_language_get_metadata (GtkSourceLanguage *language,const gchar *name); gchar ** gtk_source_language_get_mime_types (GtkSourceLanguage *language); gchar ** gtk_source_language_get_globs (GtkSourceLanguage *language); const gchar * gtk_source_language_get_style_name (GtkSourceLanguage *language,const gchar *style_id); gchar ** gtk_source_language_get_style_ids (GtkSourceLanguage *language);
GtkSourceLanguage encapsulates syntax and highlighting styles for a
particular language. Use GtkSourceLanguageManager to obtain a
GtkSourceLanguage instance, and gtk_source_buffer_set_language() to apply it
to a GtkSourceBuffer.
const gchar *       gtk_source_language_get_id          (GtkSourceLanguage *language);
Returns the ID of the language. The ID is not locale-dependent.
The returned string is owned by language and should not be freed
or modified.
| 
 | a GtkSourceLanguage. | 
| Returns : | the ID of language. | 
const gchar *       gtk_source_language_get_name        (GtkSourceLanguage *language);
Returns the localized name of the language.
The returned string is owned by language and should not be freed
or modified.
| 
 | a GtkSourceLanguage. | 
| Returns : | the name of language. | 
const gchar *       gtk_source_language_get_section     (GtkSourceLanguage *language);
Returns the localized section of the language.
Each language belong to a section (ex. HTML belogs to the
Markup section).
The returned string is owned by language and should not be freed
or modified.
| 
 | a GtkSourceLanguage. | 
| Returns : | the section of language. | 
gboolean            gtk_source_language_get_hidden      (GtkSourceLanguage *language);
Returns whether the language should be hidden from the user.
| 
 | a GtkSourceLanguage | 
| Returns : | TRUEif the language should be hidden,FALSEotherwise. | 
const gchar * gtk_source_language_get_metadata (GtkSourceLanguage *language,const gchar *name);
| 
 | a GtkSourceLanguage. | 
| 
 | metadata property name. | 
| Returns : | value of property namestored in the metadata oflanguageorNULLif language doesn't contain that metadata property.
The returned string is owned bylanguageand should not be freed
or modified. | 
gchar **            gtk_source_language_get_mime_types  (GtkSourceLanguage *language);
Returns the mime types associated to this language. This is just
an utility wrapper around gtk_source_language_get_metadata() to
retrieve the "mimetypes" metadata property and split it into an
array.
| 
 | a GtkSourceLanguage. | 
| Returns : | a newly-allocated NULLterminated array containing the mime types orNULLif no
mime types are found.
The returned array must be freed withg_strfreev(). [array zero-terminated=1][transfer full] | 
gchar **            gtk_source_language_get_globs       (GtkSourceLanguage *language);
Returns the globs associated to this language. This is just
an utility wrapper around gtk_source_language_get_metadata() to
retrieve the "globs" metadata property and split it into an array.
| 
 | a GtkSourceLanguage. | 
| Returns : | a newly-allocated NULLterminated array containing the globs orNULLif no globs are found.
The returned array must be freed withg_strfreev(). [array zero-terminated=1][transfer full] | 
const gchar * gtk_source_language_get_style_name (GtkSourceLanguage *language,const gchar *style_id);
Returns the name of the style with ID style_id defined by this language.
| 
 | a GtkSourceLanguage. | 
| 
 | a style ID. | 
| Returns : | the name of the style with ID style_iddefined by thislanguageorNULLif the style has no name or there is no style with IDstyle_iddefined
by thislanguage. The returned string is owned by thelanguageand must
not be modified. | 
gchar **            gtk_source_language_get_style_ids   (GtkSourceLanguage *language);
Returns the ids of the styles defined by this language.
| 
 | a GtkSourceLanguage. | 
| Returns : | a NULLterminated
array containing ids of the styles defined by thislanguageorNULLif no style is defined.
The returned array must be freed withg_strfreev(). [array zero-terminated=1][transfer full] |