RubyGems - glib2 - Versions diffs - 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32 - Mend

glib2 1.2.5-x86-mingw32 → 1.2.6-x86-mingw32

Files changed (1752) hide show

data/vendor/local/share/gtk-doc/html/glib/glib-Thread-Pools.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-Threads.html" title="Threads">
 <link rel="next" href="glib-Asynchronous-Queues.html" title="Asynchronous Queues">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -640,6 +640,6 @@ thread</td>
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>

data/vendor/local/share/gtk-doc/html/glib/glib-Threads.html CHANGED Viewed

@@ -8,7 +8,7 @@
 <link rel="up" href="glib-core.html" title="GLib Core Application Support">
 <link rel="prev" href="glib-The-Main-Event-Loop.html" title="The Main Event Loop">
 <link rel="next" href="glib-Thread-Pools.html" title="Thread Pools">
-<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
+<meta name="generator" content="GTK-Doc V1.18.1 (XML mode)">
 <link rel="stylesheet" href="style.css" type="text/css">
 </head>
 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
@@ -135,6 +135,8 @@ enum                <a class="link" href="glib-Threads.html#GOnceStatus" title="
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);
 <span class="returnvalue">void</span>                <a class="link" href="glib-Threads.html#g-pointer-bit-unlock" title="g_pointer_bit_unlock ()">g_pointer_bit_unlock</a>                (<em class="parameter"><code>volatile <span class="type">void</span> *address</code></em>,
                                                          <em class="parameter"><code><a class="link" href="glib-Basic-Types.html#gint" title="gint"><span class="type">gint</span></a> lock_bit</code></em>);
+<a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>               <a class="link" href="glib-Threads.html#g-get-num-processors" title="g_get_num_processors ()">g_get_num_processors</a>                (<em class="parameter"><code><span class="type">void</span></code></em>);
 </pre>
 </div>
 <div class="refsect1">
@@ -228,7 +230,7 @@ you must coordinate accesses to the same <a class="link" href="glib-Hash-Tables.
 threads. The two notable exceptions from this rule are <a class="link" href="glib-The-Main-Event-Loop.html#GMainLoop" title="GMainLoop"><span class="type">GMainLoop</span></a>
 and <a class="link" href="glib-Asynchronous-Queues.html#GAsyncQueue" title="GAsyncQueue"><span class="type">GAsyncQueue</span></a>, which <span class="emphasis"><em>are</em></span> thread-safe and
 need no further application-level locking to be accessed from
-multiple threads. Most refcounting functions such as <a href="./../gobject/gobject/gobject-The-Base-Object-Type.html#g-object-ref"><code class="function">g_object_ref()</code></a>
+multiple threads. Most refcounting functions such as <code class="function">g_object_ref()</code>
 are also thread-safe.
 </p>
 </div>
@@ -605,7 +607,7 @@ access. Take for example the following function:
 <p>
 </p>
 <div class="example">
-<a name="idp15721888"></a><p class="title"><b>Example 2. A function which will not work in a threaded environment</b></p>
+<a name="id-1.4.3.5.14.5.1"></a><p class="title"><b>Example 2. A function which will not work in a threaded environment</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -623,17 +625,17 @@ access. Take for example the following function:
 11
 12</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
-<span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
+  give_me_next_number (<span class="type">void</span>)
+  {
+    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
-<span class="normal">  </span><span class="comment">/* now do a very complicated calculation to calculate the new</span>
-<span class="comment">   * number, this might for example be a random number generator</span>
-<span class="comment">   */</span>
-<span class="normal">  current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+    <span class="comment">/*</span><span class="comment"> now do a very complicated calculation to calculate the new</span>
+<span class="comment">     * number, this might for example be a random number generator</span>
+<span class="comment">     </span><span class="comment">*/</span>
+    current_number = calc_next_number (current_number);
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> current_number</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+    <span class="keyword">return</span> current_number;
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -650,7 +652,7 @@ access. A <a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><
 <p>
 </p>
 <div class="example">
-<a name="idp15726272"></a><p class="title"><b>Example 3. Using GMutex to protected a shared variable</b></p>
+<a name="id-1.4.3.5.14.7.1"></a><p class="title"><b>Example 3. Using GMutex to protected a shared variable</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -669,18 +671,18 @@ access. A <a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><
 12
 13</pre></td>
         <td class="listing_code"><pre class="programlisting"><span class="type">int</span>
-<span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GMutex</span><span class="normal"> mutex</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
-<span class="normal">  ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">mutex</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  give_me_next_number (<span class="type">void</span>)
+  {
+    <span class="type">static</span> <span class="type">GMutex</span> mutex;
+    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
+    <span class="type">int</span> ret_val;
+    <span class="preproc">g_mutex_lock</span> (&amp;mutex);
+    ret_val = current_number = calc_next_number (current_number);
+    <span class="preproc">g_mutex_unlock</span> (&amp;mutex);
+    <span class="keyword">return</span> ret_val;
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -731,15 +733,15 @@ statically allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GMutex</span><span class="normal"> m</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="symbol">...</span>
-<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
+    <span class="type">GMutex</span> m;
+    ...
+  } Blob;
-<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
+Blob *b;
-<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
-<span class="function"><a href="glib-Threads.html#g-mutex-init">g_mutex_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">m</span><span class="symbol">);</span></pre></td>
+b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
+g_mutex_init (&amp;b-&gt;m);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -911,7 +913,7 @@ of the variable you intend to protect with the lock. Look at our
 <p>
 </p>
 <div class="example">
-<a name="idp15828688"></a><p class="title"><b>Example 4. Using the <code class="literal">G_LOCK_*</code> convenience macros</b></p>
+<a name="id-1.4.3.5.20.5.1"></a><p class="title"><b>Example 4. Using the <code class="literal">G_LOCK_*</code> convenience macros</b></p>
 <div class="example-contents">
   <table class="listing_frame" border="0" cellpadding="0" cellspacing="0">
     <tbody>
@@ -930,20 +932,20 @@ of the variable you intend to protect with the lock. Look at our
 12
 13
 14</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="function"><a href="glib-Threads.html#G-LOCK-DEFINE:CAPS">G_LOCK_DEFINE</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+        <td class="listing_code"><pre class="programlisting"><span class="preproc">G_LOCK_DEFINE</span> (current_number);
-<span class="type">int</span>
-<span class="function">give_me_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="type">int</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="type">int</span><span class="normal"> ret_val</span><span class="symbol">;</span>
+  <span class="type">int</span>
+  give_me_next_number (<span class="type">void</span>)
+  {
+    <span class="type">static</span> <span class="type">int</span> current_number = <span class="number">0</span>;
+    <span class="type">int</span> ret_val;
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#G-LOCK:CAPS">G_LOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-<span class="normal">  ret_val </span><span class="symbol">=</span><span class="normal"> current_number </span><span class="symbol">=</span><span class="normal"> </span><span class="function">calc_next_number</span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#G-UNLOCK:CAPS">G_UNLOCK</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">current_number</span><span class="symbol">);</span>
+    <span class="preproc">G_LOCK</span> (current_number);
+    ret_val = current_number = calc_next_number (current_number);
+    <span class="preproc">G_UNLOCK</span> (current_number);
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> ret_val</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+    <span class="keyword">return</span> ret_val;
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1124,15 +1126,15 @@ statically allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GRecMutex</span><span class="normal"> m</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="symbol">...</span>
-<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
+    GRecMutex m;
+    ...
+  } Blob;
-<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
+Blob *b;
-<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
-<span class="function"><a href="glib-Threads.html#g-rec-mutex-init">g_rec_mutex_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">m</span><span class="symbol">);</span></pre></td>
+b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
+g_rec_mutex_init (&amp;b-&gt;m);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1294,7 +1296,7 @@ simultaneous read-only access (by holding the 'reader' lock via
 <p>
 </p>
 <div class="example">
-<a name="idp15977696"></a><p class="title"><b>Example 5. An array with access functions</b></p>
+<a name="id-1.4.3.5.32.6.1"></a><p class="title"><b>Example 5. An array with access functions</b></p>
 <div class="example-contents">
 <pre class="programlisting">
   GRWLock lock;
@@ -1383,15 +1385,15 @@ allocated.
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">typedef</span><span class="normal"> </span><span class="keyword">struct</span><span class="normal"> </span><span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">GRWLock</span><span class="normal"> l</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="symbol">...</span>
-<span class="cbracket">}</span><span class="normal"> Blob</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">typedef</span> <span class="type">struct</span> {
+    GRWLock l;
+    ...
+  } Blob;
-<span class="usertype">Blob</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">b</span><span class="symbol">;</span>
+Blob *b;
-<span class="normal">b </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Memory-Allocation.html#g-new">g_new</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">Blob</span><span class="symbol">,</span><span class="normal"> </span><span class="number">1</span><span class="symbol">);</span>
-<span class="function"><a href="glib-Threads.html#g-rw-lock-init">g_rw_lock_init</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">b</span><span class="symbol">-&gt;</span><span class="normal">l</span><span class="symbol">);</span></pre></td>
+b = <span class="preproc">g_new</span> (Blob, <span class="number">1</span>);
+g_rw_lock_init (&amp;b-&gt;l);</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1626,7 +1628,7 @@ threads to wake up to collect the data.
 <p>
 </p>
 <div class="example">
-<a name="idp19199984"></a><p class="title"><b>Example 6.
+<a name="id-1.4.3.5.41.6.1"></a><p class="title"><b>Example 6.
   Using GCond to block a thread until a condition is satisfied
  </b></p>
 <div class="example-contents">
@@ -1660,33 +1662,33 @@ threads to wake up to collect the data.
 25
 26
 27</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">gpointer</span><span class="normal"> current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="usertype">GMutex</span><span class="normal"> data_mutex</span><span class="symbol">;</span>
-<span class="usertype">GCond</span><span class="normal"> data_cond</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span> current_data = <span class="number">NULL</span>;
+  <span class="type">GMutex</span> data_mutex;
+  <span class="type">GCond</span> data_cond;
-<span class="type">void</span>
-<span class="function">push_data</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-cond-signal">g_cond_signal</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
-<span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
-<span class="function">pop_data</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_data</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="function"><a href="glib-Threads.html#g-cond-wait">g_cond_wait</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  data </span><span class="symbol">=</span><span class="normal"> current_data</span><span class="symbol">;</span>
-<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+  <span class="type">void</span>
+  push_data (<span class="type">gpointer</span> data)
+  {
+    <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
+    current_data = data;
+    <span class="preproc">g_cond_signal</span> (&amp;data_cond);
+    <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
+  }
+  <span class="type">gpointer</span>
+  pop_data (<span class="type">void</span>)
+  {
+    <span class="type">gpointer</span> data;
+    <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
+    <span class="keyword">while</span> (!current_data)
+      <span class="preproc">g_cond_wait</span> (&amp;data_cond, &amp;data_mutex);
+    data = current_data;
+    current_data = <span class="number">NULL</span>;
+    <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
+    <span class="keyword">return</span> data;
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -1794,6 +1796,8 @@ blocking leads to undefined behaviour.
                                                          <em class="parameter"><code><a class="link" href="glib-Threads.html#GMutex" title="union GMutex"><span class="type">GMutex</span></a> *mutex</code></em>);</pre>
 <p>
 Atomically releases <em class="parameter"><code>mutex</code></em> and waits until <em class="parameter"><code>cond</code></em> is signalled.
+When this function returns, <em class="parameter"><code>mutex</code></em> is locked again and owned by the
+calling thread.
 </p>
 <p>
 When using condition variables, it is possible that a spurious wakeup
@@ -1934,31 +1938,31 @@ documentation for <a class="link" href="glib-Threads.html#GCond" title="struct G
 23
 24
 25</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
-<span class="function">pop_data_timed</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="usertype">gint64</span><span class="normal"> end_time</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="usertype">gpointer</span><span class="normal"> data</span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-lock">g_mutex_lock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  end_time </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Date-and-Time-Functions.html#g-get-monotonic-time">g_get_monotonic_time</a></span><span class="normal"> </span><span class="symbol">()</span><span class="normal"> </span><span class="symbol">+</span><span class="normal"> </span><span class="number">5</span><span class="normal"> </span><span class="symbol">*</span><span class="normal"> <a href="glib-GDateTime.html#G-TIME-SPAN-SECOND:CAPS">G_TIME_SPAN_SECOND</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="keyword">while</span><span class="normal"> </span><span class="symbol">(!</span><span class="normal">current_data</span><span class="symbol">)</span>
-<span class="normal">    </span><span class="keyword">if</span><span class="normal"> </span><span class="symbol">(!</span><span class="function"><a href="glib-Threads.html#g-cond-wait-until">g_cond_wait_until</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_cond</span><span class="symbol">,</span><span class="normal"> </span><span class="symbol">&amp;</span><span class="normal">data_mutex</span><span class="symbol">,</span><span class="normal"> end_time</span><span class="symbol">))</span>
-<span class="normal">      </span><span class="cbracket">{</span>
-<span class="normal">        </span><span class="comment">// timeout has passed.</span>
-<span class="normal">        </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">        </span><span class="keyword">return</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="normal">      </span><span class="cbracket">}</span>
-<span class="normal">  </span><span class="comment">// there is data for us</span>
-<span class="normal">  data </span><span class="symbol">=</span><span class="normal"> current_data</span><span class="symbol">;</span>
-<span class="normal">  current_data </span><span class="symbol">=</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">;</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-mutex-unlock">g_mutex_unlock</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">data_mutex</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> data</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span>
+pop_data_timed (<span class="type">void</span>)
+{
+  <span class="type">gint64</span> end_time;
+  <span class="type">gpointer</span> data;
+  <span class="preproc">g_mutex_lock</span> (&amp;data_mutex);
+  end_time = <span class="function"><a href="glib-Date-and-Time-Functions.html#g-get-monotonic-time">g_get_monotonic_time</a></span> () + <span class="number">5</span> * <span class="number">G_TIME_SPAN_SECOND</span>;
+  <span class="keyword">while</span> (!current_data)
+    <span class="keyword">if</span> (!g_cond_wait_until (&amp;data_cond, &amp;data_mutex, end_time))
+      {
+        <span class="comment">// timeout has passed.</span>
+        <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
+        <span class="keyword">return</span> <span class="number">NULL</span>;
+      }
+  <span class="comment">// there is data for us</span>
+  data = current_data;
+  current_data = <span class="number">NULL</span>;
+  <span class="preproc">g_mutex_unlock</span> (&amp;data_mutex);
+  <span class="keyword">return</span> data;
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -2135,35 +2139,35 @@ examples below.
 27
 28
 29</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GPrivate</span><span class="normal"> name_key </span><span class="symbol">=</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#G-PRIVATE-INIT:CAPS">G_PRIVATE_INIT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span><span class="symbol">);</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">GPrivate</span> name_key = G_PRIVATE_INIT (<span class="function"><a href="glib-Memory-Allocation.html#g-free">g_free</a></span>);
 <span class="comment">// return value should not be freed</span>
-<span class="keyword">const</span><span class="normal"> <a href="glib-Basic-Types.html#gchar">gchar</a> </span><span class="symbol">*</span>
-<span class="function">get_local_name</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Threads.html#g-private-get">g_private_get</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">name_key</span><span class="symbol">);</span>
-<span class="cbracket">}</span>
+<span class="type">const</span> <span class="type">gchar</span> *
+get_local_name (<span class="type">void</span>)
+{
+  <span class="keyword">return</span> <span class="preproc">g_private_get</span> (&amp;name_key);
+}
 <span class="type">void</span>
-<span class="function">set_local_name</span><span class="normal"> </span><span class="symbol">(</span><span class="keyword">const</span><span class="normal"> </span><span class="usertype">gchar</span><span class="normal"> </span><span class="symbol">*</span><span class="normal">name</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-private-replace">g_private_replace</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">name_key</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">name</span><span class="symbol">));</span>
-<span class="cbracket">}</span>
+set_local_name (<span class="type">const</span> <span class="type">gchar</span> *name)
+{
+  g_private_replace (&amp;name_key, <span class="function"><a href="glib-String-Utility-Functions.html#g-strdup">g_strdup</a></span> (name));
+}
-<span class="keyword">static</span><span class="normal"> </span><span class="usertype">GPrivate</span><span class="normal"> count_key</span><span class="symbol">;</span><span class="normal">   </span><span class="comment">// no free function</span>
+<span class="type">static</span> <span class="type">GPrivate</span> count_key;   <span class="comment">// no free function</span>
-<span class="normal"><a href="glib-Basic-Types.html#gint">gint</a></span>
-<span class="function">get_local_count</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> </span><span class="function"><a href="glib-Type-Conversion-Macros.html#GPOINTER-TO-INT:CAPS">GPOINTER_TO_INT</a></span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Threads.html#g-private-get">g_private_get</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">count_key</span><span class="symbol">));</span>
-<span class="cbracket">}</span>
+<span class="type">gint</span>
+get_local_count (<span class="type">void</span>)
+{
+  <span class="keyword">return</span> <span class="preproc">GPOINTER_TO_INT</span> (<span class="preproc">g_private_get</span> (&amp;count_key));
+}
 <span class="type">void</span>
-<span class="function">set_local_count</span><span class="normal"> </span><span class="symbol">(</span><span class="usertype">gint</span><span class="normal"> count</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-private-set">g_private_set</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">count_key</span><span class="symbol">,</span><span class="normal"> </span><span class="function"><a href="glib-Type-Conversion-Macros.html#GINT-TO-POINTER:CAPS">GINT_TO_POINTER</a></span><span class="normal"> </span><span class="symbol">(</span><span class="normal">count</span><span class="symbol">));</span>
-<span class="cbracket">}</span></pre></td>
+set_local_count (<span class="type">gint</span> count)
+{
+  <span class="preproc">g_private_set</span> (&amp;count_key, <span class="preproc">GINT_TO_POINTER</span> (count));
+}</pre></td>
       </tr>
     </tbody>
   </table>
@@ -2365,7 +2369,7 @@ A <a class="link" href="glib-Threads.html#GOnce" title="struct GOnce"><span clas
     <tbody>
       <tr>
         <td class="listing_lines" align="right"><pre>1</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span></pre></td>
+        <td class="listing_code"><pre class="programlisting"><span class="type">GOnce</span> my_once = <span class="number">G_ONCE_INIT</span>;</pre></td>
       </tr>
     </tbody>
   </table>
@@ -2410,15 +2414,15 @@ Calling <a class="link" href="glib-Threads.html#g-once" title="g_once()"><code c
 7
 8
 9</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="normal"><a href="glib-Basic-Types.html#gpointer">gpointer</a></span>
-<span class="function">get_debug_flags</span><span class="normal"> </span><span class="symbol">(</span><span class="type">void</span><span class="symbol">)</span>
-<span class="cbracket">{</span>
-<span class="normal">  </span><span class="keyword">static</span><span class="normal"> </span><span class="usertype">GOnce</span><span class="normal"> my_once </span><span class="symbol">=</span><span class="normal"> <a href="glib-Threads.html#G-ONCE-INIT:CAPS">G_ONCE_INIT</a></span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">gpointer</span>
+  get_debug_flags (<span class="type">void</span>)
+  {
+    <span class="type">static</span> <span class="type">GOnce</span> my_once = <span class="number">G_ONCE_INIT</span>;
-<span class="normal">  </span><span class="function"><a href="glib-Threads.html#g-once">g_once</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">my_once</span><span class="symbol">,</span><span class="normal"> parse_debug_flags</span><span class="symbol">,</span><span class="normal"> <a href="glib-Standard-Macros.html#NULL:CAPS">NULL</a></span><span class="symbol">);</span>
+    <span class="preproc">g_once</span> (&amp;my_once, parse_debug_flags, <span class="number">NULL</span>);
-<span class="normal">  </span><span class="keyword">return</span><span class="normal"> my_once</span><span class="symbol">.</span><span class="normal">retval</span><span class="symbol">;</span>
-<span class="cbracket">}</span></pre></td>
+    <span class="keyword">return</span> my_once.retval;
+  }</pre></td>
       </tr>
     </tbody>
   </table>
@@ -2482,16 +2486,16 @@ like this:
 8
 9
 10</pre></td>
-        <td class="listing_code"><pre class="programlisting"><span class="keyword">static</span><span class="normal"> </span><span class="usertype">gsize</span><span class="normal"> initialization_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">0</span><span class="symbol">;</span>
+        <td class="listing_code"><pre class="programlisting"><span class="type">static</span> <span class="type">gsize</span> initialization_value = <span class="number">0</span>;
-<span class="keyword">if</span><span class="normal"> </span><span class="symbol">(</span><span class="function"><a href="glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">))</span>
-<span class="normal">  </span><span class="cbracket">{</span>
-<span class="normal">    </span><span class="usertype">gsize</span><span class="normal"> setup_value </span><span class="symbol">=</span><span class="normal"> </span><span class="number">42</span><span class="symbol">;</span><span class="normal"> </span><span class="comment">/** initialization code here **/</span>
+  <span class="keyword">if</span> (<span class="function"><a href="glib-Threads.html#g-once-init-enter">g_once_init_enter</a></span> (&amp;initialization_value))
+    {
+      <span class="type">gsize</span> setup_value = <span class="number">42</span>; <span class="comment">/*</span><span class="comment">* initialization code here *</span><span class="comment">*/</span>
-<span class="normal">    </span><span class="function"><a href="glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span><span class="normal"> </span><span class="symbol">(&amp;</span><span class="normal">initialization_value</span><span class="symbol">,</span><span class="normal"> setup_value</span><span class="symbol">);</span>
-<span class="normal">  </span><span class="cbracket">}</span>
+      <span class="function"><a href="glib-Threads.html#g-once-init-leave">g_once_init_leave</a></span> (&amp;initialization_value, setup_value);
+    }
-<span class="comment">/** use initialization_value here **/</span></pre></td>
+  <span class="comment">/*</span><span class="comment">* use initialization_value here *</span><span class="comment">*/</span></pre></td>
       </tr>
     </tbody>
   </table>
@@ -2767,6 +2771,28 @@ the pointer.
 </table></div>
 <p class="since">Since 2.30</p>
 </div>
+<hr>
+<div class="refsect2">
+<a name="g-get-num-processors"></a><h3>g_get_num_processors ()</h3>
+<pre class="programlisting"><a class="link" href="glib-Basic-Types.html#guint" title="guint"><span class="returnvalue">guint</span></a>               g_get_num_processors                (<em class="parameter"><code><span class="type">void</span></code></em>);</pre>
+<p>
+Determine the approximate number of threads that the system will
+schedule simultaneously for this process.  This is intended to be
+used as a parameter to <a class="link" href="glib-Thread-Pools.html#g-thread-pool-new" title="g_thread_pool_new ()"><code class="function">g_thread_pool_new()</code></a> for CPU bound tasks and
+similar cases.
+</p>
+<div class="variablelist"><table border="0" class="variablelist">
+<colgroup>
+<col align="left" valign="top">
+<col>
+</colgroup>
+<tbody><tr>
+<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
+<td>Number of schedulable threads, always greater than 0</td>
+</tr></tbody>
+</table></div>
+<p class="since">Since 2.36</p>
+</div>
 </div>
 <div class="refsect1">
 <a name="glib-Threads.see-also"></a><h2>See Also</h2>
@@ -2775,6 +2801,6 @@ the pointer.
 </div>
 <div class="footer">
 <hr>
-          Generated by GTK-Doc V1.18</div>
+          Generated by GTK-Doc V1.18.1</div>
 </body>
 </html>