XStringListToTextProperty(3X11)

名前
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
    使用される 構造体を指定。

text_prop_return
    構造体が返される。

説明
関数 は指定された に、指定されたNULLで終わる文字列のリストを繋げたものを表す、STRING型 (フォーマット8)の値をセットする。 追加の NULL バイト(これは nitems メンバでは数えられない)は、 text_prop_return の value フィールドの最後に格納される。 文字列のエンコーディングは STRING であるものと(検査なしに)想定される。 新しい文字列のための十分なメモリが確保できなかった場合、 は 構造体のどのフィールドにも値をセットせず、ゼロのステータスを返す。 そうでない場合、この関数はゼロでないステータスを返す。 value フィールドのメモリを解放するには を使用すること。

関数 は指定した 構造体の NULL で終わる要素を表す文字列のリストを返す。 text_prop 内のデータは STRING 型で、フォーマット8 でなければならない。 プロパティの複数要素(例えば、ばらばらのテキストセレクション内の文字列) は NULL (エンコーディング0)で区切られる。 プロパティの内容は NULL で終わらない。 リストとその要素のための十分なメモリが確保できない場合、 は変数には内容をセットせず、ゼロのステータスを返す。 そうでない場合、この関数はゼロでないステータスを返す。 リストとその内容のメモリを解放するには を使用すること。

関数 は や がアロケートしたメモリと、 がアロケートした欠けている文字集合のリストを解放する。

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

typedef struct {
    unsigned char *value;    /* プロパティのデータ */
    Atom encoding;    /* プロパティの型 */
    int format;    /* 8, 16, あるいは 32 */
    unsigned long nitems;    /* value 内のアイテム数 */
} XTextProperty;

関連項目
XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11)
Xlib - C Language X Interface