fcatomiccreate.html revision a32e9e42
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>FcAtomicCreate</TITLE 6><META 7NAME="GENERATOR" 8CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK 9REL="HOME" 10HREF="t1.html"><LINK 11REL="UP" 12TITLE="FcAtomic" 13HREF="x103.html#AEN4178"><LINK 14REL="PREVIOUS" 15TITLE="FUNCTIONS" 16HREF="x103.html"><LINK 17REL="NEXT" 18TITLE="FcAtomicLock" 19HREF="fcatomiclock.html"></HEAD 20><BODY 21CLASS="REFENTRY" 22BGCOLOR="#FFFFFF" 23TEXT="#000000" 24LINK="#0000FF" 25VLINK="#840084" 26ALINK="#0000FF" 27><DIV 28CLASS="NAVHEADER" 29><TABLE 30SUMMARY="Header navigation table" 31WIDTH="100%" 32BORDER="0" 33CELLPADDING="0" 34CELLSPACING="0" 35><TR 36><TH 37COLSPAN="3" 38ALIGN="center" 39></TH 40></TR 41><TR 42><TD 43WIDTH="10%" 44ALIGN="left" 45VALIGN="bottom" 46><A 47HREF="x103.html" 48ACCESSKEY="P" 49><<< Previous</A 50></TD 51><TD 52WIDTH="80%" 53ALIGN="center" 54VALIGN="bottom" 55></TD 56><TD 57WIDTH="10%" 58ALIGN="right" 59VALIGN="bottom" 60><A 61HREF="fcatomiclock.html" 62ACCESSKEY="N" 63>Next >>></A 64></TD 65></TR 66></TABLE 67><HR 68ALIGN="LEFT" 69WIDTH="100%"></DIV 70><H1 71><A 72NAME="FCATOMICCREATE" 73></A 74>FcAtomicCreate</H1 75><DIV 76CLASS="REFNAMEDIV" 77><A 78NAME="AEN4186" 79></A 80><H2 81>Name</H2 82>FcAtomicCreate -- create an FcAtomic object</DIV 83><DIV 84CLASS="REFSYNOPSISDIV" 85><A 86NAME="AEN4189" 87></A 88><H2 89>Synopsis</H2 90><DIV 91CLASS="FUNCSYNOPSIS" 92><P 93></P 94><A 95NAME="AEN4190" 96></A 97><TABLE 98BORDER="0" 99BGCOLOR="#E0E0E0" 100WIDTH="100%" 101><TR 102><TD 103><PRE 104CLASS="FUNCSYNOPSISINFO" 105>#include <fontconfig/fontconfig.h> 106 </PRE 107></TD 108></TR 109></TABLE 110><P 111><CODE 112><CODE 113CLASS="FUNCDEF" 114>FcAtomic * <TT 115CLASS="FUNCTION" 116>FcAtomicCreate</TT 117></CODE 118>(const FcChar8 *<TT 119CLASS="PARAMETER" 120><I 121>file</I 122></TT 123>);</CODE 124></P 125><P 126></P 127></DIV 128></DIV 129><DIV 130CLASS="REFSECT1" 131><A 132NAME="AEN4197" 133></A 134><H2 135>Description</H2 136><P 137>Creates a data structure containing data needed to control access to <TT 138CLASS="PARAMETER" 139><I 140>file</I 141></TT 142>. 143Writing is done to a separate file. Once that file is complete, the original 144configuration file is atomically replaced so that reading process always see 145a consistent and complete file without the need to lock for reading. 146 </P 147></DIV 148><DIV 149CLASS="NAVFOOTER" 150><HR 151ALIGN="LEFT" 152WIDTH="100%"><TABLE 153SUMMARY="Footer navigation table" 154WIDTH="100%" 155BORDER="0" 156CELLPADDING="0" 157CELLSPACING="0" 158><TR 159><TD 160WIDTH="33%" 161ALIGN="left" 162VALIGN="top" 163><A 164HREF="x103.html" 165ACCESSKEY="P" 166><<< Previous</A 167></TD 168><TD 169WIDTH="34%" 170ALIGN="center" 171VALIGN="top" 172><A 173HREF="t1.html" 174ACCESSKEY="H" 175>Home</A 176></TD 177><TD 178WIDTH="33%" 179ALIGN="right" 180VALIGN="top" 181><A 182HREF="fcatomiclock.html" 183ACCESSKEY="N" 184>Next >>></A 185></TD 186></TR 187><TR 188><TD 189WIDTH="33%" 190ALIGN="left" 191VALIGN="top" 192>FUNCTIONS</TD 193><TD 194WIDTH="34%" 195ALIGN="center" 196VALIGN="top" 197><A 198HREF="x103.html#AEN4178" 199ACCESSKEY="U" 200>Up</A 201></TD 202><TD 203WIDTH="33%" 204ALIGN="right" 205VALIGN="top" 206>FcAtomicLock</TD 207></TR 208></TABLE 209></DIV 210></BODY 211></HTML 212>