このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。
sprintf
データの文字列または文字ベクトルへの書式設定
構文
説明
str= sprintf (formatSpec，A1,…,一个）formatSpecで指定された書式演算子を使用して,配列A1,…,一个のデータを書式設定し,結果のテキストをstrに返します。関数sprintfはA1,…,一个の値を列の順序で書式設定します。formatSpecが字符串の場合,出的力strも字符串となります。それ以外の場合,strは文字ベクトルです。
書式設定された複数のテキストを字符串配列または文字ベクトルの细胞配列として返すには,関数组成を使用します。
演算に失敗した場合,［はエラーメッセージを文字ベクトルとして返します。それ以外の場合,str，errmsg) = sprintf (formatSpec，A1,…,一个）errmsgは空です。
str= sprintf (literalText）literalText内の\ nや\ tなどのエスケープ文字シーケンスを変換します。その他すべての文字を変更せずに返します。literalTextに書式演算子(% fなど)が含まれる場合,strはそれ以降のすべての文字を破棄します。
例
入力引数
出力フィールドの書式。書式演算子を使用して指定します。formatSpecには通常のテキストおよび特殊文字を含めることもできます。
formatSpecに\ nなどのエスケープ文字を表すリテラルテキストが含まれる場合,sprintfはエスケープ文字を変換します。
formatSpecには,一重引用符で囲まれた文字ベクトルか,R2016b以降では字符串スカラーを指定できます。
書式演算子
書式演算子はパーセント記号% gydF4y2Baで始まり,変換文字で終わります。変換文字は必須です。オプションとして,% gydF4y2Baと変換文字の間に識別子,フラグ,フィールド幅,精度およびサブタイプ演算子を指定できます(ここでは読みやすいようにスペースが表示されていますが,実際には演算子の間にスペースは使用できません)。
変換文字
次の表では,数値データおよび文字データをテキストとして書式設定するための変換文字を説明します。
| 値のタイプ | 変換 | 詳細 |
|---|---|---|
整数,符号付き |
|
基数 10 |
整数,符号なし |
|
基数 10 |
|
基数 8 (8 進法) |
|
|
基数 16 (16 進法)、小文字 |
|
|
|
|
浮動小数点数 |
|
固定小数点表記(小数点以下の桁数の指定には精度演算子を使用) |
|
|
|
|
|
|
|
|
|
|
|
|
文字または文字列 |
|
単一の文字 |
|
文字ベクトルまたは字符串配列。出力テキストのタイプは |
オプションの演算子
オプションの識別子,フラグ,フィールド幅,精度およびサブタイプ演算子は,出力テキストの書式をさらに細かく定義します。
識別子
関数の入力引数の処理順序。構文
n＄nは関数呼び出し内の他の入力引数の位置を表します。例:
('%3$s %2$s %1$s %2$s'，'A'，'B'，'C')は入力引数“一个”、“B”、“C”をC b a bとして出力します。メモ:入力引数が配列の場合,識別子を使用してその入力引数の特定の配列要素を指定することはできません。
フラグ
“- - -”左揃えします。
例:% -5.2度
例:% -10年代“+”常に数値の符号文字(+または)を出力します。
例:% + 5.2 f
テキストを右揃えします。
例:% + 10 s' '値の前にスペースを1つ挿入します。
例:% 5.2度' 0 '値の前にゼロを入れてフィールド幅をパディングします。
例:% 05.2度'＃'選択した数値変換を次のように変更します。
%啊、% x,または% Xの場合は,接頭辞0、0 x,または0 xを出力します。% f、% e,または% Eの場合は,精度が0であっても小数点を出力します。% gまたは% Gの場合は,後続のゼロまたは小数点を削除しないでください。
例:
% # 5.0度フィールド幅
出力する最小文字数。フィールド幅演算子は、数字、あるいは入力引数を参照するアスタリスク (
＊)にすることができます。フィールド幅演算子として
＊を指定する場合,他の入力引数は出力される幅と値の両方を提供しなければなりません。幅と値は引数のペア,または数値配列内のペアにすることができます。フィールド幅演算子として＊を使用すると,さまざまな値をさまざまな幅で出力できます。例:入力引数
(intmax ' % 12 d ')は(' % * d ', 12日intmax)と等価です。例:入力引数
('%*d'，[2 10 5 100])は“100”を返します。このとき,10には2つのスペース,One hundred.には5つのスペースが割り当てられます。あるいは,フィールドの幅と値を(' % * d ', 2, 10, 5100)のように複数の引数として指定することもできます。フラグで特に指定されていない限り,この関数は値の前にスペースを追加してフィールド幅までパディングします。
精度
% f、% eまたは% E小数点以下の桁数
例:“% .4f”はπを“3.1416”と出力します% gまたは% G有効桁数
例:“% .4g”はπを“3.142”と出力します。精度演算子は,数字,あるいは引数を参照するアスタリスク(
＊)にすることができます。フィールド精度演算子として
＊を指定する場合,他の入力引数は出力される精度と値の両方を提供しなければなりません。精度と値は引数のペア,または数値配列内のペアにすることができます。精度演算子として＊を使用すると,さまざまな値をさまざまな精度で出力できます。フィールド幅と精度演算子として
* . *を指定する場合,フィールド幅,精度,値を3成分として指定しなければなりません。例:入力引数
(' % .4f ',π)は(' %。* f ' 4π)と等価です。例:入力引数
(% 6.4 f,π)は(' %。* f ' 6 4π)と等価です。例:入力引数
(' % *。* f ', 6日4π,9日,6日,exp (1))は,3.1416 - 2.718282的を返します。ここで,9および6は实验(1)の出力のフィールド幅と精度です。メモ
浮動小数点値の精度演算子を入力の数値データ型の精度より大きい値に指定すると,入力値の精度が指定の精度にならない場合があります。結果はコンピューターのハードウェアとオペレーティングシステムによって異なります。
サブタイプ
サブタイプ演算子を使用して,浮動小数点値を8進数,10進数または16進数の値として出力できます。サブタイプ演算子は,変換文字の直前に指定します。次の表では,サブタイプを使用できる変換を示します。
入力値の型
サブタイプと変換文字
出力値の型
浮動小数点数
% bxまたは% bX%博% bu16進数8進数または10進数の倍精度値
例:% bxはπを400921 fb54442d18と出力します% txまたは% tX%,%你16進数8進数または10進数の単精度値
例:% txはπを40490身上と出力します
書式演算子の前後のテキスト
formatSpecでは,パーセント記号% gydF4y2Baの前や,変換文字の後に追加のテキストを含めることができます。次のテキストを追加できます。
出力する通常のテキスト。
通常のテキストとして入力できない特殊文字。次の表では,
formatSpecで特殊文字を表す方法を説明します。特殊文字
表現
一重引用符
＇＇パーセント文字
％％バックスラッシュ
＼＼アラーム
、一个バックスペース
\ bフォームフィード
\ f改行
\ nキャリッジリターン
r \水平タブ
\ t垂直タブ
v \Unicode®数値を16進数
Nで表現できる文字\ xN例:
sprintf(“\ x5A”)は“Z”を返します。Unicode数値を8進数
Nで表現できる文字\ N例:
sprintf (\ 132 ')は“Z”を返します。
書式演算子を使用した変換動作の注意点
数値変換は複素数の実数部のみを出力します。
数値のテキスト変換など,データに適さない変換を指定すると,MATLAB®は指定した変換をオーバーライドし,
% eを使用します。例:
' % s 'は,πを3.141593 e + 00に変換します。整数値にテキスト変換(
% cまたは% s)を適用する場合,MATLABは有効な文字コードに対応する値を文字に変換します。例:
' % s 'は,(65 66 67)を美国广播公司に変換します。
A1,…,一个- - - - - -数値,文字または字符串配列
配列
数値,文字または字符串配列。
データ型:单|双|int8|int16|int32|int64|uint8|uint16|uint32|uint64|逻辑|字符|字符串
literalText- - - - - -書式演算子なしの入力テキスト
文字ベクトル|字符串スカラー
書式演算子なしの入力テキスト。文字ベクトルまたは字符串スカラーとして指定します。sprintfはliteralText内のエスケープ文字シーケンスをすべて変換します。
データ型:字符|字符串
出力引数
ヒント
関数
sprintfは流と似ていますが,流の場合はファイルに出力したりあるいはコマンドウィンドウに表示したりします。関数
sscanfおよびfscanfの読み取りに対する書式指定子は,関数sprintfおよび流の書き込み用の形式とは異なります。読み取り関数は精度フィールドをサポートしません。幅フィールドは,書き込み用には最小値を,読み取り用には最大値を指定します。無効な書式演算子または特殊文字を指定すると,
sprintfはその無効な演算子または文字までのすべてのテキストを出力し,残りを破棄します。例:
formatSpecが“价值= % z 'の場合,% zは書式演算子ではないため,sprintfは“价值= 'を出力します。例:
formatSpecが'字符\x99999 = %s'の場合,\ x99999は有効な特殊文字ではないため,sprintfは“性格”を出力します。
参照
[1] Kernighan, B. W.， D. M. Ritchie, C程序设计语言，第二版，Prentice-Hall, Inc.， 1988。
[2] ANSI specification X3.159-1989:“Programming Language C，”ANSI, 1430 Broadway, New York, NY 10018。
拡張機能
你也可以从以下列表中选择一个网站:
