mexPrintf (C および Fortran)

ANSI C PRINTF スタイル出力ルーチン

C 構文

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

Fortran 構文

#include "fintrf.h"
integer*4 mexPrintf(message)
character*(*) message

説明

このルーチンは、画面とダイアリ (ダイアリを使用している場合) に文字列を出力します。MATLAB^® ソフトウェア内に既にリンクされている標準 C printf ルーチンへのコールバックを提供します。これにより、stdio ライブラリ全体が MEX ファイルにリンクされるのを防ぐことができます。

C MEX ファイルでは、文字列を表示する場合、printf の代わりに mexPrintf を呼び出します。

メモ

メッセージ内にリテラルの % が必要な場合は、メッセージ文字列で %% を使用します。% には printf に対して特別な意味があるためです。これを行わないと、予期しない結果が生じます。

入力引数

message — 表示する文字列

const char* | character*(*)

表示する文字列。C では const char*、Fortran では character*(*) として指定します。C において、この関数は UTF-8 またはローカル コード ページ (LCP) のエンコードをサポートし、ANSI^® C の関数 printf で使用される変換仕様を文字列に含めることができます。メッセージ テキストと変換引数の両方のエンコードは同じでなければなりません。

... — 変換引数

const char*

C では、メッセージ内で使用される任意の引数。各引数には対応する変換指示子がなければなりません。printf の変換表については、C のドキュメンテーションを参照してください。

出力引数

res — 文字数

int | integer*4

出力される文字の数 (\n や \b など、バックスラッシュ コードと共に指定された文字を含む)。C では int、Fortran では integer*4 として返されます。

例

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","mex","filename")]);

ここで filename は、次のようになります。

• mexfunction.c

例を開くには、次のように入力します。

edit([fullfile(matlabroot,"extern","examples","refbook","filename")]);

ここで filename は、次のようになります。

• phonebook.c

バージョン履歴

R2020b: UTF-8 のサポートの追加

関数 mexPrintf は、下位互換性のために LCP でエンコードされた文字列のサポートに加えて、UTF-8 でエンコードされたデータも受け入れます。

参考

sprintf | mexErrMsgIdAndTxt | mexWarnMsgIdAndTxt