cr-num

cr-num

Synopsis

struct              CRNum;
enum CRStatus       cr_num_copy                         (CRNum *a_dest,
                                                         CRNum const *a_src);
void                cr_num_destroy                      (CRNum *a_this);
CRNum *             cr_num_dup                          (CRNum const *a_this);
gboolean            cr_num_is_fixed_length              (CRNum const *a_this);
CRNum *             cr_num_new                          (void);
CRNum *             cr_num_new_with_val                 (gdouble a_val,
                                                         enum CRNumType a_type);
enum CRStatus       cr_num_set                          (CRNum *a_this,
                                                         gdouble a_val,
                                                         enum CRNumType a_type);
guchar *            cr_num_to_string                    (CRNum const *a_this);

Description

Details

struct CRNum

struct CRNum {
        enum CRNumType type ;
        gdouble val ;
        CRParsingLocation location ;
};


cr_num_copy ()

enum CRStatus       cr_num_copy                         (CRNum *a_dest,
                                                         CRNum const *a_src);

Copies an instance of CRNum.

a_dest :

the destination of the copy. Must be non NULL

a_src :

the instance of CRNum to copy. Must be non NULL.

Returns :

CR_OK upon successful completion, an error code otherwise.

cr_num_destroy ()

void                cr_num_destroy                      (CRNum *a_this);

The destructor of CRNum.

a_this :

the this pointer of the current instance of CRNum.

cr_num_dup ()

CRNum *             cr_num_dup                          (CRNum const *a_this);

Duplicates an instance of CRNum

a_this :

the instance of CRNum to duplicate.

Returns :

the newly created (duplicated) instance of CRNum. Must be freed by cr_num_destroy().

cr_num_is_fixed_length ()

gboolean            cr_num_is_fixed_length              (CRNum const *a_this);

Tests if the current instance of CRNum is a fixed length value or not. Typically a fixed length value is anything from NUM_LENGTH_EM to NUM_LENGTH_PC. See the definition of CRNumType to see what we mean.

a_this :

the current instance of CRNum .

Returns :

TRUE if the instance of CRNum is a fixed length number, FALSE otherwise.

cr_num_new ()

CRNum *             cr_num_new                          (void);

CRNum.

Returns :

the newly built instance of CRNum.

cr_num_new_with_val ()

CRNum *             cr_num_new_with_val                 (gdouble a_val,
                                                         enum CRNumType a_type);

A constructor of CRNum.

a_val :

the numerical value of the number.

a_type :

the type of number.

Returns :

the newly built instance of CRNum or NULL if an error arises.

cr_num_set ()

enum CRStatus       cr_num_set                          (CRNum *a_this,
                                                         gdouble a_val,
                                                         enum CRNumType a_type);

a_this :

the current instance of CRNum to be set.

a_val :

the new numerical value to be hold by the current instance of CRNum

a_type :

the new type of CRNum.

Returns :

CR_OK upon succesful completion, an error code otherwise.

cr_num_to_string ()

guchar *            cr_num_to_string                    (CRNum const *a_this);

a_this :

the current instance of CRNum.

Returns :

the newly built string representation of the current instance of CRNum. The returned string is NULL terminated. The caller *must* free the returned string.