ErrorMessage

Generates an error message.

Syntax

Fortran:

error_message = DftiErrorMessage( status )

C:

error_message = DftiErrorMessage(status);

Include Files

The Fortran interface is specified in the mkl_dfti.f90 include file and the C interface is specified in the mkl_dfti.h include file.

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. The actual error message is implementation dependent. 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

Copyright © 1994 - 2011, Intel Corporation. All rights reserved.