GetOptions - Maple Help
For the best experience, we recommend viewing online help using Google Chrome or Microsoft Edge.
Our website is currently undergoing maintenance, which may result in occasional errors while browsing. We apologize for any inconvenience this may cause and are working swiftly to restore full functionality. Thank you for your patience.

Online Help

All Products    Maple    MapleSim


PreparedStatement

  

GetOptions

  

get options of a PreparedStatement module

 

Calling Sequence

Parameters

Description

Examples

Calling Sequence

preparedstat:-GetOptions( opts )

Parameters

preparedstat

-

PreparedStatement module

opts

-

(optional) name; the option to get, one of timeout, maxrows, or maxfieldsize

Description

• 

GetOptions gets the values of options that affect the behavior of preparedstat.

• 

All the options that can be read with GetOptions can be set by calls to SetOptions or when the PreparedStatement is created by CreateStatement.

• 

An option's current value can be set by calling SetOptions.

• 

GetOptions recognizes the following options

  

timeout

  

the number of seconds preparedstat waits for a query to execute.  If the limit is exceeded, an error is raised.

  

maxrows

  

the maximum number of rows a query returns. If there are more than maxrows rows in the database that match the query, the extra rows are dropped.

  

maxfieldsize

  

the maximum number of bytes a field of type BINARY, VARBINARY, LONGVARBINARY, CHAR, VARCHAR, or LONGVARCHAR will use.  If a field needs more than this, it is truncated.

• 

Calling GetOptions with no arguments returns the current values of all the arguments that GetOptions can query.

Examples

driverDatabaseLoadDriver:

conndriver:-OpenConnectionurl,name,pass:pstatconn:-CreateStatement:pstat:-GetOptions

timeout=0,maxrows=0,maxfieldsize=8192

(1)

pstat:-SetOptionstimeout=10;pstat:-GetOptions

timeout=10,maxrows=0,maxfieldsize=8192

(2)

pstat:-SetOptionsmaxrows=20;pstat:-GetOptionstimeout,maxrows

timeout=10,maxrows=20

(3)

pstat:-SetOptionsmaxfieldsize=1000;pstat:-GetOptionstimeout,maxrows,maxfieldsize

timeout=10,maxrows=20,maxfieldsize=1000

(4)

See Also

Database

Database[Connection]

Database[Connection][CreateStatement]

Database[PreparedStatement]

Database[PreparedStatement][SetOptions]

Database[usage]