## Tcl8.6.17/Tk8.6.17 Documentation > Tk C API > InternAtom

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    Tk_InternAtom, Tk_GetAtomName — X 基本子の高速記憶を制御する　 manage cache of X atoms
  SYNOPSIS
    #include <tk.h>
    Atom
    Tk_InternAtom(tkwin, name)
    const char *
    Tk_GetAtomName(tkwin, atom)
  引数 ARGUMENTS
    Tk_Window tkwin (入力in)
    const char *name (入力in)
    Atom atom (入力in)
  説明 DESCRIPTION
  KEYWORDS

### NAME

Tk_InternAtom, Tk_GetAtomName — X 基本子の高速記憶を制御する　 manage cache of X atoms

### SYNOPSIS

#include <tk.h>
Atom
Tk_InternAtom(tkwin, name)
const char *
Tk_GetAtomName(tkwin, atom)

### 引数 ARGUMENTS

Tk_Window tkwin (入力in)
  窓の為の字句｡特定の表示器に相対的な基本子又は名前の対応付けに使われる｡　 Token for window. Used to map atom or name relative to a particular display.

const char *name (入力in)
  基本子が望む文字列名称｡　 String name for which atom is desired.

Atom atom (入力in)
  対応する文字列名称が望まれる基本子｡　 Atom for which corresponding string name is desired.

### 説明 DESCRIPTION

これ等の手続函数は Xlib 手続函数 XInternAtom や XGetAtomName と似ている｡ Tk_InternAtom は name によって与えられた文字列に結合した基本子識別子を返す; 基本子識別子は tkwin と結合した表示装置に対してのみ有効である｡Tk_GetAtomName は tkwinの 表示装置上の 基本子 と結合した文字列を返す｡ Tk_GetAtomName によって返される文字列は Tk の記憶域に中ある: 呼び出し側はこの文字列が終ったときこの空間を開放する必要はない､又呼び出し側は返された文字列の内容を修正するべきではない｡もし tkwinの 表示装置上に基本子 atom がない場合､ Tk_GetAtomName は文字列 “?bad atom?” を返す｡ 　　　　 These procedures are similar to the Xlib procedures XInternAtom and XGetAtomName. Tk_InternAtom returns the atom identifier associated with string given by name; the atom identifier is only valid for the display associated with tkwin. Tk_GetAtomName returns the string associated with atom on tkwin's display. The string returned by Tk_GetAtomName is in Tk's storage: the caller need not free this space when finished with the string, and the caller should not modify the contents of the returned string. If there is no atom atom on tkwin's display, then Tk_GetAtomName returns the string “?bad atom?”.

Tk は Tk_InternAtom と Tk_GetAtomName によって返された情報を高速記憶域に記憶するので､同じ情報に関する将来の呼出しは中央集中処理装置と連絡なしに高速域から情報を提供することができる｡そこで Tk_InternAtom と Tk_GetAtomName は一般に Xlib の相当品より充分速く､ Xlib 手続函数の代りに使うべきである｡ Tk caches the information returned by Tk_InternAtom and Tk_GetAtomName so that future calls for the same information can be serviced from the cache without contacting the server. Thus Tk_InternAtom and Tk_GetAtomName are generally much faster than their Xlib counterparts, and they should be used in place of the Xlib procedures.

### KEYWORDS

atom, cache, display
Copyright © 1990 The Regents of the University of California.
Copyright © 1994-1996 Sun Microsystems, Inc.