tdbc::mapSqlState manual page - Tcl Database Connectivity

## Tcl8.6.4 Documentation > TDBC Package Commands, version 1.0.3 > tdbc_mapSqlState

### Tcl Applications | Tcl Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | [incr Tcl] Package C API | TDBC Package C API

### NAME

tdbc::mapSqlState — Map SQLSTATE to error class

### SYNOPSIS

package require tdbc 1.0
tdbc::mapSqlState sqlstate

### DESCRIPTION

The tdbc::mapSqlState command accepts a string that is expected to be a five-character 'SQL state' as returned from a SQL database when an error occurs. It examines the first two characters of the string, and returns an error class as a human- and machine-readable name (for example, FEATURE_NOT_SUPPORTED, DATA_EXCEPTION or INVALID_CURSOR_STATE).

The TDBC specification requires database drivers to return a description of an error in the error code when an error occurs. The description is a string that has at least four elements: "TDBC errorClass sqlstate driverName details...". The tdbc::mapSqlState command gives a convenient way for a TDBC driver to generate the errorClass element given the SQL state returned from a database.

### SEE ALSO

tdbc, tdbc::tokenize, tdbc::connection, tdbc::statement, tdbc::resultset

### KEYWORDS

TDBC, SQL, database, state

### COPYRIGHT

Copyright (c) 2009 by Kevin B. Kenny.
Copyright © 2009 by Kevin B. Kenny.