MATLAB®

mexPrintf (C and Fortran) - ANSI^® C printf-style output routine

C Syntax

#include "mex.h"
int mexPrintf(const char *message, ...);

Fortran Syntax

integer*4 mexPrintf(message)
character*(*) message

Arguments

message

String to be displayed. In C, the string may include formatting conversion characters, such as those used with the ANSI C printf function.

...

In C, any additional arguments needed to translate formatting conversion characters used in message. Each conversion character in message is converted to one of these values.

Returns

The number of characters printed. This includes characters specified with backslash codes, such as \n and \b.

Description

This routine prints a string on the screen and in the diary (if the diary is in use). It provides a callback to the standard C printf routine already linked inside MATLAB^® software, and avoids linking the entire stdio library into your MEX-file.

In a C MEX-file, you must call mexPrintf instead of printf to display a string.

Note   If you want the literal % in your message, you must use %% in your message string since % has special meaning to mexPrintf. Failing to do so causes unpredictable results.

C Examples

See

• mexfunction.c in the mex subdirectory of the examples directory

• phonebook.c in the refbook subdirectory of the examples directory.

See Also

mexErrMsgIdAndTxt, mexErrMsgTxt, mexWarnMsgIdAndTxt, mexWarnMsgTxt

mexMakeMemoryPersistent (C and Fortran)

mexPutVariable (C and Fortran)