Difference between revisions of "RDO CONNECT()"

From Recital Documentation Wiki
Jump to: navigation, search
 
(2 intermediate revisions by one user not shown)
Line 5: Line 5:
 
==Syntax==
 
==Syntax==
 
RDO_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])
 
RDO_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])
 +
 +
MYSQL_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])
  
  
Line 13: Line 15:
 
==Description==
 
==Description==
 
The RDO_CONNECT() function is used to connect to a data source.  The numeric value returned should be saved to a variable to be used by other functions to reference the connection.  Connection references start from 0 and correspond to the [[SELECT()|cursor/workarea]] -1.  If RDO_CONNECT() returns -1, the connection failed.
 
The RDO_CONNECT() function is used to connect to a data source.  The numeric value returned should be saved to a variable to be used by other functions to reference the connection.  Connection references start from 0 and correspond to the [[SELECT()|cursor/workarea]] -1.  If RDO_CONNECT() returns -1, the connection failed.
 +
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 40: Line 43:
 
endif
 
endif
 
</code>
 
</code>
 +
  
 
==Products==
 
==Products==
Line 46: Line 50:
 
[[Category:Functions]]
 
[[Category:Functions]]
 
[[Category:SQL]]
 
[[Category:SQL]]
 +
[[Category:Remote Data Connectivity]]
 
[[Category:Remote Data Connectivity Functions]]
 
[[Category:Remote Data Connectivity Functions]]

Latest revision as of 11:57, 22 June 2010

Purpose

Connect to a data source


Syntax

RDO_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])

MYSQL_CONNECT(<expC1>, <expC2>, <expC3>, <expC4> [, <expC5>])


See Also

RDO_AFFECTED_ROWS(), RDO_CLOSE(), RDO_DATA_SEEK(), RDO_ERRNO(), RDO_ERROR(), RDO_EXEC(), RDO_FETCH_ARRAY(), RDO_FETCH_ASSOC(), RDO_FETCH_FIELD(), RDO_FETCH_LENGTHS(), RDO_FETCH_OBJECT(), RDO_FETCH_ROW(), RDO_FIELD_FLAGS(), RDO_FIELD_LEN(), RDO_FIELD_NAME(), RDO_FIELD_SEEK(), RDO_FIELD_TABLE(), RDO_FIELD_TYPE(), RDO_FREE_OBJECT(), RDO_FREE_RESULT(), RDO_GET_CLIENT_INFO(), RDO_GET_HOST_INFO(), RDO_INFO(), RDO_LIST_DBS(), RDO_NUM_FIELDS(), RDO_NUM_ROWS(), RDO_PING(), RDO_QUERY(), RDO_REAL_ESCAPE_STRING(), RDO_RESULT(), RDO_SELECT_DB(), RDO_STAT(), RDO_THREAD_ID(), RDO_UNBUFFERED_QUERY()


Description

The RDO_CONNECT() function is used to connect to a data source. The numeric value returned should be saved to a variable to be used by other functions to reference the connection. Connection references start from 0 and correspond to the cursor/workarea -1. If RDO_CONNECT() returns -1, the connection failed.


Keywords Description
<expC1> Servertype: "recital", "oracle", "db2", "mysql" or "postgres"
<expC2> Hostname: IP address or character name
<expC3> Username: account used to access the data source
<expC4> Password: password for account above
<expC5> Database: database to connect to


Example

conn = rdo_connect("mysql","localhost", "user", "pass", "test")
if conn > -1
    rdo_exec("create table mytable (phrase char(20))", conn)
    rdo_exec("insert into mytable values ('Hello world')")
    echo rdo_affected_rows()
    rdo_close(conn)
endif


Products

Recital, Recital Server