Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Fetches the first row from a result set.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
SQL 2.6 Yes Yes Yes Yes Yes
MBS( "SQL.FetchFirst"; Command )   More


Parameter Description Example value
Command The command reference number gained with SQL.NewCommand. $Command


Returns 0, 1 or error message.


Fetches the first row from a result set.

Use SQL.FetchPrior, SQL.FetchFirst, SQL.FetchLast method to fetch rows from the scrollable result set. The scrollable result set option should be set before Command executed (SQLite and InterBase don't support this feature). See server specific notes to discover how SQLAPI supports the scrollable result set for certain DBMS.

To check whether a result set exists use SQL.isResultSet method.
Scrolling only works if enabled, so please call SQL.SetCommandOption function to enable it if needed.
Result is 1 on success or 0 on failure.


Fetch first record:

MBS("SQL.FetchFirst"; $Command)

Requests a scrollable record set:

MBS( "SQL.SetCommandOption"; $Command; "Scrollable"; "True" )

See also

Created 18th August 2014, last changed 24th April 2016

SQL.Execute   -   SQL.FetchLast

Feedback: Report problem or ask question.

MBS Xojo Plugins