XStringListToTextProperty

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX

名前

XStringListToTextProperty, XTextPropertyToStringList, XFreeStringList, XTextProperty - 文字列のリストとテキストプロパティ構造体を変換する

書式

Status XStringListToTextProperty(list, count, text_prop_return)

      char **list;

      int count;

      XTextProperty *text_prop_return;

Status XTextPropertyToStringList(text_prop, list_return, count_return)

       XTextProperty *text_prop;

       char ***list_return;

       int *count_return;

void XFreeStringList(list)

char **list;

引き数

count: 文字列の数を指定する。
count_return: 文字列の数が返される。
list: 解放する文字列のリストを指定する。
list: NULL 文字で終わる文字列のリストを指定する。
list_return: NULL 文字で終わる文字列のリストが返される。
text_prop: 使われる XTextProperty 構造体を指定する。
text_prop_return: XTextProperty 構造体が返される。

説明

関数 XStringListToTextProperty は、指定された文字列のリストの要素を繋げた値を指定された XTextProperty に設定する。設定される値は STRING 型(フォーマット 8)であり、元のそれぞれの文字列は NULL で終わる。追加の NULL バイト(これは nitems メンバの数には入らない)は、 text_prop_return の value フィールドの最後に格納される。文字列のエンコーディングは STRING であるものと(検査なしに)想定される。新しい文字列に割り当てる十分なメモリがなかった場合、 XStringListToTextProperty は XTextProperty 構造体のどのフィールドにも値を設定せず、ステータスとして 0 を返す。そうでない場合、この関数は 0 でないステータスを返す。 value フィールドのメモリを解放するには XFree を使用すること。

関数 XTextPropertyToStringList は指定した XTextProperty 構造体が持つ要素群(NULL で区切られている)の内容を表す文字列のリストを返す。 text_prop 内のデータは STRING 型かつフォーマット 8 でなければならない。プロパティに複数個の要素が含まれる場合(例えば、細切れになったテキストセレクションに含まれている文字列)は NULL (エンコーディング 0)で区切られている。プロパティの内容の終端は NULL ではない。リストとその要素に割り当てる十分なメモリがなかった場合、 XTextPropertyToStringList は変数に内容を設定せず、ステータスとして 0 を返す。そうでない場合、この関数は 0 でないステータスを返す。リストとその内容のメモリを解放するには XFreeStringList を使用すること。

関数 XFreeStringList は XmbTextPropertyToTextList や XTextPropertyToStringList が割り当てたメモリと、 XCreateFontSet が割り当てた欠けている文字集合のリストを解放する。

構造体

XTextProperty 構造体の内容を以下に示す。


typedef struct {
     unsigned char *value;/* プロパティのデータ */
     Atom encoding;      /* プロパティの型 */
     int format;         /* 8, 16, 32 のいずれか */
     unsigned long nitems;/* value 内の要素数 */
} XTextProperty;

This document was created by man2html, using the manual pages.
Time: 15:56:05 GMT, February 12, 2001

XStringListToTextProperty

名前

書式

引き数

説明

構造体

関連項目

Index