Tuple functions

Data Structures
struct	RDB_renaming
struct	RDB_wrapping
struct	RDB_virtual_attr
Functions
int	RDB_tuple_set (RDB_object *tplp, const char *attrname, const RDB_object *objp, RDB_exec_context *ecp)
int	RDB_tuple_set_bool (RDB_object *tplp, const char *attrname, RDB_bool val, RDB_exec_context *ecp)
int	RDB_tuple_set_int (RDB_object *tplp, const char *attrname, RDB_int val, RDB_exec_context *ecp)
int	RDB_tuple_set_float (RDB_object *tplp, const char *attrname, RDB_float val, RDB_exec_context *ecp)
int	RDB_tuple_set_string (RDB_object *tplp, const char *attrname, const char *str, RDB_exec_context *ecp)
RDB_object *	RDB_tuple_get (const RDB_object *tplp, const char *attrname)
RDB_bool	RDB_tuple_get_bool (const RDB_object *tplp, const char *attrname)
RDB_int	RDB_tuple_get_int (const RDB_object *tplp, const char *attrname)
RDB_float	RDB_tuple_get_float (const RDB_object *tplp, const char *attrname)
char *	RDB_tuple_get_string (const RDB_object *tplp, const char *attrname)
RDB_int	RDB_tuple_size (const RDB_object *tplp)
void	RDB_tuple_attr_names (const RDB_object *tplp, char **namev)
int	RDB_project_tuple (const RDB_object *tplp, int attrc, char *attrv[], RDB_exec_context *ecp, RDB_object *restplp)
int	RDB_remove_tuple (const RDB_object *tplp, int attrc, char *attrv[], RDB_exec_context *ecp, RDB_object *restplp)
int	RDB_add_tuple (RDB_object *tpl1p, const RDB_object *tpl2p, RDB_exec_context *ecp, RDB_transaction *txp)
int	RDB_join_tuples (const RDB_object *tpl1p, const RDB_object *tpl2p, RDB_exec_context *ecp, RDB_transaction *txp, RDB_object *restplp)
int	RDB_extend_tuple (RDB_object *tplp, int attrc, const RDB_virtual_attr attrv[], RDB_exec_context *ecp, RDB_transaction *txp)
int	RDB_rename_tuple (const RDB_object *tplp, int renc, const RDB_renaming renv[], RDB_exec_context *ecp, RDB_object *restup)
int	RDB_wrap_tuple (const RDB_object *tplp, int wrapc, const RDB_wrapping wrapv[], RDB_exec_context *ecp, RDB_object *restplp)
int	RDB_unwrap_tuple (const RDB_object *tplp, int attrc, char *attrv[], RDB_exec_context *ecp, RDB_object *restplp)

---

Function Documentation

int RDB_extend_tuple	(	RDB_object *	tplp,
		int	attrc,
		const RDB_virtual_attr	attrv[],
		RDB_exec_context *	ecp,
		RDB_transaction *	txp
	)

RDB_extend_tuple extends the tuple specified by tplp by the attributes specified by attrc and attrv.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

RDB_NAME_ERROR

One of the expressions specified in updv refers to an attribute which does not exist in the tuple.

RDB_INVALID_ARGUMENT_ERROR

One of the additional attributes already exists in the original table.

RDB_OPERATOR_NOT_FOUND_ERROR

One of the expressions specified in updv refers to an operator which does not exist.

The call may also fail for a system error.

int RDB_join_tuples	(	const RDB_object *	tpl1p,
		const RDB_object *	tpl2p,
		RDB_exec_context *	ecp,
		RDB_transaction *	txp,
		RDB_object *	restplp
	)

RDB_join_tuples creates a tuple which contains the attributes of the two tuples specified by tpl1p and tpl2p.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

RDB_TYPE_MISMATCH_ERROR

The two tuples have an attribute with the same name, but with different types.

RDB_INVALID_ARGUMENT_ERROR

The two tuples have an attribute with the same name, but with different values.

The call may also fail for a system error.

int RDB_project_tuple	(	const RDB_object *	tplp,
		int	attrc,
		char *	attrv[],
		RDB_exec_context *	ecp,
		RDB_object *	restplp
	)

RDB_project_tuple creates a tuple which contains only the attributes specified by attrc and attrv.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

RDB_NAME_ERROR

One of the attributes specified by attrv is not an attribute of the original tuple.

The call may also fail for a system error.

int RDB_rename_tuple	(	const RDB_object *	tplp,
		int	renc,
		const RDB_renaming	renv[],
		RDB_exec_context *	ecp,
		RDB_object *	restup
	)

RDB_rename_tuple creates copies the tuple specified by tplp to the tuple specified by restplp, renaming the attributes specified by renc and renv.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

void RDB_tuple_attr_names	(	const RDB_object *	tplp,
		char **	namev
	)

RDB_tuple_attr_names fills namev with pointers to the attribute names of the tuple specified by tplp.

namev must be large enough for all attribute names. The pointers must not be modified by the caller and will become invalid when the tuple is destroyed.

RDB_object* RDB_tuple_get	(	const RDB_object *	tplp,
		const char *	attrname
	)

RDB_tuple_get returns a pointer to a RDB_object structure which contains the value for attribute name. The value is not copied.

Returns:

A pointer to the value of the attribute, or NULL if no attribute with that name exists.

RDB_bool RDB_tuple_get_bool	(	const RDB_object *	tplp,
		const char *	attrname
	)

RDB_tuple_get_bool returns the value of attribute name as a RDB_bool. The attribute must exist and it must be of type BOOLEAN.

Returns:

The attribute value.

RDB_float RDB_tuple_get_float	(	const RDB_object *	tplp,
		const char *	attrname
	)

Return the value of attribute name as a RDB_float. The attribute must exist and it must be of type FLOAT.

Returns:

The attribute value.

RDB_int RDB_tuple_get_int	(	const RDB_object *	tplp,
		const char *	attrname
	)

RDB_tuple_get_int returns the value of attribute name as a RDB_int. The attribute must exist and it must be of type INTEGER.

Returns:

The attribute value.

char* RDB_tuple_get_string	(	const RDB_object *	tplp,
		const char *	attrname
	)

RDB_tuple_get_string returns a pointer to the value of attribute name. The attribute must exist and it must be of type STRING.

Returns:

A pointer to the attribute value.

int RDB_tuple_set	(	RDB_object *	tplp,
		const char *	attrname,
		const RDB_object *	objp,
		RDB_exec_context *	ecp
	)

RDB_tuple_set sets the attribute name of the tuple variable specified by tplp to the value specified by valp.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

int RDB_tuple_set_bool	(	RDB_object *	tplp,
		const char *	attrname,
		RDB_bool	val,
		RDB_exec_context *	ecp
	)

RDB_tuple_set_bool sets the attribute name of the tuple variable specified by tplp to the boolean value specified by val.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

int RDB_tuple_set_float	(	RDB_object *	tplp,
		const char *	attrname,
		RDB_float	val,
		RDB_exec_context *	ecp
	)

Set the attribute name of the tuple variable specified by tplp to the value specified by val.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

int RDB_tuple_set_int	(	RDB_object *	tplp,
		const char *	attrname,
		RDB_int	val,
		RDB_exec_context *	ecp
	)

RDB_tuple_set_int sets the attribute name of the tuple variable specified by tplp to the integer value specified by val.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

int RDB_tuple_set_string	(	RDB_object *	tplp,
		const char *	attrname,
		const char *	str,
		RDB_exec_context *	ecp
	)

Set the attribute name of the tuple variable specified by tplp to the value specified by str.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

The call may fail for a system error.

RDB_int RDB_tuple_size

(

const RDB_object *

tplp

)

RDB_tuple_size returns the number of attributes of the tuple specified by tplp.

Returns:

The number of attributes.

int RDB_unwrap_tuple	(	const RDB_object *	tplp,
		int	attrc,
		char *	attrv[],
		RDB_exec_context *	ecp,
		RDB_object *	restplp
	)

RDB_unwrap_tuple performs a tuple UNWRAP operator on the tuple pointed to by tplp and stores the result in the variable pointed to by restplp.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

RDB_NAME_ERROR

An attribute specified by attrv does not exist.

RDB_INVALID_ARGUMENT_ERROR

An attribute specified by attrv is not tuple-typed.

int RDB_wrap_tuple	(	const RDB_object *	tplp,
		int	wrapc,
		const RDB_wrapping	wrapv[],
		RDB_exec_context *	ecp,
		RDB_object *	restplp
	)

RDB_wrap_tuple performs a tuple WRAP operator on the tuple pointed to by tplp and stores the result in the variable pointed to by restplp.

If an error occurs, an error value is left in *ecp.

Returns:

RDB_OK on success, RDB_ERROR if an error occurred.

Errors:

RDB_NAME_ERROR

One or more of the attributes specified by wrapv[i].attrv does not exist.

---