ajtax.c

Datatypes:
AjPTax Taxonomy data
AjPTaxcit Taxonomy citation data
AjPTaxcode Taxonomy genetic code data
AjPTaxname Taxonomy name data
none Miscellaneous functions


Datatype: AjPTax

Function is for manipulating taxonomy data objects

Sections:
constructorsConstructors
Taxonomy data destructorsDestructors
CastsCasts
taxonomy data modifiersModifiers


AjPTax: constructors

Constructors

Functions:
ajTaxNewTax data constructor
ajTaxNewTaxTaxon copy constructor


Function ajTaxNew

Tax data constructor

Prototype

AjPTax ajTaxNew (
      void
);

TypeNameRead/WriteDescription
AjPTax RETURNNew object

From EMBOSS 6.3.0


Function ajTaxNewTax

Taxon copy constructor

Prototype

AjPTax ajTaxNewTax (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
AjPTax RETURNNew object

From EMBOSS 6.4.0


AjPTax: Taxonomy data destructors

Destruction destroys all internal data structures and frees the memory allocated for the taxonomy data object.

Functions:
ajTaxDelTaxonomy data destructor


Function ajTaxDel

Taxonomy data destructor

Prototype

void ajTaxDel (
      AjPTax* Ptax
);

TypeNameRead/WriteDescription
AjPTax*PtaxDeleteTaxonomy data object to delete
void RETURN

From EMBOSS 6.3.0


AjPTax: Casts

Return values from a taxonomy data object

Functions:
ajTaxGetDbReturn the database name
ajTaxGetIdReturn the identifier
ajTaxGetNameReturn the name
ajTaxGetParentReturn the parent id of a taxon
ajTaxGetQryCReturns the query string of a taxonomy data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.
ajTaxGetQrySReturns the query string of a taxonomy data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.
ajTaxGetRankReturn the taxonomic rank
ajTaxGetTreeReturn a list with all this taxon's descendants appended
ajTaxIsHiddenTests whether a taxon had tghe GenBank "hidden" flag set.
ajTaxIsSpeciesTests whether a taxon is at the rank of 'species'


Function ajTaxGetDb

Return the database name

Prototype

const AjPStr ajTaxGetDb (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
const AjPStr RETURNDatabase name

From EMBOSS 6.4.0


Function ajTaxGetId

Return the identifier

Prototype

const AjPStr ajTaxGetId (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
const AjPStr RETURNReturned id

From EMBOSS 6.4.0


Function ajTaxGetName

Return the name

Prototype

const AjPStr ajTaxGetName (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
const AjPStr RETURNReturned name

From EMBOSS 6.4.0


Function ajTaxGetParent

Return the parent id of a taxon

Prototype

ajuint ajTaxGetParent (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
ajuint RETURNParent id

From EMBOSS 6.4.0


Function ajTaxGetQryC

Returns the query string of a taxonomy data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

Prototype

const char* ajTaxGetQryC (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxonomy data object.
const char* RETURNQuery as a character string.

From EMBOSS 6.4.0


Function ajTaxGetQryS

Returns the query string of a taxonomy data object. Because this is a pointer to the real internal string the caller must take care not to change the character string in any way. If the string is to be changed (case for example) then it must first be copied.

Prototype

const AjPStr ajTaxGetQryS (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxonomy data object.
const AjPStr RETURNQuery as a string.

From EMBOSS 6.4.0


Function ajTaxGetRank

Return the taxonomic rank

Prototype

const AjPStr ajTaxGetRank (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
const AjPStr RETURNReturned rank

From EMBOSS 6.4.0


Function ajTaxGetTree

Return a list with all this taxon's descendants appended

Prototype

ajuint ajTaxGetTree (
      const AjPTax tax,
      AjPList taxlist
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
AjPListtaxlistModifyList of taxons
ajuint RETURNNumber of taxons returned

From EMBOSS 6.4.0


Function ajTaxIsHidden

Tests whether a taxon had tghe GenBank "hidden" flag set.

Prototype

AjBool ajTaxIsHidden (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
AjBool RETURNTrue if node is hidden in GenBank taxonomy record

From EMBOSS 6.4.0


Function ajTaxIsSpecies

Tests whether a taxon is at the rank of 'species'

Prototype

AjBool ajTaxIsSpecies (
      const AjPTax tax
);

TypeNameRead/WriteDescription
const AjPTaxtaxInputTaxon
AjBool RETURNTrue if taxon is a species

From EMBOSS 6.4.0


AjPTax: taxonomy data modifiers

Taxonomy data modifiers

Functions:
ajTaxClearResets all data for a taxonomy data object so that it can be reused.


Function ajTaxClear

Resets all data for a taxonomy data object so that it can be reused.

Prototype

void ajTaxClear (
      AjPTax tax
);

TypeNameRead/WriteDescription
AjPTaxtaxModifyTaxonomy data object
void RETURN

From EMBOSS 6.4.0


Datatype: AjPTaxcit

Function is for manipulating taxonomy citation data objects

Sections:
constructorsConstructors
destructorsDestructors


AjPTaxcit: constructors

Constructors

Functions:
ajTaxcitNewTaxonomy citation constructor


Function ajTaxcitNew

Taxonomy citation constructor

Prototype

AjPTaxcit ajTaxcitNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxcit RETURNNew object

From EMBOSS 6.4.0


AjPTaxcit: destructors

Destruction destroys all internal data structures and frees the memory allocated for the taxon citation object.

Functions:
ajTaxcitDelTaxonomy citation destructor


Function ajTaxcitDel

Taxonomy citation destructor

Prototype

void ajTaxcitDel (
      AjPTaxcit* Pcit
);

TypeNameRead/WriteDescription
AjPTaxcit*PcitDeleteTaxon citation object
void RETURN

From EMBOSS 6.4.0


Datatype: AjPTaxcode

Function is for manipulating taxonomy genetic code data objects

Sections:
constructorsConstructors


AjPTaxcode: constructors

Constructors

Functions:
ajTaxcodeNewTaxonomy genetic code constructor


Function ajTaxcodeNew

Taxonomy genetic code constructor

Prototype

AjPTaxcode ajTaxcodeNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxcode RETURNNew object

From EMBOSS 6.4.0


Function ajTaxdelNew

Taxonomy deleted id constructor

Prototype

AjPTaxdel ajTaxdelNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxdel RETURNNew object

From EMBOSS 6.4.0


Function ajTaxdivNew

Taxonomy division constructor

Prototype

AjPTaxdiv ajTaxdivNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxdiv RETURNNew object

From EMBOSS 6.4.0


Function ajTaxmergeNew

Taxonomy merged id constructor

Prototype

AjPTaxmerge ajTaxmergeNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxmerge RETURNNew object

From EMBOSS 6.4.0


Function ajTaxnameNew

Taxonomy names constructor

Prototype

AjPTaxname ajTaxnameNew (
      void
);

TypeNameRead/WriteDescription
AjPTaxname RETURNNew object

From EMBOSS 6.4.0


Function ajTaxnameNewName

Taxonomy names copy constructor

Prototype

AjPTaxname ajTaxnameNewName (
      const AjPTaxname name
);

TypeNameRead/WriteDescription
const AjPTaxnamenameInputName
AjPTaxname RETURNNew object

From EMBOSS 6.4.0


Datatype: AjPTaxname

Function is for manipulating taxonomy name data objects

Sections:
destructorsDestructors


AjPTaxname: destructors

Destruction destroys all internal data structures and frees the memory allocated for the taxon name object.

Functions:
ajTaxnameDelTaxonomy names destructor


Function ajTaxnameDel

Taxonomy names destructor

Prototype

void ajTaxnameDel (
      AjPTaxname* Pname
);

TypeNameRead/WriteDescription
AjPTaxname*PnameDeleteTaxon name object
void RETURN

From EMBOSS 6.4.0


Datatype: none

Functions to initialise and clean up internals

Sections:
exitMiscellaneous


Section: exit

Functions called on exit from the program by ajExit to do any necessary cleanup and to report internal statistics to the debug file

Functions:
ajTaxExitCleans up taxonomy processing internal memory


Function ajTaxExit

Cleans up taxonomy processing internal memory

Prototype

void ajTaxExit (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.4.0