# class Error

###

Module | soprano
Namespace | Soprano::Error
Class | Error
Inherits |

\class Error error.h Soprano/Error/Error

Represents an error in %Soprano.

Author Sebastian Trueg <trueg@kde.org>

See also soprano_error_handling

### methods

- Error ( )

  returns ctor

  Create an Error object, representing success, i.e. no error.

- Error (message, code)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  message | QString |
  code | int | ErrorUnknown

  Create an Error object.

  message - A human-readable error message.

  code - An optional machine-readable error code. Can be one of Soprano.ErrorCode or a user defined value which has to be bigger than ErrorUnknown. The redland backend for example uses error codes ErrorUnknown + redlandCode.

- Error (a0)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  a0 | Soprano.Error.Error |

  Copy constructor

- Error (a0)

  returns ctor

  Argument | Type | Default
  --- | --- | ---
  a0 | ErrorData |

  \cond protected_error_members

- code ( )

  returns int

  An error code. If the error code is #ErrorNone the Error instance represents success. The code can either be one of the values of ErrorCode or a value above #ErrorUnknown.

  Example: The redland backend defines the error code as:

      ErrorUnknown + librdf_log_message_code()

  See also ErrorCode

- isParserError ( )

  returns bool

  Returns true if this Error instance represents a parser error. In that case the error can be converted to a ParserError.

- message ( )

  returns QString

  A string explaining the error in detail. This string is not necessarily translated (this depends on the plugin implementation).

  Returns An error message describing the error or an empty string for no-error (i.e. success) instances.

- operator bool ( )

  returns bool

  An %Error evalutes to a boolean, indicating if an %Error is "set".

  Returns false if code() == #ErrorNone, true otherwise.

  Thus, an Error object can easily be checked as follows:

      model.addStatement( s );
      if( model.lastError() ) {
      displayError( model.lastError() );
      }

- toParserError ( )

  returns Soprano.Error.ParserError

  Converts this error into a ParserError. This has the same effect as

      Error e;
      ParserError p1( e );

  Returns If isParserError() returns true a ParserError with a valid Locator value, otherwise a ParserError with an empty Locator.