名称

XInternAtom, XGetAtomName − アトムを生成するかまたは返す

形式

Atom XInternAtom(display, atom_name, only_if_exists)
      Display ∗display;
      char ∗atom_name;
      Bool only_if_exists; char ∗XGetAtomName(display, atom)
      Display ∗display;
      Atom atom;

引数

atom返したいプロパティのアトムを指定します。

atom_name返したいアトムに関する名前を指定します。

displayX サーバへのコネクションを指定します。

only_if_exists
XInternAtom がアトムを生成するか否かを示すブール値を指定します。

解説

XInternAtom 関数は、指定された atom_name 文字列に関するアトム ID を返します。 only_if_exists が False の場合、 もし存在しなければアトムが生成されます。 したがって、 XInternAtom は None を返すことができます。 atom_name に対して、ナルで終わる ISO Latin-1 文字列を使用しなければなりません。 例 ; 文字列 thing, Thing, および thinG すべては、異なるアトムを指定します。 アトムは、クライアントのコネクションがクローズした後でさえ、 定義されたままです。 X サーバへの最後のコネクションがクローズした場合にだけ、アトムは 未定義となります。 .PN XInternAtom は、 BadAlloc および BadValue エラーを生じることがあります。 XGetAtomName 関数は、指定されたアトムに関する名前を返します。 その結果として生じる文字列を解放するには、 XFree をコールします。 .PN XGetAtomName は、 BadAtom エラーを生じることがあります。

診断

BadAlloc サーバが要求されたリソースまたはサーバメモリの割当てに失敗した。

BadAtom Atom 引数の値が定義された Atom を指さない。

BadValue ある数値が許容範囲を超えた。 引数の値の範囲が明示されない限り、引数のタイプによって決まる最大の 範囲まで指定可能です。 選択形式の引数も、このエラーを生じることがあります。

関連事項

XGetWindowProperty(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3