DftiErrorMessage

Generates an error message.

Syntax

FORTRAN:

error_message = DftiErrorMessage( status )

C:

error_message = DftiErrorMessage(status);

Include Files

Input Parameters

Name

Type

Description

status

FORTRAN: INTEGER

C: MKL_LONG

Completion status of a function.

Output Parameters

Name

Type

Description

error_message

FORTRAN: CHARACTER(LEN=DFTI_MAX_MESSAGE_LENGTH)

C: Array of char

The character string with the error message.

Description

The error message function generates an error message character string. In Fortran, use a character string of length DFTI_MAX_MESSAGE_LENGTH as a target for the error message. In C, the function returns a pointer to a constant character string, that is, a character array with terminating '\0' character, and you do not need to free this pointer.

Example "Using Status Checking Function" shows how this function can be used.

Interface and Prototype

 
//Fortran interface
INTERFACE DftiErrorMessage
//Note that the body provided here is to illustrate the different
//argument list and types of dummy arguments. The interface
//does not guarantee what the actual function names are.
//Users can only rely on the function name following the
//keyword INTERFACE
 FUNCTION some_actual_function_9( Status )
 CHARACTER(LEN=DFTI_MAX_MESSAGE_LENGTH) some_actual_function_9( Status )
 INTEGER, INTENT(IN) :: Status
 END FUNCTION some_actual_function_9
END INTERFACE DftiErrorMessage 
 
/* C prototype */
char *DftiErrorMessage( MKL_LONG );
 

Submit feedback on this help topic