m_setvalues_layout() - レイアウト・オブジェクト (Bidi データ) のレイアウト値の設定

標準

形式

#include <sys/layout.h>

int m_setvalues_layout(LayoutObject layout_object, const LayoutValues values,
                       int *index_returned);

機能説明

m_setvalues_layout() 関数は、Visual (MVS™) と Implicit (z/OS® UNIX) フォーマット間のデータの双方向 (Bidi) 変換処理に対するサポートの一部を構成しています。初期サポートは、アラビア語とヘブライ語のデータ用です。

m_setvalues_layout() 関数は、LayoutObject のレイアウト値を変更するために使用できます。layout_object 引数は、m_create_layout() 関数から戻される LayoutObject を指定します。values 引数は、変更するレイアウト値のリストを指定します。この値は LayoutObject に書き込まれ、以降のレイアウト関数の動作に影響を与えます。

戻り値

正常に実行された場合、m_setvalues_layout() は要求されたレイアウト値を設定し、0 を戻します。

設定できない値があった場合、m_setvalues_layout() は、いずれのレイアウト値も変更しません。エラーを起こした値の (ゼロ・ベースの) インデックスを、index_returned に保管します。-1 を戻し、errno を次のいずれかの値に設定します。

エラー・コード

説明

EINVAL

index_returned が指定するレイアウト値が不明か、その値が無効か、または引数 layout_object が無効です。

関連情報

• sys/layout.h
• m_create_layout() - レイアウト・オブジェクト (Bidi データ) の作成と初期設定
• m_destroy_layout() - レイアウト・オブジェクト (Bidi データ) の破棄
• m_getvalues_layout() - レイアウト・オブジェクト (Bidi データ) のレイアウト値の照会
• m_transform_layout() - 文字ストリング (Bidi データ) のレイアウト変換
• m_wtransform_layout() - ワイド文字ストリング (Bidi データ) のレイアウト変換