12c393a42Smrg/*
2a6844aabSmrg * fontconfig/doc/fcvalue.fncs
32c393a42Smrg *
42c393a42Smrg * Copyright © 2003 Keith Packard
52c393a42Smrg *
62c393a42Smrg * Permission to use, copy, modify, distribute, and sell this software and its
72c393a42Smrg * documentation for any purpose is hereby granted without fee, provided that
82c393a42Smrg * the above copyright notice appear in all copies and that both that
92c393a42Smrg * copyright notice and this permission notice appear in supporting
10ca08ab68Smrg * documentation, and that the name of the author(s) not be used in
112c393a42Smrg * advertising or publicity pertaining to distribution of the software without
12ca08ab68Smrg * specific, written prior permission.  The authors make no
132c393a42Smrg * representations about the suitability of this software for any purpose.  It
142c393a42Smrg * is provided "as is" without express or implied warranty.
152c393a42Smrg *
16a6844aabSmrg * THE AUTHOR(S) DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
172c393a42Smrg * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
18a6844aabSmrg * EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY SPECIAL, INDIRECT OR
192c393a42Smrg * CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE,
202c393a42Smrg * DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
212c393a42Smrg * TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
222c393a42Smrg * PERFORMANCE OF THIS SOFTWARE.
232c393a42Smrg */
241cc69409Smrg@RET@           void
251cc69409Smrg@FUNC@          FcValueDestroy
261cc69409Smrg@TYPE1@         FcValue%                @ARG1@          v
271cc69409Smrg@PURPOSE@       Free a value
282c393a42Smrg@DESC@
292c393a42SmrgFrees any memory referenced by <parameter>v</parameter>.  Values of type FcTypeString,
302c393a42SmrgFcTypeMatrix and FcTypeCharSet reference memory, the other types do not.
312c393a42Smrg@@
322c393a42Smrg
331cc69409Smrg@RET@           FcValue
341cc69409Smrg@FUNC@          FcValueSave
351cc69409Smrg@TYPE1@         FcValue%                @ARG1@          v
361cc69409Smrg@PURPOSE@       Copy a value
372c393a42Smrg@DESC@
382c393a42SmrgReturns a copy of <parameter>v</parameter> duplicating any object referenced by it so that <parameter>v</parameter>
392c393a42Smrgmay be safely destroyed without harming the new value.
402c393a42Smrg@@
412c393a42Smrg
421cc69409Smrg@RET@           void
431cc69409Smrg@FUNC@          FcValuePrint
441cc69409Smrg@TYPE1@         FcValue%                @ARG1@          v
451cc69409Smrg@PURPOSE@       Print a value to stdout
462c393a42Smrg@DESC@
472c393a42SmrgPrints a human-readable representation of <parameter>v</parameter> to
482c393a42Smrgstdout. The format should not be considered part of the library
492c393a42Smrgspecification as it may change in the future.
502c393a42Smrg@@
512c393a42Smrg
521cc69409Smrg@RET@           FcBool
531cc69409Smrg@FUNC@          FcValueEqual
541cc69409Smrg@TYPE1@         FcValue%                @ARG1@          v_a
551cc69409Smrg@TYPE2@         FcValue%                @ARG2@          v_b
561cc69409Smrg@PURPOSE@       Test two values for equality
572c393a42Smrg@DESC@
582c393a42SmrgCompares two values. Integers and Doubles are compared as numbers; otherwise
592c393a42Smrgthe two values have to be the same type to be considered equal. Strings are
602c393a42Smrgcompared ignoring case.
612c393a42Smrg@@
62