pangoScriptGetSampleLanguage      package:RGtk2      R Documentation

_p_a_n_g_o_S_c_r_i_p_t_G_e_t_S_a_m_p_l_e_L_a_n_g_u_a_g_e

_D_e_s_c_r_i_p_t_i_o_n:

     Given a script, finds a language tag that is reasonably
     representative of that script. This will usually be the most
     widely spoken or used language written in that script: for
     instance, the sample language for 'PANGO_SCRIPT_CYRILLIC' is 'ru'
     (Russian), the sample language for 'PANGO_SCRIPT_ARABIC' is 'ar'.

_U_s_a_g_e:

     pangoScriptGetSampleLanguage(script)

_A_r_g_u_m_e_n_t_s:

'script': ['PangoScript']  a 'PangoScript'

_D_e_t_a_i_l_s:

     For some scripts, no sample language will be returned because
     there is no language that is sufficiently representative. The best
     example of this is 'PANGO_SCRIPT_HAN', where various different
     variants of written Chinese, Japanese, and Korean all use
     significantly different sets of Han characters and forms of shared
     characters. No sample language can be provided for many historical
     scripts as well.

     As of 1.18, this function checks the environment variables
     PANGO_LANGUAGE and LANGUAGE (checked in that order) first. If one
     of them is set, it is parsed as a list of language tags separated
     by colons or other separators.  This function will return the
     first language in the parsed list that Pango believes may use
     'script' for writing.  This last predicate is tested using
     'pangoLanguageIncludesScript'.  This can be used to control
     Pango's font selection for non-primary languages.  For example, a
     PANGO_LANGUAGE enviroment variable set to "en:fa" makes Pango
     choose fonts suitable for Persian (fa)  instead of Arabic (ar)
     when a segment of Arabic text is found in an otherwise non-Arabic
     text.  The same trick can be used to choose a default language for
     'PANGO_SCRIPT_HAN' when setting context language is not feasible.  

     Since  1.4

_V_a_l_u_e:

     ['PangoLanguage']  a 'PangoLanguage' that is representative of the
     script, or 'NULL' if no such language exists.

_A_u_t_h_o_r(_s):

     Derived by RGtkGen from GTK+ documentation

