Compose String

指定された形式および入力信号に基づく出力 string 信号の構成

• 

×

ライブラリ:
Simulink / String

説明

Compose String ブロックは、[書式設定] パラメーターにリストされる書式指定子に基づいて出力 string 信号を構成します。[書式設定] パラメーターは入力信号の数を決定します。複数の入力がある場合、ブロックはこれらの複数の入力を順番に結合して、関連付けられている書式指定子を各入力につき 1 つ適用することで文字列を構成します。各書式指定子はパーセント記号 % で始まり、その後に変換文字が続きます。たとえば %f は、入力の形式を浮動小数点出力として設定します。string 出力の補足として、文字を書式仕様に加えることもできます。このブロックを使用して、複数の入力から出力 string 信号を構成して形式を設定できます。

たとえば、[書式設定] パラメーターに "%s is %f" が含まれる場合、ブロックは string 信号および single または double の信号の 2 つの入力を期待します。最初の入力が string "Pi" で、2 番目の入力が double 値 3.14 である場合、出力は "Pi is 3.14" です。

ブロックから生成されたコードを MinGW^® コンパイラでコンパイルすると、コンパイルされたコードを実行した際に、浮動小数点入力について、標準とは異なる結果になることがあります。たとえば、数値入力の 501.987 に対して、想定される string "5.019870e+02" ではなく、string "5.019870e+002" が返されます。

端子

入力

d — 文字列の最初の部分のデータ

スカラー

文字列の最初の部分のデータ。スカラーとして指定します。[書式設定] パラメーターは、端子ラベルおよび入力データの形式を決定します。たとえば、[書式設定] パラメーターの最初の項目が %d である場合、端子ラベルは d です。

入力信号のデータ型は、[書式設定] パラメーターの書式指定子と互換性がなければなりません。詳細については、[書式設定] パラメーターを参照してください。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean

f — 文字列の 2 番目の部分のデータ

スカラー

文字列の 2 番目の部分のデータ。スカラーとして指定します。[書式設定] パラメーターは、端子ラベルおよび入力データの形式を決定します。たとえば、[書式設定] パラメーターの最初の項目が %f である場合、端子ラベルは f です。

入力信号のデータ型は、[書式設定] パラメーターで指定された書式指定子と互換性がなければなりません。詳細については、[書式設定] パラメーターを参照してください。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus

Port_N — 文字列の N 部分のデータ

スカラー (既定値)

文字列の N 部分のデータ。スカラーとして指定します。[書式設定] パラメーターは、端子ラベルおよび入力データの形式を決定します。たとえば、[書式設定] パラメーターの対応する項目が %f である場合、端子ラベルは f です。

入力信号のデータ型は、[書式設定] パラメーターの書式指定子と互換性がなければなりません。詳細については、[書式設定] パラメーターを参照してください。

データ型: single | double | int8 | int16 | int32 | uint8 | uint16 | uint32 | Boolean | fixed point | enumerated | bus

出力

str — 出力 string

スカラー

入力から構成される出力 string。スカラーとして指定します。

データ型: string

パラメーター

形式 — 入力データの書式設定

"%d %f" (既定値) | 書式文字列 | 文字ベクトル

入力データの書式設定。書式文字列として指定します。

入力可能な書式指定子の詳細については、アルゴリズムを参照してください。

プログラムでの使用

ブロック パラメーター: Format

型: 文字ベクトル

値: '<filename>'

既定の設定: '"%d %f"'

出力データ型 — 出力データ型

string (既定値) | <data type expression>

出力データ型。最大長のない文字列を指定するために string データ型を使用して指定します。

最大長をもつ string データ型を指定するには、stringtype(N) を指定します。たとえば、stringtype(31) は、最大長が 31 文字の string データ型を作成します。

[データ型アシスタントを表示] ボタン をクリックして、データ型の属性の設定に役立つ [データ型アシスタント] を表示します。詳細は、データ型アシスタントを利用したデータ型の指定を参照してください。

プログラムでの使用

ブロック パラメーター: OutDataTypeStr

型: 文字ベクトル

値: 'string' | <data type expression>

既定の設定: 'string'

モード — データのカテゴリ

string (既定値) | scalar

関数 stringtype を、たとえば stringtype(255) のように使用します。

依存関係

[データ型アシスタントを表示] ボタンをクリックすると、このパラメーターが有効になります。

ブロックの特性

データ型	double | integer | single | string
直達	はい
多次元信号	いいえ
可変サイズの信号	いいえ
ゼロクロッシング検出	いいえ

アルゴリズム

書式指定子はパーセント記号 % で始まり、変換文字で終わります。変換文字は必須です。オプションで、% と変換文字の間に識別子、フラグ、フィールド幅、精度およびサブタイプ指定子を指定できます (指定子間のスペースは無効です。ここでは可読性を高めるためだけに表示されています)。

Compose String ブロックは、以下の書式指定子プロトタイプを使用します。

%[flags][width][.precision][length]specifier

変換文字

以下の表は、数値データおよび文字データをテキストとして書式設定する変換文字を示しています。

値のタイプ	変換	詳細
整数、符号付き	%d または %i	基数 10
整数、符号なし	%u	基数 10
	%o	基数 8 (8 進法)
	%x	基数 16 (16 進法)、小文字の a ～ f
	%X	%x と同じ。大文字の A ～ F
浮動小数点数	%f	浮動小数点表記 (小数点以下の桁数の指定には精度演算子を使用)
	%e	3.141593e+00 などの指数表現 (小数点以下の桁数の指定には精度演算子を使用)
	%E	%e と同じであるが、3.141593E+00 などの大文字 (小数点以下の桁数の指定には精度演算子を使用)
	%g	%e または %f をコンパクトにしたもので、後続のゼロなし (有効桁数の指定には精度演算子を使用)
	%G	%E または %f をコンパクトにしたもので、後続のゼロなし (有効桁数の指定には精度演算子を使用)
String	%s	出力テキストのタイプは [書式設定] のタイプと同じ

オプションの演算子

オプションの指定子、フラグ、フィールド幅、精度および演算子は出力テキストの形式をさらに規定しています。

• フラグ

  '–'	左揃えします。すべての指定子で機能します。 例: %-5.2f 例: %-10s
  '+'	常に数値の符号文字 (+ または –) を出力します。u、o、x、X および s を除くすべての指定子で機能します。 例: %+5.2f テキストを右揃えします。 例: %+10s
  ' '	値の前にスペースを 1 つ挿入します。u、o、x、X および s を除くすべての指定子で機能します。 例: % 5.2f
  '0'	値の前にゼロを入れてフィールド幅をパディングします。s を除くすべての指定子で機能します。 例: %05.2f
  '#'	選択した数値変換を次のように変更します。 %o、%x、または %X の場合は、接頭辞 0、0x、または 0X を出力します。 %f、%e、または %E の場合は、精度が 0 であっても小数点を出力します。 %g または %G の場合は、後続のゼロまたは小数点を削除しないでください。 d、i、u、および s を除くすべての指定子で機能します。 例: %#5.0f

• フィールド幅

  出力する最小文字数。

  フラグで特に指定されていない限り、この関数は値の前にスペースを追加してフィールド幅までパディングします。

• 精度

  %f、%e、または %E の場合	小数点以下の桁数 例: '%.4f' は pi を '3.1416' と出力します。
  d、i、o、u、x、X	書き込まれる最小桁数。指定された精度より短い出力の先頭がゼロでパディングされます。 例: "%.4d" は 5 を '0005' として出力します。
  %g または %G の場合	有効桁数 例: '%.4g' は pi を '3.142' と出力します。
  s	出力に書き込まれる最大文字数。 例: "%.2s" は "Hello!" を "He" として出力します。

  メモ

  浮動小数点値の精度演算子を入力の数値データ型の精度より大きい値に指定すると、入力値の精度が指定の精度にならない場合があります。結果はコンピューターのハードウェアとオペレーティング システムによって異なります。

書式演算子の前後のテキスト

特殊文字	表現
一重引用符	''
パーセント文字	%%
バックスラッシュ	\\
アラーム	\a
バックスペース	\b
フォーム フィード	\f
改行	\n
キャリッジ リターン	\r
水平タブ	\t
垂直タブ	\v
16 進数 N で表すことができる Unicode® 数値をもつ文字	\xN 例: sprintf('\x5A') は 'Z' を返します。
8 進数 N で表すことができる Unicode 数値をもつ文字	\N 例: sprintf('\132') は 'Z' を返します。

[書式設定] では、パーセント記号 % の前や、変換文字の後に追加のテキストを含めることができます。次のテキストを追加できます。

• 出力する通常のテキスト。

• 通常のテキストとして入力できない特殊文字。以下の表は、formatSpec で特殊文字を表す方法を示しています。

長さ指定子

Format String ブロックは、h および l の長さサブ指定子をサポートします。これらの指定子は、[コンフィギュレーション パラメーター] 、 [ハードウェア実行] 、 [ビット数] 設定に応じて変化します。

長さ	d i	u o x X	f e E g G	s
長さ指定子なし	int	unsigned int	double (既定の設定)、single	string
h	short	unsigned short	—	—
l	long	unsigned long	—	—

整数データ型を指定する指定子の注意 (d、i、u、o、x、X)

ターゲットの int、long および short 型のサイズは [コンフィギュレーション パラメーター] 、 [ハードウェア実行] ペイン設定によって制御されます。たとえば、ターゲットの int が 32 ビットで、指定子が %u の場合、期待される入力の型は uint32 になります。ただし、入力端子は %u 指定子のサイズ以下の任意の組み込み整数型を受け入れます。

浮動小数点データ型を指定する指定子の注意 (f、e、E、g、F)

• これらの指定子と l および h を一緒に使用しないでください。長さサブ指定子を使用しないでください (たとえば、%f は許可されますが、%hf および %lf は許可されません)。

• これらの指定子に対応する端子は single および double の両方のデータ型を受け入れます。

文字列データ型を指定する指定子の注意 (s)

• s 指定子は l または h サブ指定子では動作せず、文字列入力データ型のみを受け入れます。

拡張機能

C/C++ コード生成
Simulink® Coder™ を使用して C および C++ コードを生成します。

バージョン履歴

R2018a で導入

参考

sprintf | ASCII to String | Scan String | String Compare | String Concatenate | String Constant | String Find | String Length | String to Double | String to Single | String to ASCII | String to Enum | Substring | To String

トピック

• 座標データの表示と抽出
• Simulink の string