a562773c13bd57641d8ed0301609ae82d609ea6e
[platform/upstream/fontconfig.git] / doc / fcconstant.sgml
1 <!--
2    fontconfig/doc/func.sgml
3   
4    Copyright © 2003 Keith Packard
5   
6    Permission to use, copy, modify, distribute, and sell this software and its
7    documentation for any purpose is hereby granted without fee, provided that
8    the above copyright notice appear in all copies and that both that
9    copyright notice and this permission notice appear in supporting
10    documentation, and that the name of the author(s) not be used in
11    advertising or publicity pertaining to distribution of the software without
12    specific, written prior permission.  The authors make no
13    representations about the suitability of this software for any purpose.  It
14    is provided "as is" without express or implied warranty.
15   
16    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
17    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
18    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
19    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
20    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
21    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
22    PERFORMANCE OF THIS SOFTWARE.
23  -->
24     <refentry id="FcNameRegisterConstants">
25         <refmeta>
26             <refentrytitle>FcNameRegisterConstants</refentrytitle>
27             <manvolnum>3</manvolnum>
28         </refmeta>
29         <refnamediv>
30             <refname>FcNameRegisterConstants</refname>
31             <refpurpose>Register symbolic constants</refpurpose>
32         </refnamediv>
33         <refsynopsisdiv>
34         <funcsynopsis>
35         <funcsynopsisinfo>
36 #include &lt;fontconfig/fontconfig.h&gt;
37         </funcsynopsisinfo>
38         <funcprototype>
39             <funcdef>FcBool <function>FcNameRegisterConstants</function></funcdef>
40                 <paramdef>const FcConstant *<parameter>consts</parameter></paramdef>
41                 <paramdef>int <parameter>nconsts</parameter></paramdef>
42         </funcprototype>
43         </funcsynopsis>
44         </refsynopsisdiv>
45         <refsect1><title>Description</title>
46             <para>
47 Deprecated.  Does nothing.  Returns FcFalse.
48             </para>
49         </refsect1>
50         <refsect1><title>Version</title>
51             <para>
52 Fontconfig version &version;
53             </para>
54         </refsect1>
55     </refentry>
56 <!--
57    fontconfig/doc/func.sgml
58   
59    Copyright © 2003 Keith Packard
60   
61    Permission to use, copy, modify, distribute, and sell this software and its
62    documentation for any purpose is hereby granted without fee, provided that
63    the above copyright notice appear in all copies and that both that
64    copyright notice and this permission notice appear in supporting
65    documentation, and that the name of the author(s) not be used in
66    advertising or publicity pertaining to distribution of the software without
67    specific, written prior permission.  The authors make no
68    representations about the suitability of this software for any purpose.  It
69    is provided "as is" without express or implied warranty.
70   
71    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
72    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
73    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
74    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
75    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
76    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
77    PERFORMANCE OF THIS SOFTWARE.
78  -->
79     <refentry id="FcNameUnregisterConstants">
80         <refmeta>
81             <refentrytitle>FcNameUnregisterConstants</refentrytitle>
82             <manvolnum>3</manvolnum>
83         </refmeta>
84         <refnamediv>
85             <refname>FcNameUnregisterConstants</refname>
86             <refpurpose>Unregister symbolic constants</refpurpose>
87         </refnamediv>
88         <refsynopsisdiv>
89         <funcsynopsis>
90         <funcsynopsisinfo>
91 #include &lt;fontconfig/fontconfig.h&gt;
92         </funcsynopsisinfo>
93         <funcprototype>
94             <funcdef>FcBool <function>FcNameUnregisterConstants</function></funcdef>
95                 <paramdef>const FcConstant *<parameter>consts</parameter></paramdef>
96                 <paramdef>int <parameter>nconsts</parameter></paramdef>
97         </funcprototype>
98         </funcsynopsis>
99         </refsynopsisdiv>
100         <refsect1><title>Description</title>
101             <para>
102 Deprecated.  Does nothing.  Returns FcFalse.
103             </para>
104         </refsect1>
105         <refsect1><title>Version</title>
106             <para>
107 Fontconfig version &version;
108             </para>
109         </refsect1>
110     </refentry>
111 <!--
112    fontconfig/doc/func.sgml
113   
114    Copyright © 2003 Keith Packard
115   
116    Permission to use, copy, modify, distribute, and sell this software and its
117    documentation for any purpose is hereby granted without fee, provided that
118    the above copyright notice appear in all copies and that both that
119    copyright notice and this permission notice appear in supporting
120    documentation, and that the name of the author(s) not be used in
121    advertising or publicity pertaining to distribution of the software without
122    specific, written prior permission.  The authors make no
123    representations about the suitability of this software for any purpose.  It
124    is provided "as is" without express or implied warranty.
125   
126    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
127    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
128    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
129    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
130    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
131    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
132    PERFORMANCE OF THIS SOFTWARE.
133  -->
134     <refentry id="FcNameGetConstant">
135         <refmeta>
136             <refentrytitle>FcNameGetConstant</refentrytitle>
137             <manvolnum>3</manvolnum>
138         </refmeta>
139         <refnamediv>
140             <refname>FcNameGetConstant</refname>
141             <refpurpose>Lookup symbolic constant</refpurpose>
142         </refnamediv>
143         <refsynopsisdiv>
144         <funcsynopsis>
145         <funcsynopsisinfo>
146 #include &lt;fontconfig/fontconfig.h&gt;
147         </funcsynopsisinfo>
148         <funcprototype>
149             <funcdef>const FcConstant * <function>FcNameGetConstant</function></funcdef>
150                 <paramdef>FcChar8 *<parameter>string</parameter></paramdef>
151         </funcprototype>
152         </funcsynopsis>
153         </refsynopsisdiv>
154         <refsect1><title>Description</title>
155             <para>
156 Return the FcConstant structure related to symbolic constant <parameter>string</parameter>.
157             </para>
158         </refsect1>
159         <refsect1><title>Version</title>
160             <para>
161 Fontconfig version &version;
162             </para>
163         </refsect1>
164     </refentry>
165 <!--
166    fontconfig/doc/func.sgml
167   
168    Copyright © 2003 Keith Packard
169   
170    Permission to use, copy, modify, distribute, and sell this software and its
171    documentation for any purpose is hereby granted without fee, provided that
172    the above copyright notice appear in all copies and that both that
173    copyright notice and this permission notice appear in supporting
174    documentation, and that the name of the author(s) not be used in
175    advertising or publicity pertaining to distribution of the software without
176    specific, written prior permission.  The authors make no
177    representations about the suitability of this software for any purpose.  It
178    is provided "as is" without express or implied warranty.
179   
180    THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
181    INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
182    EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
183    CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
184    DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
185    TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
186    PERFORMANCE OF THIS SOFTWARE.
187  -->
188     <refentry id="FcNameConstant">
189         <refmeta>
190             <refentrytitle>FcNameConstant</refentrytitle>
191             <manvolnum>3</manvolnum>
192         </refmeta>
193         <refnamediv>
194             <refname>FcNameConstant</refname>
195             <refpurpose>Get the value for a symbolic constant</refpurpose>
196         </refnamediv>
197         <refsynopsisdiv>
198         <funcsynopsis>
199         <funcsynopsisinfo>
200 #include &lt;fontconfig/fontconfig.h&gt;
201         </funcsynopsisinfo>
202         <funcprototype>
203             <funcdef>FcBool <function>FcNameConstant</function></funcdef>
204                 <paramdef>FcChar8 *<parameter>string</parameter></paramdef>
205                 <paramdef>int *<parameter>result</parameter></paramdef>
206         </funcprototype>
207         </funcsynopsis>
208         </refsynopsisdiv>
209         <refsect1><title>Description</title>
210             <para>
211 Returns whether a symbolic constant with name <parameter>string</parameter> is registered,
212 placing the value of the constant in <parameter>result</parameter> if present.
213             </para>
214         </refsect1>
215         <refsect1><title>Version</title>
216             <para>
217 Fontconfig version &version;
218             </para>
219         </refsect1>
220     </refentry>