6.1 Initialization and Assignment Functions

Function: void mpq_init (mpq_t x)

Initialize x and set it to 0/1. Each variable should normally only be initialized once, or at least cleared out (using the function mpq_clear) between each initialization.

Function: void mpq_inits (mpq_t x, ...)

Initialize a NULL-terminated list of mpq_t variables, and set their values to 0/1.

Function: void mpq_clear (mpq_t x)

Free the space occupied by x. Make sure to call this function for all mpq_t variables when you are done with them.

Function: void mpq_clears (mpq_t x, ...)

Free the space occupied by a NULL-terminated list of mpq_t variables.

Function: void mpq_set (mpq_t rop, const mpq_t op)

Function: void mpq_set_z (mpq_t rop, const mpz_t op)

Assign rop from op.

Function: void mpq_set_ui (mpq_t rop, unsigned long int op1, unsigned long int op2)

Function: void mpq_set_si (mpq_t rop, signed long int op1, unsigned long int op2)

Set the value of rop to op1/op2. Note that if op1 and op2 have common factors, rop has to be passed to mpq_canonicalize before any operations are performed on rop.

Function: int mpq_set_str (mpq_t rop, const char *str, int base)

Set rop from a null-terminated string str in the given base.

The string can be an integer like “41” or a fraction like “41/152”. The fraction must be in canonical form (see Rational Number Functions), or if not then mpq_canonicalize must be called.

The numerator and optional denominator are parsed the same as in mpz_set_str (see Assigning Integers). White space is allowed in the string, and is simply ignored. The base can vary from 2 to 62, or if base is 0 then the leading characters are used: 0x or 0X for hex, 0b or 0B for binary, 0 for octal, or decimal otherwise. Note that this is done separately for the numerator and denominator, so for instance 0xEF/100 is 239/100, whereas 0xEF/0x100 is 239/256.

The return value is 0 if the entire string is a valid number, or -1 if not.

Function: void mpq_swap (mpq_t rop1, mpq_t rop2)

Swap the values rop1 and rop2 efficiently.