📄 pango-miscellaneous-utilities.html
字号:
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html; charset=US-ASCII"><title>Miscellaneous Utilities</title><meta name="generator" content="DocBook XSL Stylesheets V1.69.1"><link rel="start" href="index.html" title="Pango Reference Manual"><link rel="up" href="lowlevel.html" title="Low Level Functionality"><link rel="prev" href="pango-Modules.html" title="Modules"><link rel="next" href="pango-Version-Checking.html" title="Version Checking"><meta name="generator" content="GTK-Doc V1.6 (XML mode)"><link rel="stylesheet" href="style.css" type="text/css"><link rel="chapter" href="pango.html" title="Basic Pango Interfaces"><link rel="chapter" href="rendering.html" title="Rendering with Pango"><link rel="chapter" href="lowlevel.html" title="Low Level Functionality"><link rel="chapter" href="tools.html" title="Pango Tools"><link rel="index" href="ix01.html" title="Index"><link rel="index" href="ix02.html" title="Index of deprecated symbols"><link rel="index" href="ix03.html" title="Index of new symbols in 1.2"><link rel="index" href="ix04.html" title="Index of new symbols in 1.4"><link rel="index" href="ix05.html" title="Index of new symbols in 1.6"><link rel="index" href="ix06.html" title="Index of new symbols in 1.8"><link rel="index" href="ix07.html" title="Index of new symbols in 1.10"><link rel="index" href="ix08.html" title="Index of new symbols in 1.12"><link rel="index" href="ix09.html" title="Index of new symbols in 1.14"><link rel="index" href="ix10.html" title="Index of new symbols in 1.16"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2"><tr valign="middle"><td><a accesskey="p" href="pango-Modules.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td><td><a accesskey="u" href="lowlevel.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td><td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td><th width="100%" align="center">Pango Reference Manual</th><td><a accesskey="n" href="pango-Version-Checking.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td></tr><tr><td colspan="5" class="shortcuts"><nobr><a href="#top_of_page" class="shortcut">Top</a>  |  <a href="#desc" class="shortcut">Description</a></nobr></td></tr></table><div class="refentry" lang="en"><a name="pango-Miscellaneous-Utilities"></a><div class="titlepage"></div><div class="refnamediv"><table width="100%"><tr><td valign="top"><h2><span class="refentrytitle"><a name="top_of_page"></a>Miscellaneous Utilities</span></h2><p>Miscellaneous Utilities — Various convenience and utility functions</p></td><td valign="top" align="right"></td></tr></table></div><div class="refsynopsisdiv"><a name="synopsis"></a><h2>Synopsis</h2><pre class="synopsis">char** <a href="pango-Miscellaneous-Utilities.html#pango-split-file-list">pango_split_file_list</a> (const char *str);char* <a href="pango-Miscellaneous-Utilities.html#pango-trim-string">pango_trim_string</a> (const char *str);<ahref="../glib/glib-Basic-Types.html#gint">gint</a> <a href="pango-Miscellaneous-Utilities.html#pango-read-line">pango_read_line</a> (FILE *stream, <ahref="../glib/glib-Strings.html#GString">GString</a> *str);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-skip-space">pango_skip_space</a> (const char **pos);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-scan-word">pango_scan_word</a> (const char **pos, <ahref="../glib/glib-Strings.html#GString">GString</a> *out);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-scan-string">pango_scan_string</a> (const char **pos, <ahref="../glib/glib-Strings.html#GString">GString</a> *out);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-scan-int">pango_scan_int</a> (const char **pos, int *out);char* <a href="pango-Miscellaneous-Utilities.html#pango-config-key-get">pango_config_key_get</a> (const char *key);void <a href="pango-Miscellaneous-Utilities.html#pango-lookup-aliases">pango_lookup_aliases</a> (const char *fontname, char ***families, int *n_families);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-parse-enum">pango_parse_enum</a> (<ahref="../gobject/gobject-Type-Information.html#GType">GType</a> type, const char *str, int *value, <ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> warn, char **possible_values);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-parse-style">pango_parse_style</a> (const char *str, <a href="pango-Fonts.html#PangoStyle">PangoStyle</a> *style, <ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> warn);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-parse-variant">pango_parse_variant</a> (const char *str, <a href="pango-Fonts.html#PangoVariant">PangoVariant</a> *variant, <ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> warn);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-parse-weight">pango_parse_weight</a> (const char *str, <a href="pango-Fonts.html#PangoWeight">PangoWeight</a> *weight, <ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> warn);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-parse-stretch">pango_parse_stretch</a> (const char *str, <a href="pango-Fonts.html#PangoStretch">PangoStretch</a> *stretch, <ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> warn);const char* <a href="pango-Miscellaneous-Utilities.html#pango-get-sysconf-subdirectory">pango_get_sysconf_subdirectory</a> (void);const char* <a href="pango-Miscellaneous-Utilities.html#pango-get-lib-subdirectory">pango_get_lib_subdirectory</a> (void);<ahref="../glib/glib-Basic-Types.html#guint8">guint8</a>* <a href="pango-Miscellaneous-Utilities.html#pango-log2vis-get-embedding-levels">pango_log2vis_get_embedding_levels</a> (const <ahref="../glib/glib-Basic-Types.html#gchar">gchar</a> *text, int length, <a href="pango-Text-Processing.html#PangoDirection">PangoDirection</a> *pbase_dir);<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a>* <a href="pango-Miscellaneous-Utilities.html#pango-language-get-default">pango_language_get_default</a> (void);const char* <a href="pango-Miscellaneous-Utilities.html#pango-language-get-sample-string">pango_language_get_sample_string</a> (<a href="pango-Text-Attributes.html#PangoLanguage">PangoLanguage</a> *language);<ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> <a href="pango-Miscellaneous-Utilities.html#pango-is-zero-width">pango_is_zero_width</a> (<ahref="../glib/glib-Unicode-Manipulation.html#gunichar">gunichar</a> ch);void <a href="pango-Miscellaneous-Utilities.html#pango-quantize-line-geometry">pango_quantize_line_geometry</a> (int *thickness, int *position);</pre></div><div class="refsect1" lang="en"><a name="desc"></a><h2>Description</h2><p>The functions and utilities in this section are mostly used from Pangobackends and modules, but may be useful for other purposes too.</p></div><div class="refsect1" lang="en"><a name="details"></a><h2>Details</h2><div class="refsect2" lang="en"><a name="id2942849"></a><h3><a name="pango-split-file-list"></a>pango_split_file_list ()</h3><a class="indexterm" name="id2942861"></a><pre class="programlisting">char** pango_split_file_list (const char *str);</pre><p>Splits a <ahref="../glib/glib-Standard-Macros.html#G-SEARCHPATH-SEPARATOR:CAPS"><code class="literal">G_SEARCHPATH_SEPARATOR</code></a>-separated list of files, strippingwhite space and substituting ~/ with $HOME/.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>str</code></em> :</span></td><td> a <ahref="../glib/glib-Standard-Macros.html#G-SEARCHPATH-SEPARATOR:CAPS"><code class="literal">G_SEARCHPATH_SEPARATOR</code></a> separated list of filenames</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> a list of strings to be freed with <ahref="../glib/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2942956"></a><h3><a name="pango-trim-string"></a>pango_trim_string ()</h3><a class="indexterm" name="id2942970"></a><pre class="programlisting">char* pango_trim_string (const char *str);</pre><p>Trims leading and trailing whitespace from a string.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>str</code></em> :</span></td><td> a string</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> A newly-allocated string that must be freed with <ahref="../glib/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a></td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2943041"></a><h3><a name="pango-read-line"></a>pango_read_line ()</h3><a class="indexterm" name="id2943054"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#gint">gint</a> pango_read_line (FILE *stream, <ahref="../glib/glib-Strings.html#GString">GString</a> *str);</pre><p>Reads an entire line from a file into a buffer. Lines maybe delimited with '\n', '\r', '\n\r', or '\r\n'. The delimiteris not written into the buffer. Text after a '#' character is treated asa comment and skipped. '\' can be used to escape a # character.'\' proceeding a line delimiter combines adjacent lines. A '\' proceedingany other character is ignored and written into the output bufferunmodified.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>stream</code></em> :</span></td><td> a stdio stream</td></tr><tr><td><span class="term"><em class="parameter"><code>str</code></em> :</span></td><td> <ahref="../glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer into which to write the result</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> 0 if the stream was already at an <code class="literal">EOF</code> character, otherwise the number of lines read (this is useful for maintaining a line number counter which doesn't combine lines with '\')</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2943165"></a><h3><a name="pango-skip-space"></a>pango_skip_space ()</h3><a class="indexterm" name="id2943178"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> pango_skip_space (const char **pos);</pre><p>Skips 0 or more characters of white space.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>pos</code></em> :</span></td><td> in/out string position</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> <ahref="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if skipping the white space leavesthe position at a '\0' character.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2943249"></a><h3><a name="pango-scan-word"></a>pango_scan_word ()</h3><a class="indexterm" name="id2943262"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> pango_scan_word (const char **pos, <ahref="../glib/glib-Strings.html#GString">GString</a> *out);</pre><p>Scans a word into a <ahref="../glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. A word consistsof [A-Za-z_] followed by zero or more [A-Za-z_0-9]Leading white space is skipped.</p><p></p><div class="variablelist"><table border="0"><col align="left" valign="top"><tbody><tr><td><span class="term"><em class="parameter"><code>pos</code></em> :</span></td><td> in/out string position</td></tr><tr><td><span class="term"><em class="parameter"><code>out</code></em> :</span></td><td> a <ahref="../glib/glib-Strings.html#GString"><span class="type">GString</span></a> into which to write the result</td></tr><tr><td><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></td><td> <ahref="../glib/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if a parse error occurred.</td></tr></tbody></table></div></div><hr><div class="refsect2" lang="en"><a name="id2943372"></a><h3><a name="pango-scan-string"></a>pango_scan_string ()</h3><a class="indexterm" name="id2943386"></a><pre class="programlisting"><ahref="../glib/glib-Basic-Types.html#gboolean">gboolean</a> pango_scan_string (const char **pos, <ahref="../glib/glib-Strings.html#GString">GString</a> *out);</pre><p>Scans a string into a <ahref="../glib/glib-Strings.html#GString"><span class="type">GString</span></a> buffer. The string may eitherbe a sequence of non-white-space characters, or a quotedstring with '"'. Instead a quoted string, '\"' representsa literal quote. Leading white space outside of quotes is skipped.</p>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -