c_rows.c

/*!
 * \file db/dbmi_client/c_rows.c
 * 
 * \brief DBMI Library (client) - get number of records
 *
 * (C) 1999-2008 by the GRASS Development Team
 *
 * This program is free software under the GNU General Public
 * License (>=v2). Read the file COPYING that comes with GRASS
 * for details.
 *
 * \author Joel Jones (CERL/UIUC), Radim Blazek
 */

#include <grass/dbmi.h>
#include "macros.h"

/*!
  \brief Get number of selected rows

  \param cursor db select cursor

  \return DB_OK on success
  \return DB_FAILED on failure
 */
int db_get_num_rows(dbCursor * cursor)
{
    int nrows, ret_code;

    /* start the procedure call */
    db__set_protocol_fds(cursor->driver->send, cursor->driver->recv);
    DB_START_PROCEDURE_CALL(DB_PROC_ROWS);

    /* send the argument(s) to the procedure */
    DB_SEND_TOKEN(&cursor->token);

    /* get the return code for the procedure call */
    DB_RECV_RETURN_CODE(&ret_code);

    if (ret_code != DB_OK)
	return -1;

    /* get the results */
    DB_RECV_INT(&nrows);

    return nrows;
}