ajsql.c

Datatypes:
none Internals
AjPSqlconnection SQL Connection
AjESqlconnectionClient SQL Connection Client
AjPSqlstatement AJAX SQL Statement
AjISqlrow AJAX SQL Row Iterator
AjPSqlrow AJAX SQL Row
AjPVoid Void pointer


Datatype: none

Function is for setup or control of internals

Sections:
initializationInternals
exitingInternals


Section: initialization

Functions:
ajSqlInitInitialises implementation-specific SQL client libraries.


Function ajSqlInit

Initialises implementation-specific SQL client libraries.

Prototype

AjBool ajSqlInit (
      void
);

TypeNameRead/WriteDescription
AjBool RETURNajTrue if the initialisation was successful.

From EMBOSS 6.2.0


Section: exiting

Functions:
ajSqlExitFinalises implementation-specific SQL client libraries.


Function ajSqlExit

Finalises implementation-specific SQL client libraries.

Prototype

void ajSqlExit (
      void
);

TypeNameRead/WriteDescription
void RETURN

From EMBOSS 6.2.0


Datatype: AjPSqlconnection

Functions for manipulating AJAX SQL Connections.

Sections:
constructorsConstructors
destructorsDestructors
CastCasts
debuggingMiscellaneous


AjPSqlconnection: constructors

Functions for constructing AJAX SQL Connection objects.

Functions:
ajSqlconnectionNewDataDefault AJAX SQL Connection constructor, which also allocates a client library-specific connection object.
ajSqlconnectionNewRefEnsembl Object referencing function, which returns a pointer to the Ensembl Object passed in and increases its reference count.


Function ajSqlconnectionNewData

Default AJAX SQL Connection constructor, which also allocates a client library-specific connection object.

Prototype

AjPSqlconnection ajSqlconnectionNewData (
      AjESqlconnectionClient client,
      const AjPStr user,
      const AjPStr password,
      const AjPStr host,
      const AjPStr port,
      const AjPStr socketfile,
      const AjPStr database
);

TypeNameRead/WriteDescription
AjESqlconnectionClientclientModifySQL client
const AjPStruserInputSQL account user name
const AjPStrpasswordInputSQL account password
const AjPStrhostInputSQL server hostname or IP address
const AjPStrportInputSQL server port number
const AjPStrsocketfileInputSQL server UNIX socket file MySQL: Absolute path to the socket file. PostgreSQL: Absolute path to the socket directory only. Socket file names are then generated from this directory information and the port number above. See "%s/.s.PGSQL.%d" in macro UNIXSOCK_PATH in source file pgsql/src/include/libpq/pqcomm.h
const AjPStrdatabaseInputSQL database name
AjPSqlconnection RETURNAJAX SQL Connection or NULL

From EMBOSS 6.2.0


Function ajSqlconnectionNewRef

Ensembl Object referencing function, which returns a pointer to the Ensembl Object passed in and increases its reference count.

Prototype

AjPSqlconnection ajSqlconnectionNewRef (
      AjPSqlconnection sqlc
);

TypeNameRead/WriteDescription
AjPSqlconnectionsqlcModifyAJAX SQL Connection
AjPSqlconnection RETURNAJAX SQL Connection or NULL

From EMBOSS 6.2.0


AjPSqlconnection: destructors

Functions for destruction of AJAX SQL Connection objects.

Functions:
ajSqlconnectionDelDefault AJAX SQL Connection destructor, which disconnects from the SQL server first, frees the client library-specific connection object and finally the AJAX SQL Connection object.


Function ajSqlconnectionDel

Default AJAX SQL Connection destructor, which disconnects from the SQL server first, frees the client library-specific connection object and finally the AJAX SQL Connection object.

Prototype

void ajSqlconnectionDel (
      AjPSqlconnection* Psqlc
);

TypeNameRead/WriteDescription
AjPSqlconnection*PsqlcDeleteAJAX SQL Connection address
void RETURN

From EMBOSS 6.2.0


AjPSqlconnection: Cast

Functions for returning elements of an AJAX SQL Connection object.

Functions:
ajSqlconnectionEscapeCEscape special characters in an AJAX String for use in an SQL statement, taking into account the current character set of the AJAX SQL Connection and return a C-type character string.
ajSqlconnectionEscapeSEscape special characters in an AJAX String for use in an SQL statement, taking into account the current character set of the AJAX SQL Connection and return an AJAX String.
ajSqlconnectionGetClientGet the client element of an AJAX SQL Connection.
ajSqlconnectionGetUseGet the use counter element of an AJAX SQL Connection.


Function ajSqlconnectionEscapeC

Escape special characters in an AJAX String for use in an SQL statement, taking into account the current character set of the AJAX SQL Connection and return a C-type character string.

Prototype

AjBool ajSqlconnectionEscapeC (
      const AjPSqlconnection sqlc,
      char** Ptxt,
      const AjPStr str
);

TypeNameRead/WriteDescription
const AjPSqlconnectionsqlcInputAJAX SQL Connection
char**PtxtOutputAddress of the (new) SQL-escaped C-type string
const AjPStrstrInputAJAX String to be escaped
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlconnectionEscapeS

Escape special characters in an AJAX String for use in an SQL statement, taking into account the current character set of the AJAX SQL Connection and return an AJAX String.

Prototype

AjBool ajSqlconnectionEscapeS (
      const AjPSqlconnection sqlc,
      AjPStr* Pstr,
      const AjPStr str
);

TypeNameRead/WriteDescription
const AjPSqlconnectionsqlcInputAJAX SQL Connection
AjPStr*PstrOutputAddress of the (new) SQL-escaped AJAX String
const AjPStrstrInputAJAX String to be escaped
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlconnectionGetClient

Get the client element of an AJAX SQL Connection.

Prototype

AjESqlconnectionClient ajSqlconnectionGetClient (
      const AjPSqlconnection sqlc
);

TypeNameRead/WriteDescription
const AjPSqlconnectionsqlcInputAJAX SQL Connection
AjESqlconnectionClient RETURNAJAX SQL Connection client or ajESqlconnectionClientNULL

From EMBOSS 6.2.0


Function ajSqlconnectionGetUse

Get the use counter element of an AJAX SQL Connection.

Prototype

ajuint ajSqlconnectionGetUse (
      const AjPSqlconnection sqlc
);

TypeNameRead/WriteDescription
const AjPSqlconnectionsqlcInputAJAX SQL Connection
ajuint RETURNUse counter

From EMBOSS 6.3.0


AjPSqlconnection: debugging

Functions for reporting of an AJAX SQL Connection object.

Functions:
ajSqlconnectionTraceTrace an AJAX SQL Connection.


Function ajSqlconnectionTrace

Trace an AJAX SQL Connection.

Prototype

AjBool ajSqlconnectionTrace (
      const AjPSqlconnection sqlc,
      ajuint level
);

TypeNameRead/WriteDescription
const AjPSqlconnectionsqlcInputAJAX SQL Connection
ajuintlevelInputIndentation level
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Datatype: AjESqlconnectionClient

Functions for manipulating AJAX SQL Connection clients.

Sections:
MiscMiscellaneous
CastCasts


AjESqlconnectionClient: Misc

Functions for returning a AJAX SQL Connection Client enumeration

Functions:
ajSqlconnectionClientFromStrConvert an AJAX String into an AJAX SQL Connection client element.


Function ajSqlconnectionClientFromStr

Convert an AJAX String into an AJAX SQL Connection client element.

Prototype

AjESqlconnectionClient ajSqlconnectionClientFromStr (
      const AjPStr client
);

TypeNameRead/WriteDescription
const AjPStrclientInputClient string
AjESqlconnectionClient RETURNAJAX SQL Connection client or ajESqlconnectionClientNULL

From EMBOSS 6.3.0


AjESqlconnectionClient: Cast

Functions for returning attributes of an AJAX SQL Connection client enumeration

Functions:
ajSqlconnectionClientToCharConvert an AJAX SQL Connection client element into a C-type (char*) string.


Function ajSqlconnectionClientToChar

Convert an AJAX SQL Connection client element into a C-type (char*) string.

Prototype

const char* ajSqlconnectionClientToChar (
      AjESqlconnectionClient client
);

TypeNameRead/WriteDescription
AjESqlconnectionClientclientModifySQL Connection client
const char* RETURNSQL Connection client C-type (char*) string

From EMBOSS 6.3.0


Datatype: AjPSqlstatement

Functions for manipulating AJAX SQL Statements.

Sections:
constructorsConstructors
destructorsDestructors
castCasts


AjPSqlstatement: constructors

Functions for constructing AJAX SQL Statement objects.

Functions:
ajSqlstatementNewRefEnsembl Object referencing function, which returns a pointer to the Ensembl Object passed in and increases its reference count.
ajSqlstatementNewRunDefault AJAX SQL Statement constructor. Upon construction the SQL Statement is run against the SQL server specified in the AJAX SQL Connection. Eventual results of the SQL Statement are then stored inside this object.


Function ajSqlstatementNewRef

Ensembl Object referencing function, which returns a pointer to the Ensembl Object passed in and increases its reference count.

Prototype

AjPSqlstatement ajSqlstatementNewRef (
      AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
AjPSqlstatementsqlsModifyAJAX SQL Statement
AjPSqlstatement RETURNAJAX SQL Statement or NULL

From EMBOSS 6.2.0


Function ajSqlstatementNewRun

Default AJAX SQL Statement constructor. Upon construction the SQL Statement is run against the SQL server specified in the AJAX SQL Connection. Eventual results of the SQL Statement are then stored inside this object.

Prototype

AjPSqlstatement ajSqlstatementNewRun (
      AjPSqlconnection sqlc,
      const AjPStr statement
);

TypeNameRead/WriteDescription
AjPSqlconnectionsqlcModifyAJAX SQL Connection
const AjPStrstatementInputSQL statement
AjPSqlstatement RETURNAJAX SQL Statement or NULL

From EMBOSS 6.2.0


AjPSqlstatement: destructors

Functions for destruction of AJAX SQL Statement objects.

Functions:
ajSqlstatementDelDefault AJAX SQL Statement destructor, which also destroys the SQL client library-specific result object.


Function ajSqlstatementDel

Default AJAX SQL Statement destructor, which also destroys the SQL client library-specific result object.

Prototype

void ajSqlstatementDel (
      AjPSqlstatement* Psqls
);

TypeNameRead/WriteDescription
AjPSqlstatement*PsqlsDeleteAJAX SQL Statement address
void RETURN

From EMBOSS 6.2.0


AjPSqlstatement: cast

Functions:
ajSqlstatementGetAffectedrowsGet the number of rows affected by a non-SELECT SQL statement.
ajSqlstatementGetColumnsGet the number of columns returned by a SELECT-like SQL statement.
ajSqlstatementGetIdentifierGet the identifier of a row inserted by the last INSERT-like SQL statement.
ajSqlstatementGetSelectedrowsGet the number of rows selected by a SELECT-like SQL statement.


Function ajSqlstatementGetAffectedrows

Get the number of rows affected by a non-SELECT SQL statement.

Prototype

ajulong ajSqlstatementGetAffectedrows (
      const AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
const AjPSqlstatementsqlsInputAJAX SQL Statement
ajulong RETURNNumber of affected rows

From EMBOSS 6.2.0


Function ajSqlstatementGetColumns

Get the number of columns returned by a SELECT-like SQL statement.

Prototype

ajuint ajSqlstatementGetColumns (
      const AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
const AjPSqlstatementsqlsInputAJAX SQL Statement
ajuint RETURNNumber of selected columns

From EMBOSS 6.2.0


Function ajSqlstatementGetIdentifier

Get the identifier of a row inserted by the last INSERT-like SQL statement.

Prototype

ajuint ajSqlstatementGetIdentifier (
      const AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
const AjPSqlstatementsqlsInputAJAX SQL Statement
ajuint RETURNIdentifier of last inserted row

From EMBOSS 6.2.0


Function ajSqlstatementGetSelectedrows

Get the number of rows selected by a SELECT-like SQL statement.

Prototype

ajulong ajSqlstatementGetSelectedrows (
      const AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
const AjPSqlstatementsqlsInputAJAX SQL Statement
ajulong RETURNNumber of selected rows

From EMBOSS 6.2.0


Datatype: AjISqlrow

Functions for manipulating AJAX SQL Row Iterators.

Sections:
constructorsConstructors
destructorsDestructors
testsGeneral use
steppingModifiers
modifiersModifiers


AjISqlrow: constructors

Functions for constructing AJAX SQL Row Iterator objects.

Functions:
ajSqlrowiterNewDefault AJAX SQL Row Iterator constructor.


Function ajSqlrowiterNew

Default AJAX SQL Row Iterator constructor.

Prototype

AjISqlrow ajSqlrowiterNew (
      AjPSqlstatement sqls
);

TypeNameRead/WriteDescription
AjPSqlstatementsqlsModifyAJAX SQL Statement
AjISqlrow RETURNAJAX SQL Row Iterator or NULL if the AJAX SQL Statement did not return rows and columns

From EMBOSS 6.2.0


AjISqlrow: destructors

Functions for destruction of AJAX SQL Row Iterator objects.

Functions:
ajSqlrowiterDelDefault AJAX SQL Row Iterator destructor.


Function ajSqlrowiterDel

Default AJAX SQL Row Iterator destructor.

Prototype

void ajSqlrowiterDel (
      AjISqlrow* Psqli
);

TypeNameRead/WriteDescription
AjISqlrow*PsqliDeleteAJAX SQL Row Iterator address
void RETURN

From EMBOSS 6.2.0


AjISqlrow: tests

Functions:
ajSqlrowiterDoneTests whether an AJAX SQL Row Iterator has completed yet.


Function ajSqlrowiterDone

Tests whether an AJAX SQL Row Iterator has completed yet.

Prototype

AjBool ajSqlrowiterDone (
      const AjISqlrow sqli
);

TypeNameRead/WriteDescription
const AjISqlrowsqliInputAJAX SQL Row Iterator
AjBool RETURNajTrue if the iterator is exhausted

From EMBOSS 6.2.0


AjISqlrow: stepping

Functions:
ajSqlrowiterGetReturns the next AJAX SQL Row using the iterator, or steps off the end.


Function ajSqlrowiterGet

Returns the next AJAX SQL Row using the iterator, or steps off the end.

Prototype

AjPSqlrow ajSqlrowiterGet (
      AjISqlrow sqli
);

TypeNameRead/WriteDescription
AjISqlrowsqliModifyAJAX SQL Row Iterator
AjPSqlrow RETURNAJAX SQL Row or NULL

From EMBOSS 6.2.0


AjISqlrow: modifiers

Functions:
ajSqlrowiterRewindRewind an AJAX SQL Row Iterator to the start position.


Function ajSqlrowiterRewind

Rewind an AJAX SQL Row Iterator to the start position.

Prototype

AjBool ajSqlrowiterRewind (
      AjISqlrow sqli
);

TypeNameRead/WriteDescription
AjISqlrowsqliModifyAJAX SQL Row Iterator
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Datatype: AjPSqlrow

Functions for manipulating AJAX SQL Rows.

Sections:
constructorsConstructors
destructorsDestructors
element retrievalGeneral use


AjPSqlrow: constructors

Functions for constructing AJAX SQL Row objects.

Functions:
ajSqlrowNewDefault AJAX SQL Row constructor.


Function ajSqlrowNew

Default AJAX SQL Row constructor.

Prototype

AjPSqlrow ajSqlrowNew (
      ajuint columns
);

TypeNameRead/WriteDescription
ajuintcolumnsInputNumber of columns per AJAX SQL Row
AjPSqlrow RETURNAJAX SQL Row

From EMBOSS 6.2.0


AjPSqlrow: destructors

Functions for destruction of AJAX SQL Row objects.

Functions:
ajSqlrowDelDefault AJAX SQL Row destructor.


Function ajSqlrowDel

Default AJAX SQL Row destructor.

Prototype

void ajSqlrowDel (
      AjPSqlrow* Psqlr
);

TypeNameRead/WriteDescription
AjPSqlrow*PsqlrDeleteAJAX SQL Row address
void RETURN

From EMBOSS 6.2.0


AjPSqlrow: element retrieval

Functions for returning elements of an AJAX SQL Row object.

Functions:
ajSqlrowGetColumnsGet the number of columns in an AJAX SQL Row.
ajSqlrowGetCurrentGet the number of the current column in column iterations of an AJAX SQL Row.
ajSqlrowGetLengthsGet the AJAX Long Integer Array of column value lengths in an AJAX SQL Row.
ajSqlrowGetValuesGet the AJAX Void Pointer Array of column values in an AJAX SQL Row.


Function ajSqlrowGetColumns

Get the number of columns in an AJAX SQL Row.

Prototype

ajuint ajSqlrowGetColumns (
      const AjPSqlrow sqlr
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuint RETURNNumber of columns in an AJAX SQL Row

From EMBOSS 6.2.0


Function ajSqlrowGetCurrent

Get the number of the current column in column iterations of an AJAX SQL Row.

Prototype

ajuint ajSqlrowGetCurrent (
      const AjPSqlrow sqlr
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuint RETURNNumber of current column of an AJAX SQL Row

From EMBOSS 6.2.0


Function ajSqlrowGetLengths

Get the AJAX Long Integer Array of column value lengths in an AJAX SQL Row.

Prototype

AjPLong ajSqlrowGetLengths (
      const AjPSqlrow sqlr
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
AjPLong RETURNAJAX Long Integer Array

From EMBOSS 6.2.0


Function ajSqlrowGetValues

Get the AJAX Void Pointer Array of column values in an AJAX SQL Row.

Prototype

AjPVoid ajSqlrowGetValues (
      const AjPSqlrow sqlr
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
AjPVoid RETURNAJAX Void Pointer Array

From EMBOSS 6.2.0


AjPSqlrow: column modifiers

Functions:
ajSqlcolumnRewindRewind an AJAX SQL Column Iterator to the start position.


Function ajSqlcolumnRewind

Rewind an AJAX SQL Column Iterator to the start position.

Prototype

AjBool ajSqlcolumnRewind (
      AjPSqlrow sqlr
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


AjPSqlrow: column retrieval

Functions:
ajSqlcolumnGetValueGet the value of the next column of an AJAX SQL Row. Calling this function also advances the column iterator.


Function ajSqlcolumnGetValue

Get the value of the next column of an AJAX SQL Row. Calling this function also advances the column iterator.

Prototype

AjBool ajSqlcolumnGetValue (
      AjPSqlrow sqlr,
      void** Pvalue,
      ajulong* Plength
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
void**PvalueModifyValue address
ajulong*PlengthModifyValue length address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


AjPSqlrow: column to datatype conversion functions

Functions for converting SQL Column values to other datatypes.

Functions:
ajSqlcolumnToBoolConverts the value in the next column of an AJAX SQL Row into an AJAX Boolean value.
ajSqlcolumnToDoubleConverts the value in the next column of an AJAX SQL Row into a C-type double value.
ajSqlcolumnToFloatConverts the value in the next column of an AJAX SQL Row into a C-type float value.
ajSqlcolumnToIntConverts the value in the next column of an AJAX SQL Row into an AJAX Integer value.
ajSqlcolumnToLongConverts the value in the next column of an AJAX SQL Row into an AJAX Long Integer value.
ajSqlcolumnToStrConverts the value of the next column of an AJAX SQL Row into an AJAX String value.
ajSqlcolumnToTimeConverts the value in the next column of an AJAX SQL Row into an AJAX Time value.
ajSqlcolumnToUintConverts the value in the next column of an AJAX SQL Row into an AJAX Unsigned Integer value.
ajSqlcolumnToUlongConverts the value in the next column of an AJAX SQL Row into an AJAX Unsigned Long Integer value.


Function ajSqlcolumnToBool

Converts the value in the next column of an AJAX SQL Row into an AJAX Boolean value.

Prototype

AjBool ajSqlcolumnToBool (
      AjPSqlrow sqlr,
      AjBool* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
AjBool*PvalueOutputAJAX Boolean address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToDouble

Converts the value in the next column of an AJAX SQL Row into a C-type double value.

Prototype

AjBool ajSqlcolumnToDouble (
      AjPSqlrow sqlr,
      double* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
double*PvalueOutputC-type double address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToFloat

Converts the value in the next column of an AJAX SQL Row into a C-type float value.

Prototype

AjBool ajSqlcolumnToFloat (
      AjPSqlrow sqlr,
      float* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
float*PvalueOutputC-type float address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToInt

Converts the value in the next column of an AJAX SQL Row into an AJAX Integer value.

Prototype

AjBool ajSqlcolumnToInt (
      AjPSqlrow sqlr,
      ajint* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
ajint*PvalueOutputAJAX Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToLong

Converts the value in the next column of an AJAX SQL Row into an AJAX Long Integer value.

Prototype

AjBool ajSqlcolumnToLong (
      AjPSqlrow sqlr,
      ajlong* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
ajlong*PvalueOutputAJAX Long Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToStr

Converts the value of the next column of an AJAX SQL Row into an AJAX String value.

Prototype

AjBool ajSqlcolumnToStr (
      AjPSqlrow sqlr,
      AjPStr* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
AjPStr*PvalueOutputAJAX String address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToTime

Converts the value in the next column of an AJAX SQL Row into an AJAX Time value.

Prototype

AjBool ajSqlcolumnToTime (
      AjPSqlrow sqlr,
      AjPTime* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
AjPTime*PvalueOutputAJAX Time address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToUint

Converts the value in the next column of an AJAX SQL Row into an AJAX Unsigned Integer value.

Prototype

AjBool ajSqlcolumnToUint (
      AjPSqlrow sqlr,
      ajuint* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
ajuint*PvalueOutputAJAX Unsigned Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnToUlong

Converts the value in the next column of an AJAX SQL Row into an AJAX Unsigned Long Integer value.

Prototype

AjBool ajSqlcolumnToUlong (
      AjPSqlrow sqlr,
      ajulong* Pvalue
);

TypeNameRead/WriteDescription
AjPSqlrowsqlrModifyAJAX SQL Row
ajulong*PvalueOutputAJAX Unsigned Long Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.3.0


AjPSqlrow: column retrieval

Functions:
ajSqlcolumnNumberGetValueGet the value of a particular column of an AJAX SQL Row.


Function ajSqlcolumnNumberGetValue

Get the value of a particular column of an AJAX SQL Row.

Prototype

AjBool ajSqlcolumnNumberGetValue (
      const AjPSqlrow sqlr,
      ajuint column,
      void** Pvalue,
      ajulong* Plength
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
void**PvalueModifyValue address
ajulong*PlengthModifyValue length address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


AjPSqlrow: column to datatype conversion functions

Functions for converting SQL Column values to other datatypes.

Functions:
ajSqlcolumnNumberToBoolConverts the value in a particular column of an AJAX SQL Row into an AJAX Boolean value.
ajSqlcolumnNumberToDoubleConverts the value in a particular column of an AJAX SQL Row into a C-type double value.
ajSqlcolumnNumberToFloatConverts the value in a particular column of an AJAX SQL Row into a C-type float value.
ajSqlcolumnNumberToIntConverts the value in a particular column of an AJAX SQL Row into an AJAX Integer value.
ajSqlcolumnNumberToLongConverts the value in a particular column of an AJAX SQL Row into an AJAX Long Integer value.
ajSqlcolumnNumberToStrConverts the value in a particular column of an AJAX SQL Row into an AJAX String value.
ajSqlcolumnNumberToTimeConverts the value in a particular column of an AJAX SQL Row into an AJAX Time value.
ajSqlcolumnNumberToUintConverts the value in a particular column of an AJAX SQL Row into an AJAX Unsigned Integer value.
ajSqlcolumnNumberToUlongConverts the value in a particular column of an AJAX SQL Row into an AJAX Unsigned Long Integer value.


Function ajSqlcolumnNumberToBool

Converts the value in a particular column of an AJAX SQL Row into an AJAX Boolean value.

Prototype

AjBool ajSqlcolumnNumberToBool (
      const AjPSqlrow sqlr,
      ajuint column,
      AjBool* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
AjBool*PvalueOutputAJAX Boolean address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToDouble

Converts the value in a particular column of an AJAX SQL Row into a C-type double value.

Prototype

AjBool ajSqlcolumnNumberToDouble (
      const AjPSqlrow sqlr,
      ajuint column,
      double* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
double*PvalueOutputC-type double address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToFloat

Converts the value in a particular column of an AJAX SQL Row into a C-type float value.

Prototype

AjBool ajSqlcolumnNumberToFloat (
      const AjPSqlrow sqlr,
      ajuint column,
      float* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
float*PvalueOutputC-type float address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToInt

Converts the value in a particular column of an AJAX SQL Row into an AJAX Integer value.

Prototype

AjBool ajSqlcolumnNumberToInt (
      const AjPSqlrow sqlr,
      ajuint column,
      ajint* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
ajint*PvalueOutputAJAX Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToLong

Converts the value in a particular column of an AJAX SQL Row into an AJAX Long Integer value.

Prototype

AjBool ajSqlcolumnNumberToLong (
      const AjPSqlrow sqlr,
      ajuint column,
      ajlong* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
ajlong*PvalueOutputAJAX Long Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToStr

Converts the value in a particular column of an AJAX SQL Row into an AJAX String value.

Prototype

AjBool ajSqlcolumnNumberToStr (
      const AjPSqlrow sqlr,
      ajuint column,
      AjPStr* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
AjPStr*PvalueOutputAJAX String address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToTime

Converts the value in a particular column of an AJAX SQL Row into an AJAX Time value.

Prototype

AjBool ajSqlcolumnNumberToTime (
      const AjPSqlrow sqlr,
      ajuint column,
      AjPTime* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
AjPTime*PvalueOutputAJAX Time address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToUint

Converts the value in a particular column of an AJAX SQL Row into an AJAX Unsigned Integer value.

Prototype

AjBool ajSqlcolumnNumberToUint (
      const AjPSqlrow sqlr,
      ajuint column,
      ajuint* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
ajuint*PvalueOutputAJAX Unsigned Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.2.0


Function ajSqlcolumnNumberToUlong

Converts the value in a particular column of an AJAX SQL Row into an AJAX Unsigned Long Integer value.

Prototype

AjBool ajSqlcolumnNumberToUlong (
      const AjPSqlrow sqlr,
      ajuint column,
      ajulong* Pvalue
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
ajulong*PvalueOutputAJAX Unsigned Long Integer address
AjBool RETURNajTrue upon success, ajFalse otherwise

From EMBOSS 6.3.0


AjPSqlrow: tests

Functions:
ajSqlcolumnNumberIsDefinedTest if the value in a particular column of an AJAX SQL Row is defined.


Function ajSqlcolumnNumberIsDefined

Test if the value in a particular column of an AJAX SQL Row is defined.

Prototype

AjBool ajSqlcolumnNumberIsDefined (
      const AjPSqlrow sqlr,
      ajuint column
);

TypeNameRead/WriteDescription
const AjPSqlrowsqlrInputAJAX SQL Row
ajuintcolumnInputColumn number
AjBool RETURNajTrue if the value is defined, ajFalse if the value is undefined (\N)

From EMBOSS 6.2.0


Datatype: AjPVoid

Functions for void pointer arrays

Sections:
constructorsConstructors
destructorsDestructors
CastCasts
modifiersModifiers


AjPVoid: constructors

Functions:
ajVoidNewDefault constructor for empty AJAX Void Pointer Arrays.
ajVoidNewResConstructor given an initial reserved size.


Function ajVoidNew

Default constructor for empty AJAX Void Pointer Arrays.

Prototype

AjPVoid ajVoidNew (
      void
);

TypeNameRead/WriteDescription
AjPVoid RETURNPointer to an empty Pointer Array structure

From EMBOSS 6.2.0


Function ajVoidNewRes

Constructor given an initial reserved size.

Prototype

AjPVoid ajVoidNewRes (
      ajuint size
);

TypeNameRead/WriteDescription
ajuintsizeInputReserved size
AjPVoid RETURNPointer to an empty Pointer Array struct of specified size

From EMBOSS 6.2.0


AjPVoid: destructors

Functions for destruction of void pointer arrays.

Functions:
ajVoidDelDefault destructor for AJAX Pointer arrays.


Function ajVoidDel

Default destructor for AJAX Pointer arrays.

Prototype

void ajVoidDel (
      AjPVoid* thys
);

TypeNameRead/WriteDescription
AjPVoid*thysDeletePointer to the Pointer Array to be deleted. The pointer is always deleted.
void RETURN

From EMBOSS 6.2.0


AjPVoid: Cast

Functions for returning elements of an AJAX SQL Connection object.

Functions:
ajVoidGetRetrieve an element from an AJAX Pointer Array.
ajVoidLenGet length of dynamic 1d AJAX Pointer Array.


Function ajVoidGet

Retrieve an element from an AJAX Pointer Array.

Prototype

void* ajVoidGet (
      const AjPVoid thys,
      ajuint elem
);

TypeNameRead/WriteDescription
const AjPVoidthysInputPointer to the Pointer array
ajuintelemInputarray element
void* RETURNcontents of array element

From EMBOSS 6.2.0


Function ajVoidLen

Get length of dynamic 1d AJAX Pointer Array.

Prototype

ajuint ajVoidLen (
      const AjPVoid thys
);

TypeNameRead/WriteDescription
const AjPVoidthysInputAJAX Pointer Array
ajuint RETURNlength

From EMBOSS 6.4.0


AjPVoid: modifiers

Functions:
ajVoidPutLoad a void pointer array element.


Function ajVoidPut

Load a void pointer array element.

Prototype

AjBool ajVoidPut (
      AjPVoid* thys,
      ajuint elem,
      void* v
);

TypeNameRead/WriteDescription
AjPVoid*thysOutputPointer to the void pointer array
ajuintelemInputarray element
void*vInputvalue to load
AjBool RETURNtrue if the array was extended

From EMBOSS 6.2.0