glib-lexical-scanner.html

glid编写实例

<p>
<em class="structfield"><code>skip_comment_single</code></em> specifies if single-line
comments are skipped and not returned as tokens (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_comment_multi</code></em> specifies if multi-line
comments are recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_identifier</code></em> specifies if identifiers
are recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_identifier_1char</code></em> specifies if single-character
identifiers are recognized (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>scan_identifier_NULL</code></em> specifies if 
<code class="literal">NULL</code> is reported as <span class="type">G_TOKEN_IDENTIFIER_NULL</span>.
(the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>scan_symbols</code></em> specifies if symbols are
recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_binary</code></em> specifies if binary numbers
are recognized (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>scan_octal</code></em> specifies if octal numbers
are recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_float</code></em> specifies if floating point numbers
are recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_hex</code></em> specifies if hexadecimal numbers
are recognized (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_hex_dollar</code></em> specifies if '$' is recognized
as a prefix for hexadecimal numbers (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>scan_string_sq</code></em> specifies if strings can be
enclosed in single quotes (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>scan_string_dq</code></em> specifies if strings can be
enclosed in double quotes (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>numbers_2_int</code></em> specifies if binary, octal and
hexadecimal numbers are reported as <span class="type">G_TOKEN_INT</span> (the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>int_2_float</code></em> specifies if all numbers are 
reported as <span class="type">G_TOKEN_FLOAT</span> (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>identifier_2_string</code></em> specifies if identifiers
are reported as strings (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>char_2_token</code></em> specifies if characters
are reported by setting <code class="literal">token = ch</code> or as <span class="type">G_TOKEN_CHAR</span> 
(the default is <code class="literal">TRUE</code>).
</p>
<p>
<em class="structfield"><code>symbol_2_token</code></em> specifies if symbols 
are reported by setting <code class="literal">token = v_symbol</code> or as
<span class="type">G_TOKEN_SYMBOL</span> (the default is <code class="literal">FALSE</code>).
</p>
<p>
<em class="structfield"><code>scope_0_fallback</code></em> specifies if a symbol 
is searched for in the default scope in addition to the current scope
(the default is <code class="literal">FALSE</code>).
</p>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3029865"></a><h3>
<a name="g-scanner-input-file"></a>g_scanner_input_file ()</h3>
<a class="indexterm" name="id3029876"></a><pre class="programlisting">void        g_scanner_input_file            (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner,
                                             <a href="glib-Basic-Types.html#gint">gint</a> input_fd);</pre>
<p>
Prepares to scan a file.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>input_fd</code></em>&#160;:</span></td>
<td>a file descriptor.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3029952"></a><h3>
<a name="g-scanner-sync-file-offset"></a>g_scanner_sync_file_offset ()</h3>
<a class="indexterm" name="id3029964"></a><pre class="programlisting">void        g_scanner_sync_file_offset      (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Rewinds the filedescriptor to the current buffer position and blows 
the file read ahead buffer. This is useful for third party uses of
the scanners filedescriptor, which hooks onto the current scanning 
position.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody><tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.


</td>
</tr></tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030021"></a><h3>
<a name="g-scanner-input-text"></a>g_scanner_input_text ()</h3>
<a class="indexterm" name="id3030032"></a><pre class="programlisting">void        g_scanner_input_text            (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner,
                                             const	<a href="glib-Basic-Types.html#gchar">gchar</a> *text,
                                             <a href="glib-Basic-Types.html#guint">guint</a> text_len);</pre>
<p>
Prepares to scan a text buffer.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text</code></em>&#160;:</span></td>
<td>the text buffer to scan.
</td>
</tr>
<tr>
<td>
<span class="term"><em class="parameter"><code>text_len</code></em>&#160;:</span></td>
<td>the length of the text buffer.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030131"></a><h3>
<a name="g-scanner-peek-next-token"></a>g_scanner_peek_next_token ()</h3>
<a class="indexterm" name="id3030142"></a><pre class="programlisting"><a href="glib-Lexical-Scanner.html#GTokenType">GTokenType</a>  g_scanner_peek_next_token       (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Gets the next token, without removing it from the input stream.
The token data is placed in the
<em class="structfield"><code>next_token</code></em>,
<em class="structfield"><code>next_value</code></em>,
<em class="structfield"><code>next_line</code></em>, and
<em class="structfield"><code>next_position</code></em> fields of the <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> structure.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the type of the token.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030231"></a><h3>
<a name="g-scanner-get-next-token"></a>g_scanner_get_next_token ()</h3>
<a class="indexterm" name="id3030242"></a><pre class="programlisting"><a href="glib-Lexical-Scanner.html#GTokenType">GTokenType</a>  g_scanner_get_next_token        (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Gets the next token, removing it from the input stream.
The token data is placed in the
<em class="structfield"><code>token</code></em>,
<em class="structfield"><code>value</code></em>,
<em class="structfield"><code>line</code></em>, and
<em class="structfield"><code>position</code></em> fields of the <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a> structure.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the type of the token.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030330"></a><h3>
<a name="g-scanner-cur-line"></a>g_scanner_cur_line ()</h3>
<a class="indexterm" name="id3030341"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_scanner_cur_line              (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Gets the current line in the input stream (counting from 1).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the current line.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030406"></a><h3>
<a name="g-scanner-cur-position"></a>g_scanner_cur_position ()</h3>
<a class="indexterm" name="id3030418"></a><pre class="programlisting"><a href="glib-Basic-Types.html#guint">guint</a>       g_scanner_cur_position          (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Gets the current position in the current line (counting from 0).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td>
<span class="term"><em class="parameter"><code>scanner</code></em>&#160;:</span></td>
<td>a <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>.
</td>
</tr>
<tr>
<td>
<span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
<td>the current position on the line.


</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2" lang="en">
<a name="id3030483"></a><h3>
<a name="g-scanner-cur-token"></a>g_scanner_cur_token ()</h3>
<a class="indexterm" name="id3030495"></a><pre class="programlisting"><a href="glib-Lexical-Scanner.html#GTokenType">GTokenType</a>  g_scanner_cur_token             (<a href="glib-Lexical-Scanner.html#GScanner">GScanner</a> *scanner);</pre>
<p>
Gets the current token type.
This is simply the <em class="structfield"><code>token</code></em> field in the <a href="glib-Lexical-Scanner.html#GScanner"><span class="type">GScanner</span></a>
structure.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>