pseudoana.h File Reference

---

Detailed Description

Pseudoana table management used by the db module.

#include <dballe/db/internals.h>

Go to the source code of this file.

Data Structures
struct	_dba_db_pseudoana
	Precompiled query to manipulate the pseudoana table. More...
Typedefs
typedef struct _dba_db_pseudoana *	dba_db_pseudoana
	Precompiled query to manipulate the pseudoana table.
Functions
dba_err	dba_db_pseudoana_create (dba_db db, dba_db_pseudoana *ins)
	Create a new dba_db_pseudoana.
void	dba_db_pseudoana_delete (dba_db_pseudoana ins)
	Deletes a dba_db_pseudoana.
void	dba_db_pseudoana_set_ident (dba_db_pseudoana ins, const char *ident)
	Set the mobile station identifier input value for this dba_db_pseudoana.
dba_err	dba_db_pseudoana_get_id (dba_db_pseudoana ins, int *id)
	Get the pseudoana ID given latitude, longitude and mobile identifier.
dba_err	dba_db_pseudoana_get_data (dba_db_pseudoana ins, int id)
	Get pseudoana information given a pseudoana ID.
dba_err	dba_db_pseudoana_insert (dba_db_pseudoana ins, int *id)
	Insert a new pseudoana entry.
dba_err	dba_db_pseudoana_update (dba_db_pseudoana ins)
	Update the information about a pseudoana entry.
dba_err	dba_db_pseudoana_remove (dba_db_pseudoana ins)
	Remove a pseudoana record.

---

Function Documentation

dba_err dba_db_pseudoana_create	(	dba_db	db,
		dba_db_pseudoana *	ins
	)

Create a new dba_db_pseudoana.

Parameters:

db

The dba_db this dba_db_pseudoana will access

Return values:

ins

The newly created dba_db_pseudoana (it will need to be deallocated wth dba_db_pseudoana_delete())

Returns:

The error indicator for the function (See error.h)

References _dba_db_pseudoana::db, DBA_RUN_OR_GOTO, _dba_db_pseudoana::dstm, _dba_db_pseudoana::id, _dba_db_pseudoana::ident, _dba_db_pseudoana::ident_ind, _dba_db_pseudoana::istm, _dba_db_pseudoana::lat, _dba_db_pseudoana::lon, _dba_db::server_type, _dba_db_pseudoana::sfstm, _dba_db_pseudoana::smstm, _dba_db_pseudoana::sstm, and _dba_db_pseudoana::ustm.

void dba_db_pseudoana_delete

(

dba_db_pseudoana

ins

)

Deletes a dba_db_pseudoana.

Parameters:

ins

The dba_db_pseudoana to delete

References _dba_db_pseudoana::istm, _dba_db_pseudoana::sfstm, _dba_db_pseudoana::smstm, _dba_db_pseudoana::sstm, and _dba_db_pseudoana::ustm.

dba_err dba_db_pseudoana_get_data	(	dba_db_pseudoana	ins,
		int	id
	)

Get pseudoana information given a pseudoana ID.

Parameters:

	ins	dba_db_pseudoana to query
	id	ID of the station to query

Returns:

The error indicator for the function (See error.h)

References dba_error_notfound, _dba_db_pseudoana::id, _dba_db_pseudoana::ident, _dba_db_pseudoana::ident_ind, and _dba_db_pseudoana::sstm.

dba_err dba_db_pseudoana_get_id	(	dba_db_pseudoana	ins,
		int *	id
	)

Get the pseudoana ID given latitude, longitude and mobile identifier.

Parameters:

ins

dba_db_pseudoana to query

Return values:

id

Resulting ID of the station

Returns:

The error indicator for the function (See error.h)

References _dba_db_pseudoana::id, _dba_db_pseudoana::ident_ind, _dba_db_pseudoana::sfstm, and _dba_db_pseudoana::smstm.

dba_err dba_db_pseudoana_insert	(	dba_db_pseudoana	ins,
		int *	id
	)

Insert a new pseudoana entry.

Parameters:

ins

dba_db_pseudoana with all the input values filled in

Return values:

id

ID of the newly inserted station

Returns:

The error indicator for the function (See error.h)

References _dba_db_pseudoana::db, DBA_RUN_OR_RETURN, _dba_db_pseudoana::istm, _dba_db::seq_pseudoana, and _dba_db::server_type.

dba_err dba_db_pseudoana_remove

(

dba_db_pseudoana

ins

)

Remove a pseudoana record.

Parameters:

ins

The dba_db_pseudoana structure, with id filled with the id of the pseudoana to remove.

Returns:

The error indicator for the function (See error.h)

References _dba_db_pseudoana::dstm.

void dba_db_pseudoana_set_ident	(	dba_db_pseudoana	ins,
		const char *	ident
	)

Set the mobile station identifier input value for this dba_db_pseudoana.

Parameters:

	ins	dba_db_pseudoana structure to fill in
	ident	Value to copy into ins. NULL can be used to unset ident.

References _dba_db_pseudoana::ident, and _dba_db_pseudoana::ident_ind.

dba_err dba_db_pseudoana_update

(

dba_db_pseudoana

ins

)

Update the information about a pseudoana entry.

Parameters:

ins

dba_db_pseudoana with all the input values filled in

Returns:

The error indicator for the function (See error.h)

References _dba_db_pseudoana::ustm.