ajnam.c


Function ajNamPrintSvrAttr

Prints a report of the server attributes available (for entrails)

Prototype

void ajNamPrintSvrAttr (
      AjPFile outf,
      AjBool full
);

TypeNameRead/WriteDescription
AjPFileoutfModifyOutput file
AjBoolfullInputFull output if AjTrue
void RETURN

From EMBOSS 6.4.0


Function ajNamPrintDbAttr

Prints a report of the database attributes available (for entrails)

Prototype

void ajNamPrintDbAttr (
      AjPFile outf,
      AjBool full
);

TypeNameRead/WriteDescription
AjPFileoutfModifyOutput file
AjBoolfullInputFull output if AjTrue
void RETURN

From EMBOSS 2.5.0


Function ajNamPrintRsAttr

Prints a report of the resource attributes available (for entrails)

Prototype

void ajNamPrintRsAttr (
      AjPFile outf,
      AjBool full
);

TypeNameRead/WriteDescription
AjPFileoutfModifyOutput file
AjBoolfullInputFull output if AjTrue
void RETURN

From EMBOSS 2.7.0


Function ajNamSvrGetAttrC

Return the value for a server attribute

Prototype

AjBool ajNamSvrGetAttrC (
      const AjPStr name,
      const char* attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputserver name
const char*attributeInputserver attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamSvrGetAttrS

Return the value for a server attribute

Prototype

AjBool ajNamSvrGetAttrS (
      const AjPStr name,
      const AjPStr attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputserver name
const AjPStrattributeInputserver attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamSvrGetAttrlist

Return a list of names and values for all of a server defined attributes

Prototype

AjPList ajNamSvrGetAttrlist (
      const AjPStr name
);

TypeNameRead/WriteDescription
const AjPStrnameInputserver name
AjPList RETURNNam-value list

From EMBOSS 6.4.0


Function ajNamSvrGetdbAttrC

Return the value for a server database attribute

Prototype

AjBool ajNamSvrGetdbAttrC (
      const AjPStr name,
      const AjPStr dbname,
      const char* attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputserver name
const AjPStrdbnameInputdatabase name
const char*attributeInputdatabase attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamSvrGetdbAttrS

Return the value for a database attribute

Prototype

AjBool ajNamSvrGetdbAttrS (
      const AjPStr name,
      const AjPStr dbname,
      const AjPStr attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputserver name
const AjPStrdbnameInputdatabase name
const AjPStrattributeInputdatabase attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamSvrDetails

Returns server access method information

Prototype

AjBool ajNamSvrDetails (
      const AjPStr name,
      AjPStr* type,
      AjPStr* scope,
      AjBool* id,
      AjBool* qry,
      AjBool* all,
      AjPStr* comment,
      AjPStr* svrversion,
      AjPStr* methods,
      AjPStr* defined,
      AjPStr* cachedirectory,
      AjPStr* cachefile,
      AjPStr* url
);

TypeNameRead/WriteDescription
const AjPStrnameInputServer name
AjPStr*typeOutputdatatype - 'Protein', 'Nucleic' etc.
AjPStr*scopeOutputdatatype scope Sequence Features etc.
AjBool*idOutputajTrue = can access single entries
AjBool*qryOutputajTrue = can access wild/query entries
AjBool*allOutputajTrue = can access all entries
AjPStr*commentOutputcomment about server
AjPStr*svrversionOutputServer version
AjPStr*methodsOutputserver access methods formatted
AjPStr*definedOutputserver definition file short name
AjPStr*cachedirectoryOutputcache directory name
AjPStr*cachefileOutputcache file name
AjPStr*urlOutputserver URL
AjBool RETURNajTrue if server details were found

From EMBOSS 6.4.0


Function ajNamDbGetAttrC

Return the value for a database attribute

Prototype

AjBool ajNamDbGetAttrC (
      const AjPStr name,
      const char* attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputdatabase name
const char*attributeInputdatabase attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamDbGetAttrS

Return the value for a database attribute

Prototype

AjBool ajNamDbGetAttrS (
      const AjPStr name,
      const AjPStr attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputdatabase name
const AjPStrattributeInputdatabase attribute name
AjPStr*valueOutputattribute value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamDbGetAttrlist

Return a list of names and values for all of a database defined attributes

Prototype

AjPList ajNamDbGetAttrlist (
      const AjPStr name
);

TypeNameRead/WriteDescription
const AjPStrnameInputdatabase name
AjPList RETURNNam-value list

From EMBOSS 6.4.0


Function ajNamDbDetails

Returns database access method information

Prototype

AjBool ajNamDbDetails (
      const AjPStr name,
      AjPStr* type,
      AjBool* id,
      AjBool* qry,
      AjBool* all,
      AjPStr* comment,
      AjPStr* release,
      AjPStr* methods,
      AjPStr* defined
);

TypeNameRead/WriteDescription
const AjPStrnameInputDatabase name
AjPStr*typeOutputsequence type - 'P' or 'N'
AjBool*idOutputajTrue = can access single entries
AjBool*qryOutputajTrue = can access wild/query entries
AjBool*allOutputajTrue = can access all entries
AjPStr*commentOutputcomment about database
AjPStr*releaseOutputdatabase release date
AjPStr*methodsOutputdatabase access methods formatted
AjPStr*definedOutputdatabase definition file short name
AjBool RETURNajTrue if database details were found

From EMBOSS 1.0.0


Function ajNamDebugOrigin

Writes a simple list of where the internal tables came from..

Prototype

void ajNamDebugOrigin (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 1.13.0


Function ajNamDebugServers

Writes a simple debug report of all servers in the internal table.

Prototype

void ajNamDebugServers (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.4.0


Function ajNamDebugDatabases

Writes a simple debug report of all databases in the internal table.

Prototype

void ajNamDebugDatabases (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 1.13.0


Function ajNamDebugResources

Writes a simple debug report of all databases in the internal table.

Prototype

void ajNamDebugResources (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 2.7.0


Function ajNamDebugVariables

Writes a simple debug report of all environment variables in the internal table.

Prototype

void ajNamDebugVariables (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 2.7.0


Function ajNamDebugAliases

Writes a simple debug report of all aliases in the internal table.

Prototype

void ajNamDebugAliases (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.4.0


Function ajNamListListServers

Creates a AjPList list of all servers in the internal table.

Prototype

void ajNamListListServers (
      AjPList svrnames
);

TypeNameRead/WriteDescription
AjPListsvrnamesOutputStr List of names to be populated
void RETURN

From EMBOSS 6.4.0


Function ajNamListListDatabases

Creates a AjPList list of all databases in the internal table.

Prototype

void ajNamListListDatabases (
      AjPList dbnames
);

TypeNameRead/WriteDescription
AjPListdbnamesOutputStr List of names to be populated
void RETURN

From EMBOSS 1.0.0


Function ajNamListListResources

Creates a AjPList list of all databases in the internal table.

Prototype

void ajNamListListResources (
      AjPList rsnames
);

TypeNameRead/WriteDescription
AjPListrsnamesOutputStr List of names to be populated
void RETURN

From EMBOSS 2.7.0


Function ajNamIsDbname

Returns true if the name is a valid database (or server) name.

Prototype

AjBool ajNamIsDbname (
      const AjPStr name
);

TypeNameRead/WriteDescription
const AjPStrnameInputcharacter string to find in getenv list
AjBool RETURNTrue if name was defined.

From EMBOSS 3.0.0


Function ajNamGetenvC

Looks for name as an environment variable. the AjPStr for this in "value". If not found returns value as NULL;

Prototype

AjBool ajNamGetenvC (
      const char* name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const char*nameInputcharacter string to find in getenv list
AjPStr*valueOutputString for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 2.9.0


Function ajNamGetenvS

Looks for name as an environment variable. the AjPStr for this in "value". If not found returns NULL;

Prototype

AjBool ajNamGetenvS (
      const AjPStr name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputcharacter string to find in getenv list
AjPStr*valueOutputString for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 6.1.0


Function ajNamGetAliasC

Looks for name as an alias in the hash table and if found returns the AjPStr for this in "value". If not found returns NULL;

Prototype

AjBool ajNamGetAliasC (
      const char* name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const char*nameInputcharacter string find in hash table.
AjPStr*valueOutputStr for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 6.4.0


Function ajNamGetAliasS

Looks for name as an alias in the hash table and if found returns the AjPStr for this in "value". If not found returns NULL;

Prototype

AjBool ajNamGetAliasS (
      const AjPStr namestr,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnamestrInputcharacter string find in hash table.
AjPStr*valueOutputStr for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 6.4.0


Function ajNamGetValueC

Looks for name as an (upper case) environment variable, and then as-is in the hash table and if found returns the AjPStr for this in "value". If not found returns NULL;

Prototype

AjBool ajNamGetValueC (
      const char* name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const char*nameInputcharacter string find in hash table.
AjPStr*valueOutputStr for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 1.0.0


Function ajNamGetValueS

Looks for name as an (upper case) environment variable, and then as-is in the hash table and if found returns the AjPStr for this in "value". If not found returns NULL;

Prototype

AjBool ajNamGetValueS (
      const AjPStr name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputcharacter string find in hash table.
AjPStr*valueOutputString for the value.
AjBool RETURNTrue if name was defined.

From EMBOSS 6.1.0


Function ajNamServer

Looks for name in the server hash table and if found returns the attribute for this. If not found returns NULL;

Prototype

AjBool ajNamServer (
      const AjPStr name
);

TypeNameRead/WriteDescription
const AjPStrnameInputcharacter string find in hash table.
AjBool RETURNtrue if server name is valid.

From EMBOSS 6.4.0


Function ajNamDatabase

Looks for name in the database hash table and if found returns true.

Prototype

AjBool ajNamDatabase (
      const AjPStr name
);

TypeNameRead/WriteDescription
const AjPStrnameInputcharacter string find in hash table.
AjBool RETURNtrue if database name is valid.

From EMBOSS 1.0.0


Function ajNamAliasDatabase

Looks for name in the database hash table and the database hash table and if found returns the true name for this. If not found returns NULL.

Prototype

AjBool ajNamAliasDatabase (
      AjPStr* Pname
);

TypeNameRead/WriteDescription
AjPStr*PnameModifycharacter string to find in hash table.
AjBool RETURNtrue if database name is valid.

From EMBOSS 6.4.0


Function ajNamDatabaseServer

Looks for a database name for a specific server. Reads the server cache file to find the database.

Prototype

AjBool ajNamDatabaseServer (
      const AjPStr name,
      const AjPStr server
);

TypeNameRead/WriteDescription
const AjPStrnameInputDatabase name to find for server
const AjPStrserverInputServer name
AjBool RETURNtrue if database name is valid.

From EMBOSS 6.4.0


Function ajNamAliasServer

Looks for a database name for a specific server. Reads the server cache file to find the database.

Prototype

AjBool ajNamAliasServer (
      AjPStr* Pname,
      const AjPStr server
);

TypeNameRead/WriteDescription
AjPStr*PnameModifycharacter string to find in hash table.
const AjPStrserverInputServer name
AjBool RETURNtrue if database name is valid.

From EMBOSS 6.4.0


Function ajNamSvrCount

Reads the database cachefile for a server and counts the number of databases

Prototype

ajuint ajNamSvrCount (
      const AjPStr server
);

TypeNameRead/WriteDescription
const AjPStrserverInputServer name
ajuint RETURNNumber of databases

From EMBOSS 6.4.0


Function ajNamSvrListListDatabases

Reads the database cachefile for a server and lists the databases.

Prototype

void ajNamSvrListListDatabases (
      const AjPStr server,
      AjPList dbnames
);

TypeNameRead/WriteDescription
const AjPStrserverInputServer name
AjPListdbnamesOutputStr List of names to be populated
void RETURN

From EMBOSS 6.4.0


Function ajNamInit

Initialise the variable and database definitions. Find the definition files and read them.

Prototype

void ajNamInit (
      const char* prefix
);

TypeNameRead/WriteDescription
const char*prefixInputDefault prefix for all file and variable names.
void RETURN

From EMBOSS 1.0.0


Function ajNamExit

Delete the initialisation values in the table.

Prototype

void ajNamExit (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 1.0.0


Function ajNamSvrTest

Looks for a server name in the known definitions.

Prototype

AjBool ajNamSvrTest (
      const AjPStr svrname
);

TypeNameRead/WriteDescription
const AjPStrsvrnameInputServer name.
AjBool RETURNajTrue on success.

From EMBOSS 6.4.0


Function ajNamSvrGetUrl

Gets the URL definition for a server definition.

Prototype

AjBool ajNamSvrGetUrl (
      const AjPStr svrname,
      AjPStr* url
);

TypeNameRead/WriteDescription
const AjPStrsvrnameInputServer name.
AjPStr*urlOutputURL returned.
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamQueryGetDatatypeC

Gets the datatype matching a query, and updates the datatype in the query

Prototype

const char* ajNamQueryGetDatatypeC (
      const AjPQuery qry
);

TypeNameRead/WriteDescription
const AjPQueryqryInputDatabase query
const char* RETURNDatabase type

From EMBOSS 6.4.0


Function ajNamQueryGetUrl

Gets the URL definition for a server definition.

Prototype

const AjPStr ajNamQueryGetUrl (
      const AjPQuery qry
);

TypeNameRead/WriteDescription
const AjPQueryqryInputDatabase query
const AjPStr RETURNURL value

From EMBOSS 6.4.0


Function ajNamSvrGetDbalias

Gets alias names for a server's database.

Prototype

AjBool ajNamSvrGetDbalias (
      const AjPStr svrname,
      AjPStr* dbalias
);

TypeNameRead/WriteDescription
const AjPStrsvrnameInputServer name.
AjPStr*dbaliasOutputAlias returned.
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamSvrData

Given a query with server name, database name and search fields, fill in the common fields. The query fields are set later.

Prototype

AjBool ajNamSvrData (
      AjPQuery qry,
      ajuint argc,
      ...
);

TypeNameRead/WriteDescription
AjPQueryqryModifyQuery structure with at least dbname filled in
ajuintargcInputNumber of additional attribute name/value pairs
...varargVarargVariable length argument list
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamSvrQuery

Given a query with server name and search fields, fill in the access method and some common fields according to the query level.

Prototype

AjBool ajNamSvrQuery (
      AjPQuery qry
);

TypeNameRead/WriteDescription
AjPQueryqryModifyQuery structure with at least svrname filled in
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamDbTest

Looks for a database name in the known definitions.

Prototype

AjBool ajNamDbTest (
      const AjPStr dbname
);

TypeNameRead/WriteDescription
const AjPStrdbnameInputDatabase name.
AjBool RETURNajTrue on success.

From EMBOSS 1.0.0


Function ajNamDbGetType

Gets the enumerated type for a database definition.

Prototype

AjBool ajNamDbGetType (
      const AjPStr dbname,
      ajuint* itype
);

TypeNameRead/WriteDescription
const AjPStrdbnameInputDatabase name.
ajuint*itypeOutputDatabase enumerated type
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamDbGetUrl

Gets the URL definition for a database definition.

Prototype

AjBool ajNamDbGetUrl (
      const AjPStr dbname,
      AjPStr* url
);

TypeNameRead/WriteDescription
const AjPStrdbnameInputDatabase name.
AjPStr*urlOutputURL returned.
AjBool RETURNajTrue if success.

From EMBOSS 1.0.0


Function ajNamDbGetDbalias

Gets an alias name for a database.

Prototype

AjBool ajNamDbGetDbalias (
      const AjPStr dbname,
      AjPStr* dbalias
);

TypeNameRead/WriteDescription
const AjPStrdbnameInputDatabase name.
AjPStr*dbaliasOutputAlias returned.
AjBool RETURNajTrue if success.

From EMBOSS 1.0.0


Function ajNamDbGetIndexdir

Gets the index directory for a database.

Prototype

AjBool ajNamDbGetIndexdir (
      const AjPStr dbname,
      AjPStr* indexdir
);

TypeNameRead/WriteDescription
const AjPStrdbnameInputDatabase name.
AjPStr*indexdirOutputDirectory path returned.
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamQuerySetDbalias

Sets an alias name for a database query.

Prototype

AjBool ajNamQuerySetDbalias (
      AjPQuery qry
);

TypeNameRead/WriteDescription
AjPQueryqryModifyDatabase query.
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamDbData

Given a query with database name and search fields, fill in the common fields. The query fields are set later.

Prototype

AjBool ajNamDbData (
      AjPQuery qry,
      ajuint argc,
      ...
);

TypeNameRead/WriteDescription
AjPQueryqryModifyQuery structure with at least dbname filled in
ajuintargcInputNumber of additional attribute name/value pairs
...varargVarargVariable length argument list
AjBool RETURNajTrue if success.

From EMBOSS 2.4.0


Function ajNamDbQuery

Given a query with database name and search fields, fill in the access method and some common fields according to the query level.

Prototype

AjBool ajNamDbQuery (
      AjPQuery qry
);

TypeNameRead/WriteDescription
AjPQueryqryModifyQuery structure with at least dbname filled in
AjBool RETURNajTrue if success.

From EMBOSS 1.0.0


Function ajNamFileQuery

Given a query with no database name and search fields, check datatype specific fields according to the query level.

Prototype

AjBool ajNamFileQuery (
      AjPQuery qry
);

TypeNameRead/WriteDescription
AjPQueryqryModifyQuery structure with no database name
AjBool RETURNajTrue if success.

From EMBOSS 6.4.0


Function ajNamValueInstalldir

Returns the install directory root for all file searches (package level)

Prototype

const AjPStr ajNamValueInstalldir (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNInstall directory root

From EMBOSS 6.0.0


Function ajNamValuePackage

Returns the package name for the library

Prototype

const AjPStr ajNamValuePackage (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNPackage name

From EMBOSS 6.0.0


Function ajNamValueSystem

Returns the system information for the library

Prototype

const AjPStr ajNamValueSystem (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNVersion number

From EMBOSS 6.2.0


Function ajNamValueVersion

Returns the version number for the library

Prototype

const AjPStr ajNamValueVersion (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNVersion number

From EMBOSS 6.0.0


Function ajNamValueRootdir

Returns the directory for all file searches (package level)

Prototype

const AjPStr ajNamValueRootdir (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNPackage level root directory

From EMBOSS 6.0.0


Function ajNamValueBasedir

Returns the base directory for all for all file searches (above package level).

Prototype

const AjPStr ajNamValueBasedir (
      void
);

TypeNameRead/WriteDescription
const AjPStr RETURNBase directory

From EMBOSS 6.0.0


Function ajNamResolve

Resolves a variable name if the input string starts with a dollar sign.

Prototype

AjBool ajNamResolve (
      AjPStr* name
);

TypeNameRead/WriteDescription
AjPStr*nameOutputString
AjBool RETURNajTrue on success.

From EMBOSS 1.0.0


Function ajNamSetControl

Sets special internal variables to reflect their presence.

Prototype

AjBool ajNamSetControl (
      const char* optionName
);

TypeNameRead/WriteDescription
const char*optionNameInputoption name
AjBool RETURNajTrue if option was recognised

From EMBOSS 2.7.0


Function ajNamRsAttrValueC

Return the value for a resource attribute

Prototype

AjBool ajNamRsAttrValueC (
      const char* name,
      const char* attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const char*nameInputresource name
const char*attributeInputresource attribute
AjPStr*valueOutputresource value
AjBool RETURNtrue if found

From EMBOSS 3.0.0


Function ajNamRsAttrValueS

Return the value for a resource attribute

Prototype

AjBool ajNamRsAttrValueS (
      const AjPStr name,
      const AjPStr attribute,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputresource name
const AjPStrattributeInputresource attribute
AjPStr*valueOutputresource value
AjBool RETURNtrue if found

From EMBOSS 6.4.0


Function ajNamRsListValue

Return the value for a resource attribute of type 'list'

Prototype

AjBool ajNamRsListValue (
      const AjPStr name,
      AjPStr* value
);

TypeNameRead/WriteDescription
const AjPStrnameInputresource name
AjPStr*valueOutputresource value
AjBool RETURNtrue if found

From EMBOSS 3.0.0