Struct postgres::error::DbError

pub struct DbError { /* private fields */ }

A Postgres error or notice.

Implementations

impl DbError

pub fn parse(fields: &mut ErrorFields<'_>) -> Result<DbError, Error>

Parses the error fields obtained from Postgres into a DBError.

pub fn severity(&self) -> &str

The field contents are ERROR, FATAL, or PANIC (in an error message), or WARNING, NOTICE, DEBUG, INFO, or LOG (in a notice message), or a localized translation of one of these.

pub fn parsed_severity(&self) -> Option<Severity>

A parsed, nonlocalized version of severity. (PostgreSQL 9.6+)

pub fn code(&self) -> &SqlState

The SQLSTATE code for the error.

pub fn message(&self) -> &str

The primary human-readable error message.

This should be accurate but terse (typically one line).

pub fn detail(&self) -> Option<&str>

An optional secondary error message carrying more detail about the problem.

Might run to multiple lines.

pub fn hint(&self) -> Option<&str>

An optional suggestion what to do about the problem.

This is intended to differ from detail in that it offers advice (potentially inappropriate) rather than hard facts. Might run to multiple lines.

pub fn position(&self) -> Option<&ErrorPosition>

An optional error cursor position into either the original query string or an internally generated query.

pub fn where_(&self) -> Option<&str>

An indication of the context in which the error occurred.

Presently this includes a call stack traceback of active procedural language functions and internally-generated queries. The trace is one entry per line, most recent first.

pub fn schema(&self) -> Option<&str>

If the error was associated with a specific database object, the name of the schema containing that object, if any. (PostgreSQL 9.3+)

pub fn table(&self) -> Option<&str>

If the error was associated with a specific table, the name of the table. (Refer to the schema name field for the name of the table’s schema.) (PostgreSQL 9.3+)

pub fn column(&self) -> Option<&str>

If the error was associated with a specific table column, the name of the column.

(Refer to the schema and table name fields to identify the table.) (PostgreSQL 9.3+)

pub fn datatype(&self) -> Option<&str>

If the error was associated with a specific data type, the name of the data type. (Refer to the schema name field for the name of the data type’s schema.) (PostgreSQL 9.3+)

pub fn constraint(&self) -> Option<&str>

If the error was associated with a specific constraint, the name of the constraint.

Refer to fields listed above for the associated table or domain. (For this purpose, indexes are treated as constraints, even if they weren’t created with constraint syntax.) (PostgreSQL 9.3+)

pub fn file(&self) -> Option<&str>

The file name of the source-code location where the error was reported.

pub fn line(&self) -> Option<u32>

The line number of the source-code location where the error was reported.

pub fn routine(&self) -> Option<&str>

The name of the source-code routine reporting the error.

Trait Implementations

impl Clone for DbError

fn clone(&self) -> DbError

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for DbError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for DbError

fn fmt(&self, fmt: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for DbError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for DbError

fn eq(&self, other: &DbError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DbError

impl StructuralPartialEq for DbError