|
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