MySQL 5.7 C API Developer Guide
MYSQL_RES *
mysql_list_dbs(MYSQL *mysql,
               const char *wild)
          Returns a result set consisting of database names on the
          server that match the simple regular expression specified by
          the wild parameter. wild
          may contain the wildcard characters % or
          _, or may be a NULL
          pointer to match all databases. Calling
          mysql_list_dbs() is similar to
          executing the query SHOW DATABASES [LIKE
          .
        wild]
          You must free the result set with
          mysql_free_result().
        
Commands were executed in an improper order.
Out of memory.
The MySQL server has gone away.
The connection to the server was lost during the query.
An unknown error occurred.