<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>gtksourceviewmm: gtksourceview::SourceLanguageManager Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">gtksourceviewmm  <span id="projectnumber">2.10.3</span> </div> </td> </tr> </tbody> </table> </div> <!-- Generated by Doxygen 1.7.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><b>gtksourceview</b> </li> <li class="navelem"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">SourceLanguageManager</a> </li> </ul> </div> </div> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="#pub-static-methods">Static Public Member Functions</a> | <a href="#related">Related Functions</a> </div> <div class="headertitle"> <div class="title">gtksourceview::SourceLanguageManager Class Reference</div> </div> </div> <div class="contents"> <!-- doxytag: class="gtksourceview::SourceLanguageManager" --><!-- doxytag: inherits="Glib::Object" --> <p>Class which provides access to SourceLanguages. <a href="classgtksourceview_1_1SourceLanguageManager.html#details">More...</a></p> <p><code>#include <gtksourceviewmm/sourcelanguagemanager.h></code></p> <div class="dynheader"> Inheritance diagram for gtksourceview::SourceLanguageManager:</div> <div class="dyncontent"> <div class="center"><img src="classgtksourceview_1_1SourceLanguageManager__inherit__graph.png" border="0" usemap="#gtksourceview_1_1SourceLanguageManager_inherit__map" alt="Inheritance graph"/></div> <map name="gtksourceview_1_1SourceLanguageManager_inherit__map" id="gtksourceview_1_1SourceLanguageManager_inherit__map"> <area shape="rect" id="node2" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="98,155,192,181"/><area shape="rect" id="node4" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="82,80,208,107"/><area shape="rect" id="node6" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="88,5,203,32"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <p><a href="classgtksourceview_1_1SourceLanguageManager-members.html">List of all members.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a63dd41af1dd1f09e71f1ef45b8ba687d"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::gobj" ref="a63dd41af1dd1f09e71f1ef45b8ba687d" args="()" --> GtkSourceLanguageManager* </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a63dd41af1dd1f09e71f1ef45b8ba687d">gobj</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a3927f2fbc4bc109e71b76752090e148a"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::gobj" ref="a3927f2fbc4bc109e71b76752090e148a" args="() const " --> const GtkSourceLanguageManager* </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a3927f2fbc4bc109e71b76752090e148a">gobj</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GObject. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a91bc3123e3b269041c45ebd2be2e8cf6"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::gobj_copy" ref="a91bc3123e3b269041c45ebd2be2e8cf6" args="()" --> GtkSourceLanguageManager* </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a91bc3123e3b269041c45ebd2be2e8cf6">gobj_copy</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C instance. The caller is responsible for unrefing it. Use when directly setting fields in structs. <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#ad3047e8743806606f871a0a236330da5">get_search_path</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the list directories where language manager looks for language files. <a href="#ad3047e8743806606f871a0a236330da5"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#ad2f5485386567afd7cbe2dcf5abab5c2">set_search_path</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a>& dirs)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the list of directories where the language manager looks for language files. <a href="#ad2f5485386567afd7cbe2dcf5abab5c2"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a4de53693e4e2fa06793fed469206af95">reset_search_path</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Resets the list of directories where the language manager looks for language files to default. <a href="#a4de53693e4e2fa06793fed469206af95"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#ae2f8bbc44a3bdf95b7f382f72c58e4ed">get_language_ids</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the ids of the available languages. <a href="#ae2f8bbc44a3bdf95b7f382f72c58e4ed"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a496e3cd502f312382bc3b0f308cb2450">get_language</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& id)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> identified by the given <em>id</em> in the language manager. <a href="#a496e3cd502f312382bc3b0f308cb2450"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <br class="typebreak"/> <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a154ccde7d10b28543a8d417e7bd7b278">get_language</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& id) const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Gets the <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> identified by the given <em>id</em> in the language manager. <a href="#a154ccde7d10b28543a8d417e7bd7b278"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#aaa6b39338f48c2d7f3945d8ee4d0a7d4">guess_language</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& content_type)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Picks a <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> for given file name and content type, according to the information in lang files. <a href="#aaa6b39338f48c2d7f3945d8ee4d0a7d4"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< const <br class="typebreak"/> <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a3241e46f83441563c6c790d605857b91">guess_language</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& filename, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& content_type) const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Picks a <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> for given file name and content type, according to the information in lang files. <a href="#a3241e46f83441563c6c790d605857b91"></a><br/></td></tr> <tr><td colspan="2"><h2><a name="pub-static-methods"></a> Static Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/> < <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">SourceLanguageManager</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a3ffead44dc9678a566e4fb2221baf462">create</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new language manager. <a href="#a3ffead44dc9678a566e4fb2221baf462"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/> < <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">SourceLanguageManager</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a2d6a7a313c97b79a7964933b6896d2fe">get_default</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the default <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a> instance. <a href="#a2d6a7a313c97b79a7964933b6896d2fe"></a><br/></td></tr> <tr><td colspan="2"><h2><a name="related"></a> Related Functions</h2></td></tr> <tr><td class="ititle" colspan="2"><p>(Note that these are not member functions.) </p> </td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><br class="typebreak"/> < <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">gtksourceview::SourceLanguageManager</a> > </td><td class="memItemRight" valign="bottom"><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a7271447aa89374de1f068e051c9e63f1">wrap</a> (GtkSourceLanguageManager* object, bool take_copy=false)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a7271447aa89374de1f068e051c9e63f1"></a><br/></td></tr> </table> <hr/><a name="details" id="details"></a><h2>Detailed Description</h2> <div class="textblock"><p>Class which provides access to SourceLanguages. </p> <p><a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a> is a class which processes language description files and creates and stores <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> objects, and provides API to access them.</p> <p>Use <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a2d6a7a313c97b79a7964933b6896d2fe" title="Returns the default SourceLanguageManager instance.">get_default()</a> to retrieve the default instance of <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a>, and <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#aaa6b39338f48c2d7f3945d8ee4d0a7d4" title="Picks a SourceLanguage for given file name and content type, according to the information in lang fil...">guess_language()</a> to get a <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> for given file name and content type. </p> </div><hr/><h2>Member Function Documentation</h2> <a class="anchor" id="a3ffead44dc9678a566e4fb2221baf462"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::create" ref="a3ffead44dc9678a566e4fb2221baf462" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">SourceLanguageManager</a>> gtksourceview::SourceLanguageManager::create </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Creates a new language manager. </p> <p>If you do not need more than one language manager or a private language manager instance then use <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html#a2d6a7a313c97b79a7964933b6896d2fe" title="Returns the default SourceLanguageManager instance.">get_default()</a> instead.</p> <p>Returns: A <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a>. </p> </div> </div> <a class="anchor" id="a2d6a7a313c97b79a7964933b6896d2fe"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::get_default" ref="a2d6a7a313c97b79a7964933b6896d2fe" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">static <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">SourceLanguageManager</a>> gtksourceview::SourceLanguageManager::get_default </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [static]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Returns the default <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a> instance. </p> <p>Returns: A <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a>. </p> </div> </div> <a class="anchor" id="a496e3cd502f312382bc3b0f308cb2450"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::get_language" ref="a496e3cd502f312382bc3b0f308cb2450" args="(const Glib::ustring &id)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a>> gtksourceview::SourceLanguageManager::get_language </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>id</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Gets the <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> identified by the given <em>id</em> in the language manager. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">id</td><td>A language id.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a>, or empty <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a> if there is no language identified by the given <em>id</em>. </dd></dl> </div> </div> <a class="anchor" id="a154ccde7d10b28543a8d417e7bd7b278"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::get_language" ref="a154ccde7d10b28543a8d417e7bd7b278" args="(const Glib::ustring &id) const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a>> gtksourceview::SourceLanguageManager::get_language </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>id</em></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Gets the <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> identified by the given <em>id</em> in the language manager. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">id</td><td>A language id.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a>, or empty <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a> if there is no language identified by the given <em>id</em>. </dd></dl> </div> </div> <a class="anchor" id="ae2f8bbc44a3bdf95b7f382f72c58e4ed"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::get_language_ids" ref="ae2f8bbc44a3bdf95b7f382f72c58e4ed" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> gtksourceview::SourceLanguageManager::get_language_ids </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the ids of the available languages. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>An array of string containing the ids of the available languages. </dd></dl> </div> </div> <a class="anchor" id="ad3047e8743806606f871a0a236330da5"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::get_search_path" ref="ad3047e8743806606f871a0a236330da5" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> gtksourceview::SourceLanguageManager::get_search_path </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Gets the list directories where language manager looks for language files. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>An array containg a list of language files directories. </dd></dl> </div> </div> <a class="anchor" id="aaa6b39338f48c2d7f3945d8ee4d0a7d4"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::guess_language" ref="aaa6b39338f48c2d7f3945d8ee4d0a7d4" args="(const Glib::ustring &filename, const Glib::ustring &content_type)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><<a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a>> gtksourceview::SourceLanguageManager::guess_language </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>filename</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>content_type</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td> </tr> </table> </div> <div class="memdoc"> <p>Picks a <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> for given file name and content type, according to the information in lang files. </p> <p>Either <em>filename</em> or <em>content_type</em> may be an empty string. This function can be used as follows:</p> <div class="fragment"><pre class="fragment"> Glib::RefPtr<SourceLanguage> lang; lang = lm->guess_language(filename, <a class="codeRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>()); buffer->set_language(lang); </pre></div><p>or</p> <div class="fragment"><pre class="fragment"> Glib::RefPtr<SourceLanguage> lang; <span class="keywordtype">bool</span> result_uncertain = FALSE; Glib::ustring content_type; content_type = <a class="codeRef" href="../../../glibmm-2.4/reference/html/namespaceGio.html#a48e8afbb7f1724efcdebd7c028da5560">Gio::content_type_guess</a>(filename, 0, 0, &result_uncertain); <span class="keywordflow">if</span> (result_uncertain) { content_type.<a class="codeRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html#a29d71bbd400b18e9e81b1f51b193a172">clear</a>(); } lang = lm->guess_language(filename, content_type); buffer->set_language(lang); </pre></div><p>etc. Use get_mime_types() and get_globs() if you need full control over file -> language mapping.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">filename</td><td>A filename, or empty string. </td></tr> <tr><td class="paramname">content_type</td><td>A content type (as in GIO API), or empty string.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a>, or empty <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a> if there is no suitable language for given <em>filename</em> and/or <em>content_type</em>. </dd></dl> </div> </div> <a class="anchor" id="a3241e46f83441563c6c790d605857b91"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::guess_language" ref="a3241e46f83441563c6c790d605857b91" args="(const Glib::ustring &filename, const Glib::ustring &content_type) const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a><const <a class="el" href="classgtksourceview_1_1SourceLanguage.html">SourceLanguage</a>> gtksourceview::SourceLanguageManager::guess_language </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>filename</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"><em>content_type</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Picks a <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a> for given file name and content type, according to the information in lang files. </p> <p>Either <em>filename</em> or <em>content_type</em> may be an empty string. This function can be used as follows:</p> <div class="fragment"><pre class="fragment"> Glib::RefPtr<SourceLanguageManager> lm = <a class="code" href="classgtksourceview_1_1SourceLanguageManager.html#a2d6a7a313c97b79a7964933b6896d2fe" title="Returns the default SourceLanguageManager instance.">SourceLanguageManager::get_default</a>(); Glib::RefPtr<SourceLanguage> lang; Glib::RefPtr<SourceBuffer> buffer = <a class="code" href="classgtksourceview_1_1SourceLanguageManager.html#a3ffead44dc9678a566e4fb2221baf462" title="Creates a new language manager.">SourceBuffer::create</a>(); lang = lm->guess_language(filename, <a class="codeRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>()); buffer->set_language(lang); <span class="comment">// or just:</span> <span class="comment">// Glib::RefPtr<SourceBuffer> buffer = SourceBuffer::create(lang);</span> </pre></div><p>or</p> <div class="fragment"><pre class="fragment"> Glib::RefPtr<SourceLanguage> lang; Glib::RefPtr<SourceLanguageManager> lm = <a class="code" href="classgtksourceview_1_1SourceLanguageManager.html#a2d6a7a313c97b79a7964933b6896d2fe" title="Returns the default SourceLanguageManager instance.">SourceLanguageManager::get_default</a>(); Glib::RefPtr<SourceBuffer> buffer = <a class="code" href="classgtksourceview_1_1SourceLanguageManager.html#a3ffead44dc9678a566e4fb2221baf462" title="Creates a new language manager.">SourceBuffer::create</a>(); <span class="keywordtype">bool</span> result_uncertain = FALSE; Glib::ustring content_type; content_type = <a class="codeRef" href="../../../glibmm-2.4/reference/html/namespaceGio.html#a48e8afbb7f1724efcdebd7c028da5560">Gio::content_type_guess</a>(filename, 0, 0, &result_uncertain); <span class="keywordflow">if</span> (result_uncertain) { content_type.<a class="codeRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html#a29d71bbd400b18e9e81b1f51b193a172">clear</a>(); } lang = lm->guess_language(filename, content_type); buffer->set_language(lang); <span class="comment">// or just:</span> <span class="comment">// Glib::RefPtr<SourceBuffer> buffer = SourceBuffer::create(lang);</span> </pre></div><p>etc. Use <a class="el" href="classgtksourceview_1_1SourceLanguage.html#a9bb0d1af484fe63eca4a54757e6aeaaf" title="Returns the mime types associated to this language.">SourceLanguage::get_mime_types()</a> and <a class="el" href="classgtksourceview_1_1SourceLanguage.html#a5adbeca8e4286e22bd85c61f15f749b2" title="Returns the globs associated to this language.">SourceLanguage::get_globs()</a> if you need full control over file -> language mapping.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">filename</td><td>A filename, or empty string. </td></tr> <tr><td class="paramname">content_type</td><td>A content type (as in GIO API), or empty string.</td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A <a class="el" href="classgtksourceview_1_1SourceLanguage.html" title="Object representing a syntax highlighted language.">SourceLanguage</a>, or empty <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a> if there is no suitable language for given <em>filename</em> and/or <em>content_type</em>. </dd></dl> </div> </div> <a class="anchor" id="a4de53693e4e2fa06793fed469206af95"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::reset_search_path" ref="a4de53693e4e2fa06793fed469206af95" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void gtksourceview::SourceLanguageManager::reset_search_path </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Resets the list of directories where the language manager looks for language files to default. </p> <dl class="note"><dt><b>Note:</b></dt><dd>At the moment this function can be called only before the language files are loaded for the first time. In practice to set a custom search path for a <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a>, you have to call this function right after creating it. </dd></dl> </div> </div> <a class="anchor" id="ad2f5485386567afd7cbe2dcf5abab5c2"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::set_search_path" ref="ad2f5485386567afd7cbe2dcf5abab5c2" args="(const Glib::StringArrayHandle &dirs)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void gtksourceview::SourceLanguageManager::set_search_path </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/group__ContHandles.html#ga8e243b697be740f5f7d4b578ae50db41">Glib::StringArrayHandle</a> & </td> <td class="paramname"><em>dirs</em></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Sets the list of directories where the language manager looks for language files. </p> <dl class="note"><dt><b>Note:</b></dt><dd>At the moment this function can be called only before the language files are loaded for the first time. In practice to set a custom search path for a <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html" title="Class which provides access to SourceLanguages.">SourceLanguageManager</a>, you have to call this function right after creating it.</dd></dl> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">dirs</td><td>An empty string terminated array of strings. </td></tr> </table> </dd> </dl> </div> </div> <hr/><h2>Friends And Related Function Documentation</h2> <a class="anchor" id="a7271447aa89374de1f068e051c9e63f1"></a><!-- doxytag: member="gtksourceview::SourceLanguageManager::wrap" ref="a7271447aa89374de1f068e051c9e63f1" args="(GtkSourceLanguageManager *object, bool take_copy=false)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classgtksourceview_1_1SourceLanguageManager.html">gtksourceview::SourceLanguageManager</a> > wrap </td> <td>(</td> <td class="paramtype">GtkSourceLanguageManager * </td> <td class="paramname"><em>object</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>take_copy</em> = <code>false</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td><code> [related]</code></td> </tr> </table> </div> <div class="memdoc"> <p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">object</td><td>The C instance. </td></tr> <tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl> </div> </div> </div> <hr class="footer"/><address class="footer"><small> Generated on Tue May 15 2012 21:27:04 for gtksourceviewmm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.7.5 </small></address> </body> </html>