glib/org.gtkkn.bindings.glib/Scanner

Scanner

class Scanner(pointer: <Error class: unknown class><<Error class: unknown class>>) : Record

GScanner provides a general-purpose lexical scanner.

You should set @input_name after creating the scanner, since it is used by the default message handler when displaying warnings and errors. If you are scanning a file, the filename would be a good choice.

The @user_data and @max_parse_errors fields are not used. If you need to associate extra data with the scanner you can place them here.

If you want to use your own message handler you can set the

Constructors

Scanner

constructor(pointer: <Error class: unknown class><<Error class: unknown class>>)

Types

Companion

object Companion : RecordCompanion<Scanner, <Error class: unknown class>>

Properties

config

val config: ScannerConfig?

link into the scanner configuration

glibScannerPointer

val glibScannerPointer: <Error class: unknown class><<Error class: unknown class>>

inputName

val inputName: String?

name of input stream, featured by the default message handler

line

var line: <Error class: unknown class>

line number of the last token from g_scanner_get_next_token()

maxParseErrors

var maxParseErrors: <Error class: unknown class>

unused

nextLine

var nextLine: <Error class: unknown class>

line number of the last token from g_scanner_peek_next_token()

nextPosition

var nextPosition: <Error class: unknown class>

char number of the last token from g_scanner_peek_next_token()

nextToken

var nextToken: TokenType

token parsed by the last g_scanner_peek_next_token()

parseErrors

var parseErrors: <Error class: unknown class>

g_scanner_error() increments this field

position

var position: <Error class: unknown class>

char number of the last token from g_scanner_get_next_token()

token

var token: TokenType

token parsed by the last g_scanner_get_next_token()

Functions

curLine

fun curLine(): <Error class: unknown class>

Returns the current line in the input stream (counting from 1). This is the line of the last token parsed via g_scanner_get_next_token().

curPosition

fun curPosition(): <Error class: unknown class>

Returns the current position in the current line (counting from 0). This is the position of the last token parsed via g_scanner_get_next_token().

curToken

fun curToken(): TokenType

Gets the current token type. This is simply the @token field in the #GScanner structure.

destroy

fun destroy()

Frees all memory used by the #GScanner.

eof

fun eof(): Boolean

Returns true if the scanner has reached the end of the file or text buffer.

getNextToken

fun getNextToken(): TokenType

Parses the next token just like g_scanner_peek_next_token() and also removes it from the input stream. The token data is placed in the @token, @value, @line, and @position fields of the #GScanner structure.

inputFile

fun inputFile(inputFd: Int)

Prepares to scan a file.

inputText

fun inputText(text: String, textLen: <Error class: unknown class>)

Prepares to scan a text buffer.

peekNextToken

fun peekNextToken(): TokenType

Parses the next token, without removing it from the input stream. The token data is placed in the @next_token, @next_value, @next_line, and @next_position fields of the #GScanner structure.

scopeForeachSymbol

fun scopeForeachSymbol(scopeId: <Error class: unknown class>, func: HFunc)

Calls the given function for each of the symbol/value pairs in the given scope of the #GScanner. The function is passed the symbol and value of each pair, and the given @user_data parameter.

scopeRemoveSymbol

fun scopeRemoveSymbol(scopeId: <Error class: unknown class>, symbol: String)

Removes a symbol from a scope.

setScope

fun setScope(scopeId: <Error class: unknown class>): <Error class: unknown class>

Sets the current scope.

syncFileOffset

fun syncFileOffset()

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.

unexpToken

fun unexpToken(expectedToken: TokenType, identifierSpec: String, symbolSpec: String, symbolName: String, message: String, isError: Int)

Outputs a message through the scanner's msg_handler, resulting from an unexpected token in the input stream. Note that you should not call g_scanner_peek_next_token() followed by g_scanner_unexp_token() without an intermediate call to g_scanner_get_next_token(), as g_scanner_unexp_token() evaluates the scanner's current token (not the peeked token) to construct part of the message.