cr-parsing-location

cr-parsing-location

Synopsis

                    CRParsingLocation;
CRParsingLocation *  cr_parsing_location_new            (void);
enum CRStatus       cr_parsing_location_init            (CRParsingLocation *a_this);
enum CRStatus       cr_parsing_location_copy            (CRParsingLocation *a_to,
                                                         CRParsingLocation const *a_from);
gchar *             cr_parsing_location_to_string       (CRParsingLocation const *a_this,
                                                         enum CRParsingLocationSerialisationMask a_mask);
void                cr_parsing_location_dump            (CRParsingLocation const *a_this,
                                                         enum CRParsingLocationSerialisationMask a_mask,
                                                         FILE *a_fp);
void                cr_parsing_location_destroy         (CRParsingLocation *a_this);

Description

Details

CRParsingLocation

typedef struct {
	guint line ;
	guint column ;
	guint byte_offset ;
} CRParsingLocation;


cr_parsing_location_new ()

CRParsingLocation *  cr_parsing_location_new            (void);

Returns :

the newly instanciated CRParsingLocation. Must be freed by cr_parsing_location_destroy()

cr_parsing_location_init ()

enum CRStatus       cr_parsing_location_init            (CRParsingLocation *a_this);

Initializes the an instance of CRparsingLocation.

a_this :

the current instance of CRParsingLocation.

Returns :

CR_OK upon succesful completion, an error code otherwise.

cr_parsing_location_copy ()

enum CRStatus       cr_parsing_location_copy            (CRParsingLocation *a_to,
                                                         CRParsingLocation const *a_from);

Copies an instance of CRParsingLocation into another one.

a_to :

the destination of the copy. Must be allocated by the caller.

a_from :

the source of the copy.

Returns :

CR_OK upon succesful completion, an error code otherwise.

cr_parsing_location_to_string ()

gchar *             cr_parsing_location_to_string       (CRParsingLocation const *a_this,
                                                         enum CRParsingLocationSerialisationMask a_mask);

a_this :

the current instance of CRParsingLocation.

a_mask :

a bitmap that defines which parts of the parsing location are to be serialized (line, column or byte offset)

Returns :

the serialized string or NULL in case of an error.

cr_parsing_location_dump ()

void                cr_parsing_location_dump            (CRParsingLocation const *a_this,
                                                         enum CRParsingLocationSerialisationMask a_mask,
                                                         FILE *a_fp);

a_this :

current instance of CRParsingLocation

a_mask :

the serialization mask.

a_fp :

the file pointer to dump the parsing location to.

cr_parsing_location_destroy ()

void                cr_parsing_location_destroy         (CRParsingLocation *a_this);

Destroys the current instance of CRParsingLocation

a_this :

the current instance of CRParsingLocation. Must have been allocated with cr_parsing_location_new().