doc/fontconfig-devel/fcpatternadd.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >FcPatternAdd</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 HREF="t1.html"><LINK
  11 REL="UP"
  12 TITLE="FcPattern"
  13 HREF="x102.html#AEN241"><LINK
  14 REL="PREVIOUS"
  15 TITLE="FcPatternHash"
  16 HREF="fcpatternhash.html"><LINK
  17 REL="NEXT"
  18 TITLE="FcPatternAddWeak"
  19 HREF="fcpatternaddweak.html"></HEAD
  20 ><BODY
  21 CLASS="REFENTRY"
  22 BGCOLOR="#FFFFFF"
  23 TEXT="#000000"
  24 LINK="#0000FF"
  25 VLINK="#840084"
  26 ALINK="#0000FF"
  27 ><DIV
  28 CLASS="NAVHEADER"
  29 ><TABLE
  30 SUMMARY="Header navigation table"
  31 WIDTH="100%"
  32 BORDER="0"
  33 CELLPADDING="0"
  34 CELLSPACING="0"
  35 ><TR
  36 ><TH
  37 COLSPAN="3"
  38 ALIGN="center"
  39 ></TH
  40 ></TR
  41 ><TR
  42 ><TD
  43 WIDTH="10%"
  44 ALIGN="left"
  45 VALIGN="bottom"
  46 ><A
  47 HREF="fcpatternhash.html"
  48 ACCESSKEY="P"
  49 >&#60;&#60;&#60; Previous</A
  50 ></TD
  51 ><TD
  52 WIDTH="80%"
  53 ALIGN="center"
  54 VALIGN="bottom"
  55 ></TD
  56 ><TD
  57 WIDTH="10%"
  58 ALIGN="right"
  59 VALIGN="bottom"
  60 ><A
  61 HREF="fcpatternaddweak.html"
  62 ACCESSKEY="N"
  63 >Next &#62;&#62;&#62;</A
  64 ></TD
  65 ></TR
  66 ></TABLE
  67 ><HR
  68 ALIGN="LEFT"
  69 WIDTH="100%"></DIV
  70 ><H1
  71 ><A
  72 NAME="FCPATTERNADD"
  73 ></A
  74 >FcPatternAdd</H1
  75 ><DIV
  76 CLASS="REFNAMEDIV"
  77 ><A
  78 NAME="AEN420"
  79 ></A
  80 ><H2
  81 >Name</H2
  82 >FcPatternAdd&nbsp;--&nbsp;Add a value to a pattern</DIV
  83 ><DIV
  84 CLASS="REFSYNOPSISDIV"
  85 ><A
  86 NAME="AEN423"
  87 ></A
  88 ><H2
  89 >Synopsis</H2
  90 ><DIV
  91 CLASS="FUNCSYNOPSIS"
  92 ><P
  93 ></P
  94 ><A
  95 NAME="AEN424"
  96 ></A
  97 ><TABLE
  98 BORDER="0"
  99 BGCOLOR="#E0E0E0"
 100 WIDTH="100%"
 101 ><TR
 102 ><TD
 103 ><PRE
 104 CLASS="FUNCSYNOPSISINFO"
 105 >#include &#60;fontconfig/fontconfig.h&#62;
 106         </PRE
 107 ></TD
 108 ></TR
 109 ></TABLE
 110 ><P
 111 ><CODE
 112 ><CODE
 113 CLASS="FUNCDEF"
 114 >FcBool <TT
 115 CLASS="FUNCTION"
 116 >FcPatternAdd</TT
 117 ></CODE
 118 >(FcPattern *<TT
 119 CLASS="PARAMETER"
 120 ><I
 121 >p</I
 122 ></TT
 123 >, const char *<TT
 124 CLASS="PARAMETER"
 125 ><I
 126 >object</I
 127 ></TT
 128 >, FcValue <TT
 129 CLASS="PARAMETER"
 130 ><I
 131 >value</I
 132 ></TT
 133 >, FcBool <TT
 134 CLASS="PARAMETER"
 135 ><I
 136 >append</I
 137 ></TT
 138 >);</CODE
 139 ></P
 140 ><P
 141 ></P
 142 ></DIV
 143 ></DIV
 144 ><DIV
 145 CLASS="REFSECT1"
 146 ><A
 147 NAME="AEN437"
 148 ></A
 149 ><H2
 150 >Description</H2
 151 ><P
 152 >Adds a single value to the list of values associated with the property named
 153 `object<TT
 154 CLASS="PARAMETER"
 155 ><I
 156 >.  If `append</I
 157 ></TT
 158 > is FcTrue, the value is added at the end of any
 159 existing list, otherwise it is inserted at the beginning.  `value' is saved
 160 (with FcValueSave) when inserted into the pattern so that the library
 161 retains no reference to any application-supplied data structure.
 162             </P
 163 ></DIV
 164 ><DIV
 165 CLASS="NAVFOOTER"
 166 ><HR
 167 ALIGN="LEFT"
 168 WIDTH="100%"><TABLE
 169 SUMMARY="Footer navigation table"
 170 WIDTH="100%"
 171 BORDER="0"
 172 CELLPADDING="0"
 173 CELLSPACING="0"
 174 ><TR
 175 ><TD
 176 WIDTH="33%"
 177 ALIGN="left"
 178 VALIGN="top"
 179 ><A
 180 HREF="fcpatternhash.html"
 181 ACCESSKEY="P"
 182 >&#60;&#60;&#60; Previous</A
 183 ></TD
 184 ><TD
 185 WIDTH="34%"
 186 ALIGN="center"
 187 VALIGN="top"
 188 ><A
 189 HREF="t1.html"
 190 ACCESSKEY="H"
 191 >Home</A
 192 ></TD
 193 ><TD
 194 WIDTH="33%"
 195 ALIGN="right"
 196 VALIGN="top"
 197 ><A
 198 HREF="fcpatternaddweak.html"
 199 ACCESSKEY="N"
 200 >Next &#62;&#62;&#62;</A
 201 ></TD
 202 ></TR
 203 ><TR
 204 ><TD
 205 WIDTH="33%"
 206 ALIGN="left"
 207 VALIGN="top"
 208 >FcPatternHash</TD
 209 ><TD
 210 WIDTH="34%"
 211 ALIGN="center"
 212 VALIGN="top"
 213 ><A
 214 HREF="x102.html#AEN241"
 215 ACCESSKEY="U"
 216 >Up</A
 217 ></TD
 218 ><TD
 219 WIDTH="33%"
 220 ALIGN="right"
 221 VALIGN="top"
 222 >FcPatternAddWeak</TD
 223 ></TR
 224 ></TABLE
 225 ></DIV
 226 ></BODY
 227 ></HTML
 228 >