To initialize a pairing from an ASCIIZ string:
pairing_t pairing; pairing_init_set_str(pairing, s); // Where s is a char *.
The string s holds
pairing parameters in a
text format. The param
subdirectory contains several examples.
Alternatively, call:
pairing_t pairing; pairing_init_pbc_param(pairing, param);
where param is an
initialized pbc_param_t (see
Chapter 5, Param
functions).
int pairing_init_set_str(pairing_t pairing, const char *s)
Initialize pairing from parameters in a ASCIIZ string str Returns 0 on success, 1 on failure.
int pairing_init_set_buf(pairing_t pairing, const char *s, size_t len)
Same, but read at most len bytes. If len is 0, it behaves as the previous function. Returns 0 on success, 1 on failure.
void pairing_init_pbc_param(struct pairing_s *pairing, pbc_param_t p)
Initialize a pairing with pairing parameters p.
void pairing_clear(pairing_t pairing)
Free the space occupied by pairing. Call whenever a
pairing_tvariable is no longer needed. Only call this after all elements associated with pairing have been cleared, as they need information stored in the pairing structure.