.\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991, 1994, 1996 X Consortium .\" .\" Permission is hereby granted, free of charge, to any person obtaining .\" a copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including .\" without limitation the rights to use, copy, modify, merge, publish, .\" distribute, sublicense, and/or sell copies of the Software, and to .\" permit persons to whom the Software is furnished to do so, subject to .\" the following conditions: .\" .\" The above copyright notice and this permission notice shall be included .\" in all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF .\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. .\" IN NO EVENT SHALL THE X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR .\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, .\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR .\" OTHER DEALINGS IN THE SOFTWARE. .\" .\" Except as contained in this notice, the name of the X Consortium shall .\" not be used in advertising or otherwise to promote the sale, use or .\" other dealings in this Software without prior written authorization .\" from the X Consortium. .\" .\" Copyright \(co 1985, 1986, 1987, 1988, 1989, 1990, 1991 by .\" Digital Equipment Corporation .\" .\" Portions Copyright \(co 1990, 1991 by .\" Tektronix, Inc. .\" .\" Permission to use, copy, modify and distribute this documentation for .\" any purpose and without fee is hereby granted, provided that the above .\" copyright notice appears in all copies and that both that copyright notice .\" and this permission notice appear in all copies, and that the names of .\" Digital and Tektronix not be used in in advertising or publicity pertaining .\" to this documentation without specific, written prior permission. .\" Digital and Tektronix makes no representations about the suitability .\" of this documentation for any purpose. .\" It is provided ``as is'' without express or implied warranty. .\" .\" Copyright (c) 1998 The X Japanese Documentation Project. .\" .\" Permission is hereby granted, free of charge, to any person obtaining a .\" copy of this software and associated documentation files (the .\" "Software"), to deal in the Software without restriction, including .\" without limitation the rights to use, copy, modify, merge, publish, dis- .\" tribute, sublicense, and/or sell copies of the Software, and to permit .\" persons to whom the Software is furnished to do so, subject to the fol- .\" lowing conditions: .\" .\" The above copyright notice and this permission notice shall be included .\" in all copies or substantial portions of the Software. .\" .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL- .\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT .\" SHALL THE X JAPANESE DOCUMENTATION PROJECT BE LIABLE FOR ANY CLAIM, .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR .\" THE USE OR OTHER DEALINGS IN THE SOFTWARE. .\" .\" Except as contained in this notice, the name of The X Japanese .\" Documentation Project shall not be used in advertising or otherwise to .\" promote the sale, use or other dealings in this Software without prior .\" written authorization from The X Japanese Documentation Project. .\" .\" X Window System is a trademark of The Open Group. .\" .\" Translated Tue Oct 27 00:00:00 JST 1998 .\" by FUJIWARA Teruyoshi .\" .\" WORD: Host Portable Character Encoding ホストポータブル文字エンコーディング .\" .\" $XFree86: xc/doc/man/X11/XUQuark.man,v 1.4 2001/02/09 03:47:47 tsi Exp $ .\" .ds xT X Toolkit Intrinsics \- C Language Interface .ds xW Athena X Widgets \- C Language X Toolkit Interface .ds xL Xlib \- C Language X Interface .ds xC Inter-Client Communication Conventions Manual .na .de Ds .nf .\\$1D \\$2 \\$1 .ft 1 .\".ps \\n(PS .\".if \\n(VS>=40 .vs \\n(VSu .\".if \\n(VS<=39 .vs \\n(VSp .. .de De .ce 0 .if \\n(BD .DF .nr BD 0 .in \\n(OIu .if \\n(TM .ls 2 .sp \\n(DDu .fi .. .de FD .LP .KS .TA .5i 3i .ta .5i 3i .nf .. .de FN .fi .KE .LP .. .de IN \" send an index entry to the stderr .. .de C{ .KS .nf .D .\" .\" choose appropriate monospace font .\" the imagen conditional, 480, .\" may be changed to L if LB is too .\" heavy for your eyes... .\" .ie "\\*(.T"480" .ft L .el .ie "\\*(.T"300" .ft L .el .ie "\\*(.T"202" .ft PO .el .ie "\\*(.T"aps" .ft CW .el .ft R .ps \\n(PS .ie \\n(VS>40 .vs \\n(VSu .el .vs \\n(VSp .. .de C} .DE .R .. .de Pn .ie t \\$1\fB\^\\$2\^\fR\\$3 .el \\$1\fI\^\\$2\^\fP\\$3 .. .de ZN .ie t \fB\^\\$1\^\fR\\$2 .el \fI\^\\$1\^\fP\\$2 .. .de hN .ie t <\fB\\$1\fR>\\$2 .el <\fI\\$1\fP>\\$2 .. .de NT .ne 7 .ds NO Note .if \\n(.$>$1 .if !'\\$2'C' .ds NO \\$2 .if \\n(.$ .if !'\\$1'C' .ds NO \\$1 .ie n .sp .el .sp 10p .TB .ce \\*(NO .ie n .sp .el .sp 5p .if '\\$1'C' .ce 99 .if '\\$2'C' .ce 99 .in +5n .ll -5n .R .. . \" Note End -- doug kraft 3/85 .de NE .ce 0 .in -5n .ll +5n .ie n .sp .el .sp 10p .. .ny0 .TH XrmUniqueQuark 3X11 "Release 6.5" "X Version 11" "XLIB FUNCTIONS" .SH 名前 .\"0 XrmUniqueQuark, XrmStringToQuark, XrmPermStringToQuark, XrmQuarkToString, XrmStringToQuarkList, XrmStringToBindingQuarkList \- manipulate resource quarks XrmUniqueQuark, XrmStringToQuark, XrmPermStringToQuark, XrmQuarkToString, XrmStringToQuarkList, XrmStringToBindingQuarkList \- リソースのクォークを操作する .SH 書式 XrmQuark XrmUniqueQuark\^(\|) .LP \&#define XrmStringToName(string) XrmStringToQuark(string) \&#define XrmStringToClass(string) XrmStringToQuark(string) \&#define XrmStringToRepresentation(string) XrmStringToQuark(string) .sp XrmQuark XrmStringToQuark\^(\^\fIstring\fP\^) .br char *\fIstring\fP\^; .sp XrmQuark XrmPermStringToQuark\^(\^\fIstring\fP\^) .br char *\fIstring\fP\^; .LP \&#define XrmStringToName(string) XrmStringToQuark(string) \&#define XrmStringToClass(string) XrmStringToQuark(string) \&#define XrmStringToRepresentation(string) XrmStringToQuark(string) .sp XrmQuark XrmStringToQuark\^(\^\fIstring\fP\^) .br char *\fIstring\fP\^; .sp XrmQuark XrmPermStringToQuark\^(\^\fIstring\fP\^) .br char *\fIstring\fP\^; .LP \&#define XrmNameToString(name) XrmQuarkToString(name) \&#define XrmClassToString(class) XrmQuarkToString(class) \&#define XrmRepresentationToString(type) XrmQuarkToString(type) .sp char *XrmQuarkToString\^(\^\fIquark\fP\^) .br XrmQuark \fIquark\fP\^; .LP \&#define XrmStringToNameList(str, name) XrmStringToQuarkList((str), (name)) \&#define XrmStringToClassList(str,class) XrmStringToQuarkList((str), (class)) .sp void XrmStringToQuarkList\^(\^\fIstring\fP, \fIquarks_return\fP\^) .br char *\fIstring\fP\^; .br XrmQuarkList \fIquarks_return\fP\^; .LP XrmStringToBindingQuarkList\^(\^\fIstring\fP, \fIbindings_return\fP, \fIquarks_return\fP\^) .br char *\fIstring\fP\^; .br XrmBindingList \fIbindings_return\fP\^; .br XrmQuarkList \fIquarks_return\fP\^; .SH 引き数 .IP \fIbindings_return\fP 1i .\"0 Returns the binding list. 結合リストが返される。 .IP \fIquark\fP 1i .\"0 Specifies the quark for which the equivalent string is desired. 等価な文字列を求める対象であるクォークを指定する。 .IP \fIquarks_return\fP 1i .\"0 Returns the list of quarks. クォークのリストが返される。 .ds Ql \ or quark list .IP \fIstring\fP 1i .\"0 Specifies the string for which a quark\*(Ql is to be allocated. 割り当てられるクォークかクォークのリストに対する文字列を指定する。 .SH 説明 .\"0 The .\"0 .ZN XrmUniqueQuark .\"0 function allocates a quark that is guaranteed not to represent any string that .\"0 is known to the resource manager. 関数 .ZN XrmUniqueQuark は、リソースマネージャが認識しているどの文字列も表さないことが保証され るクォークを割り当てる。 .LP .\"0 These functions can be used to convert from string to quark representation. これらの関数は、文字列をクォーク表現に変換するために使うことができる。 .\"0 If the string is not in the Host Portable Character Encoding, .\"0 the conversion is implementation-dependent. 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合、変換の動作は実装に依存する。 .\"0 The string argument to .\"0 .ZN XrmStringToQuark .\"0 need not be permanently allocated storage. .ZN XrmStringToQuark に渡す引き数 string は、ずっと割り当てられたままの領域である必要はない。 .\"0 .ZN XrmPermStringToQuark .\"0 is just like .\"0 .ZN XrmStringToQuark , .\"0 except that Xlib is permitted to assume the string argument is permanently .\"0 allocated, .\"0 and, hence, that it can be used as the value to be returned by .\"0 .ZN XrmQuarkToString . 関数 .ZN XrmPermStringToQuark は .ZN XrmStringToQuark とほぼ同じであるが、引き数 string が割り当てられたままの領域で あることを Xlib が想定してもよい点が異なる。したがって、引き数 string は .ZN XrmQuarkToString が返す値として使うことができる。 .LP .\"0 For any given quark, if .\"0 .ZN XrmStringToQuark .\"0 returns a non-NULL value, .\"0 all future calls will return the same value (identical address). 与えられたクォークについて、 .ZN XrmStringToQuark が NULL でない値を返した場合、それ以降の全ての関数呼び出しに対して同じ 値(同一のアドレス)が返される。 .LP .\"0 These functions can be used to convert from quark representation to string. これらの関数は、クォーク表現を文字列に変換するために使うことができる。 .\"0 The string pointed to by the return value must not be modified or freed. 関数の返り値が指す文字列の変更や解放を行ってはならない。 .\"0 The returned string is byte-for-byte equal to the original .\"0 string passed to one of the string-to-quark routines. 返される文字列は、文字列をクォークに変換する関数に渡された元の文字列 とバイトのレベルで等しい。 .\"0 If no string exists for that quark, .\"0 .ZN XrmQuarkToString .\"0 returns NULL. そのクォークに対する文字列が存在しない場合、 .ZN XrmQuarkToString は NULL を返す。 .\"0 For any given quark, if .\"0 .ZN XrmQuarkToString .\"0 returns a non-NULL value, .\"0 all future calls will return the same value (identical address). 与えられたクォークに対して .ZN XrmQuarkToString が NULL でない値を返した場合、それ以降の全ての関数呼び出しに対して同じ 値(同一のアドレス)が返される。 .LP .\"0 These functions can be used to convert from string to quark representation. これらの関数は、文字列のクォーク表現への変換に使うことができる。 .\"0 If the string is not in the Host Portable Character Encoding, .\"0 the conversion is implementation-dependent. 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合、 変換の動作は実装依存である。 .\"0 The string argument to .\"0 .ZN XrmStringToQuark .\"0 need not be permanently allocated storage. .ZN XrmStringToQuark に渡す引き数 string は、ずっと割り当てられたままの領域である必要はない。 .\"0 .ZN XrmPermStringToQuark .\"0 is just like .\"0 .ZN XrmStringToQuark , .\"0 except that Xlib is permitted to assume the string argument is permanently .\"0 allocated, .\"0 and, hence, that it can be used as the value to be returned by .\"0 .ZN XrmQuarkToString . 関数 .ZN XrmPermStringToQuark は .ZN XrmStringToQuark とほぼ同じであるが、Xlib が引き数 string が割り当てられたままの領域で あることを想定してもよい点が異なる。したがって、この関数では引き数 string を .ZN XrmQuarkToString に返される値として使うことができる。 .LP .\"0 For any given quark, if .\"0 .ZN XrmStringToQuark .\"0 returns a non-NULL value, .\"0 all future calls will return the same value (identical address). 与えられたクォークについて、 .ZN XrmStringToQuark が NULL でない値を返した場合、それ以降の全ての関数呼び出しに対して同じ 値(同一のアドレス)が返される。 .LP .\"0 The .\"0 .ZN XrmStringToQuarkList .\"0 function converts the null-terminated string (generally a fully qualified name) .\"0 to a list of quarks. 関数 .ZN XrmStringToQuarkList は NULL で終わる文字列(一般的には完全に限定された名前)をクォークのリス トに変換する。 .\"0 The caller must allocate sufficient space for the quarks list before calling .\"0 .ZN XrmStringToQuarkList . 呼び出し側は、 .ZN XrmStringToQuarkList を呼び出す前に、クォークのリストを格納するのに十分なメモリを割り当てて おかなければならない。 .\"0 Note that the string must be in the valid ResourceName format .\"0 (see section 15.1). この文字列は有効な ResourceName 形式でなければならない(15.1 節を参照)。 .\"0 If the string is not in the Host Portable Character Encoding, .\"0 the conversion is implementation-dependent. この文字列のエンコーディングがホストポータブル文字エンコーディングでな い場合、変換の動作は実装依存である。 .LP .\"0 A binding list is a list of type .\"0 .ZN XrmBindingList .\"0 and indicates if components of name or class lists are bound tightly or loosely .\"0 (that is, if wildcarding of intermediate components is specified). 結合リストは、 .ZN XrmBindingList 型であり、クラスや名前のリストの要素が強くあるいは緩く関連づけされてい る(つまり、ワールドカードを使った中間要素が指定されている)ことを示す。 .LP .Ds 0 typedef enum {XrmBindTightly, XrmBindLoosely} XrmBinding, *XrmBindingList; .De .LP .\"0 .ZN XrmBindTightly .\"0 indicates that a period separates the components, and .\"0 .ZN XrmBindLoosely .\"0 indicates that an asterisk separates the components. .ZN XrmBindTightly は、ピリオドが要素を区切っていること示す。また、 .ZN XrmBindLoosely は、アスタリスクが要素を区切っていることを示す。 .LP .\"0 The .\"0 .ZN XrmStringToBindingQuarkList .\"0 function converts the specified string to a binding list and a quark list. 関数 .ZN XrmStringToBindingQuarkList は、指定した文字列を結合リストとクォークのリストに変換する。 .\"0 The caller must allocate sufficient space for the quarks list and the .\"0 binding list before calling .\"0 .ZN XrmStringToBindingQuarkList . 呼び出し側は、 .ZN XrmStringToBindingQuarkList を呼び出す前に、クォークのリストと結合リストを格納するのに 十分なメモリを割り当てておかなければならない。 .\"0 If the string is not in the Host Portable Character Encoding .\"0 the conversion is implementation-dependent. 文字列のエンコーディングがホストポータブル文字エンコーディングでない場 合、変換の動作は実装依存である。 .\"0 Component names in the list are separated by a period or .\"0 an asterisk character. リストが含む要素名は、ピリオドかアスタリスクで区切られている。 .\"0 If the string does not start with period or asterisk, .\"0 a period is assumed. 文字列の最初の文字がピリオドかアスタリスクではない場合は、ピリオドであ るものとして扱われる。 .\"0 For example, ``*a.b*c'' becomes: 例えば ``*a.b*c'' は次のようになる: .LP .Ds 0 .TA .75i 1.5i 2.25i .ta .75i 1.5i 2.25i .\"0 quarks a b c クォーク a b c .br .\"0 bindings loose tight loose 結合 緩い 強い 緩い .De .SH 関連項目 XrmGetResource(3X11), XrmInitialize(3X11), XrmMergeDatabases(3X11), XrmPutResource(3X11) .br \fI\*(xL\fP