Parser

Object Hierarchy:

Description:

[ CCode ( type_id = "gcr_parser_get_type ()" ) ]
public class Parser : Object

A parser for parsing various types of files or data.

A `GcrParser` can parse various certificate and key files such as OpenSSL PEM files, DER encoded certifictes, PKCS#8 keys and so on. Each various format is identified by a value in the [enum@DataFormat] enumeration.

In order to parse data, a new parser is created with Parser and then the [ signal@Parser:GcrParser:authenticate] and [signal@Parser:GcrParser:parsed] signals should be connected to. Data is then fed to the parser via [method@Parser.parse_data] or [method@Parser.parse_stream].

During the [signal@Parser:GcrParser:parsed] signal the attributes that make up the currently parsed item can be retrieved using the [method@Parser.get_parsed_attributes] function.

Namespace: Gcr

Package: gcr-3

Content:

Properties:

public Attributes parsed_attributes { get; }
Get the attributes that make up the currently parsed item.
public string parsed_description { get; }
The description of the type of the currently parsed item.
public string parsed_label { get; }
The label of the currently parsed item.

Creation methods:

public Parser ()
Create a new Parser

Methods:

public void add_password (string? password)
Add a password to the set of passwords to try when parsing locked or encrypted items.
public void format_disable (DataFormat format)
Disable parsing of the given format.
public void format_enable (DataFormat format)
Enable parsing of the given format.
public bool format_supported (DataFormat format)
Check whether the given format is supported by the parser.
public unowned string get_filename ()
Get the filename of the parser item.
public unowned Parsed get_parsed ()
Get the currently parsed item
public unowned Attributes? get_parsed_attributes ()
Get the attributes which make up the currently parsed item.
public unowned uint8[]? get_parsed_block ()
Get the raw data block that represents this parsed object.
public unowned Bytes get_parsed_bytes ()
Get the raw data block that represents this parsed object.
public unowned string? get_parsed_description ()
Get a description for the type of the currently parsed item.
public DataFormat get_parsed_format ()
Get the format of the raw data block that represents this parsed object.
public unowned string? get_parsed_label ()
Get the label of the currently parsed item.
public bool parse_bytes (Bytes data) throws Error
Parse the data.
public bool parse_data (uint8[] data) throws Error
Parse the data.
public bool parse_stream (InputStream input, Cancellable? cancellable = null) throws Error
Parse items from the data in a InputStream.
public async bool parse_stream_async (InputStream input, Cancellable? cancellable) throws Error
Parse items from the data in a InputStream.
public void set_filename (string? filename)
Sets the filename of the parser item.

Signals:

public virtual signal bool authenticate (int count)
This signal is emitted when an item needs to be unlocked or decrypted before it can be parsed.
public virtual signal void parsed ()
This signal is emitted when an item is sucessfully parsed.

Inherited Members:

All known members inherited from class GLib.Object