|
1 | 1 | <?xml version="1.0" encoding="utf-8"?>
|
2 | 2 | <!-- $Revision$ -->
|
3 |
| -<!-- EN-Revision: e9366ee458b2900c53a503b1ad97664e1d9a8859 Maintainer: mumumu Status: ready --> |
| 3 | +<!-- EN-Revision: 080a00e2014fbf36c8bd7fff91ed97f7ba636949 Maintainer: mumumu Status: ready --> |
4 | 4 | <refentry xml:id="function.apcu-entry" xmlns="http://docbook.org/ns/docbook">
|
5 | 5 | <refnamediv>
|
6 | 6 | <refname>apcu_entry</refname>
|
|
13 | 13 | <methodsynopsis>
|
14 | 14 | <type>mixed</type><methodname>apcu_entry</methodname>
|
15 | 15 | <methodparam><type>string</type><parameter>key</parameter></methodparam>
|
16 |
| - <methodparam><type>callable</type><parameter>generator</parameter></methodparam> |
| 16 | + <methodparam><type>callable</type><parameter>callback</parameter></methodparam> |
17 | 17 | <methodparam choice="opt"><type>int</type><parameter>ttl</parameter><initializer>0</initializer></methodparam>
|
18 | 18 | </methodsynopsis>
|
19 | 19 | <para>
|
20 | 20 | キャッシュに <parameter>key</parameter> が存在するかをアトミックに検索します。
|
21 |
| - 存在しなければ <parameter>generator</parameter> が呼び出され、 |
| 21 | + 存在しなければ <parameter>callback</parameter> が呼び出され、 |
22 | 22 | <parameter>key</parameter> が唯一の引数として渡されます。
|
23 |
| - <parameter>generator</parameter> ではオプションで指定する <parameter>ttl</parameter> の間だけ値をキャッシュし、 |
| 23 | + <parameter>callback</parameter> ではオプションで指定する <parameter>ttl</parameter> の間だけ値をキャッシュし、 |
24 | 24 | キャッシュした値が返されます。
|
25 | 25 | </para>
|
26 | 26 | <note>
|
27 | 27 | <simpara>
|
28 | 28 | <function>apcu_entry</function> 関数に制御が移ると、
|
29 | 29 | キャッシュのロックを排他的に取得します。
|
30 | 30 | このロックは <function>apcu_entry</function> の実行が終わったときに開放されます:
|
31 |
| - この結果、<parameter>generator</parameter> はクリティカルセクションに入るため、 |
| 31 | + この結果、<parameter>callback</parameter> はクリティカルセクションに入るため、 |
32 | 32 | ふたつのプロセスが同時に同じコードパスを実行することができなくなります。
|
33 | 33 | さらに、他のAPCuのあらゆる関数も同時に並列に実行できなくなります。
|
34 | 34 | なぜなら、同じロックを共有しているからです。
|
35 | 35 | </simpara>
|
36 | 36 | </note>
|
37 | 37 | <warning>
|
38 | 38 | <simpara>
|
39 |
| - <parameter>generator</parameter> から安全に呼び出せるAPCuの関数は <function>apcu_entry</function> だけです。 |
| 39 | + <parameter>callback</parameter> から安全に呼び出せるAPCuの関数は <function>apcu_entry</function> だけです。 |
40 | 40 | </simpara>
|
41 | 41 | </warning>
|
42 | 42 | </refsect1>
|
|
53 | 53 | </listitem>
|
54 | 54 | </varlistentry>
|
55 | 55 | <varlistentry>
|
56 |
| - <term><parameter>generator</parameter></term> |
| 56 | + <term><parameter>callback</parameter></term> |
57 | 57 | <listitem>
|
58 | 58 | <para>
|
59 | 59 | <parameter>key</parameter> を唯一の引数として取り、
|
|
0 commit comments