nn::nex::SystemError Class

Syntax

class SystemError : public nn::nex::RootObject

Description

Primarily handles the NEX library errors.

NEX API designed to get the error content by explicitly calling the GetLast function after calling an NEX API are normally divided into three types. The three types are functions with Boolean return values, functions that have pointers for return values, and the IsValid function.

The IsValid function is used to confirm that a constructor that is directly called by the user and that could fail has successfully instantiated the relevant class.

When an error occurs, the IsValid function and the Boolean functions return false, or 0, and the pointer functions return a NULL pointer.

If an error occurs while one of these types of NEX APIs is being called, that error information is stored in the SystemError class. The GetLast function returns the most recently stored error.

If an error, such as a system error, occurs outside of NEX, the GetLastExt function returns the system error code of the error that most recently occurred.

The ClearLast function deletes the stored error. By calling the ClearLast function before calling the NEX API, you can guarantee that the returned error was generated with the NEX API that was called last.

In addition, the GetErrorString function can be used to get a string representation of the error.

Member Functions

S GetErrorString Gets text string representation of errors.
S ClearLast Deletes errors stored in the SystemError class.
S GetLast Gets the error generated when the NEX API is called.
S GetLastExt Gets the system error generated by a call of a NEX API function.
S EraseErrorElements Erases error information corresponding to the thread that calls this API from the SystemError class.

Class Hierarchy

nn::nex::RootObject
  nn::nex::SystemError

Revision History

2011/01/27
Initial version.

CONFIDENTIAL