c_list_drivers.c

Go to the documentation of this file.

/*!
 * \file db/dbmi_client/c_list_drivers.c
 * 
 * \brief DBMI Library (client) - list drivers
 *
 * (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>

/*!
  \brief Return comma separated list of existing DB drivers, used for driver parameter options

  \return list of db drivers
 */
const char *db_list_drivers(void)
{
    dbDbmscap *list, *cur;
    dbString drivernames;

    db_init_string(&drivernames);

    /* read the dbmscap info */
    if (NULL == (list = db_read_dbmscap()))
        return NULL;
    else {
        /* build the comma separated string of existing drivers */
        for (cur = list; cur; cur = cur->next) {
            if (cur->driverName[0] == '\0')
                break;
            else {
                if (cur != list)
                    db_append_string(&drivernames, ",");
                db_append_string(&drivernames, cur->driverName);
            }
        }
    }

    return db_get_string(&drivernames);
}