RDO CONNECT()

Purpose

Connect to a data source

Syntax

RDO_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