DC_ERROR_MSG Function

Returns the text string associated with the negative status code generated by a "DC" data import/export function that does not complete successfully.

msg_str = DC_ERROR_MSG(status)

status The error message number returned by any of the "DC" functions. Must be integer.

msg_str The test string that corresponds to the value of status. Returns a string; the string is an empty (null) string if status is greater than or equal to 0 (zero).

None.

When status has a value less than 0 (zero), it indicates a "DC" function error condition, such as an invalid filename, or an unexpected end-of-file.

Because the error message number status includes both the error number and an ID number that corresponds to the "DC" function that produced the error, both the function name and the specific error are described in the message string returned by DC_ERROR_MSG.

The following statements read a file containing 8-bit image data. Depending on the status returned by DC_READ_8_BIT, either an error message is written or the image is displayed in a window the exact size of the image:

status = DC_READ_8_BIT('mongo.img', mongo, XSize=xs, YSize=ys)

; Use DC_READ_8_BIT to read the image file.

IF (status LT 0) THEN BEGIN

msg_str = DC_ERROR_MSG(status)

; Obtain the error message if status has a negative value.

PRINT, msg_str

; Print the error message.

ENDIF ELSE BEGIN

WINDOW, XSize=xs, YSize=ys

; Define a window the right size to hold the image.

TVSCL, mongo

; Display the image inside the window.

ENDELSE

DC_OPTIONS