dbQueryFetchAllM#

Purpose#

Returns the result set for the current query as a matrix.

Format#

result = dbQueryFetchAllM(qid[, columns])#
Parameters:
  • qid (scalar) – query number.

  • columns (string or string array) – Optional input. Gives specific columns to pull out from result matrix. Must be a subset of fields from SELECT statement.

Returns:

result (matrix) – the result set; or if the result set is empty, a scalar error code.

Examples#

Example 1#

// Execute query
qid = dbExecQuery(db_id, "SELECT * FROM GDP");

// Return results as a matrix
gdp = dbQueryFetchAllM(qid);

// If 'gdp' is a scalar error code
if scalmiss(gdp);
     print "No results";
else;
     // do something with gdp
endif;

Example 2#

// Execute query
qid = dbExecQuery(db_id, "SELECT * FROM
     PEOPLE WHERE COUNTRY = ?", "USA");

/*
** Get results as a matrix using
** zipcode as column of interest
*/
zipcodes = dbQueryFetchAllM(qid, "ZIPCODE");

if not scalmiss(zipcodes);
    print "zip codes = " zipcodes;
endif;

Remarks#

For string results, or to treat numerical results as strings, use dbQueryFetchAllSA() to return a string array.

This function retrieves all rows at once. You can process rows in an iterative manner by using the dbQueryFetchOneM() and dbQueryFetchOneSA() functions.