8
8
msgstr ""
9
9
"Project-Id-Version : Python 3.12\n "
10
10
"Report-Msgid-Bugs-To : \n "
11
- "POT-Creation-Date : 2023-08-01 00:03+0000\n "
11
+ "POT-Creation-Date : 2023-12-06 00:03+0000\n "
12
12
"PO-Revision-Date : 2023-04-24 20:49+0800\n "
13
13
"Last-Translator : Adrian Liaw <adrianliaw2000@gmail.com>\n "
14
14
"Language-Team : Chinese - TAIWAN (https://github.com/python/python-docs-zh- "
@@ -2197,43 +2197,43 @@ msgstr ""
2197
2197
msgid ""
2198
2198
"The value passed as the *what* parameter to a :c:type:`Py_tracefunc` "
2199
2199
"function (but not a profiling function) when a line-number event is being "
2200
- "reported. It may be disabled for a frame by setting :attr:`f_trace_lines` to "
2201
- "*0* on that frame."
2200
+ "reported. It may be disabled for a frame by setting :attr:`~frame. "
2201
+ "f_trace_lines` to *0* on that frame."
2202
2202
msgstr ""
2203
2203
2204
- #: ../../c-api/init.rst:1917
2204
+ #: ../../c-api/init.rst:1918
2205
2205
msgid ""
2206
2206
"The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
2207
2207
"a call is about to return."
2208
2208
msgstr ""
2209
2209
2210
- #: ../../c-api/init.rst:1923
2210
+ #: ../../c-api/init.rst:1924
2211
2211
msgid ""
2212
2212
"The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
2213
2213
"a C function is about to be called."
2214
2214
msgstr ""
2215
2215
2216
- #: ../../c-api/init.rst:1929
2216
+ #: ../../c-api/init.rst:1930
2217
2217
msgid ""
2218
2218
"The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
2219
2219
"a C function has raised an exception."
2220
2220
msgstr ""
2221
2221
2222
- #: ../../c-api/init.rst:1935
2222
+ #: ../../c-api/init.rst:1936
2223
2223
msgid ""
2224
2224
"The value for the *what* parameter to :c:type:`Py_tracefunc` functions when "
2225
2225
"a C function has returned."
2226
2226
msgstr ""
2227
2227
2228
- #: ../../c-api/init.rst:1941
2228
+ #: ../../c-api/init.rst:1942
2229
2229
msgid ""
2230
2230
"The value for the *what* parameter to :c:type:`Py_tracefunc` functions (but "
2231
2231
"not profiling functions) when a new opcode is about to be executed. This "
2232
2232
"event is not emitted by default: it must be explicitly requested by setting :"
2233
- "attr:`f_trace_opcodes` to *1* on the frame."
2233
+ "attr:`~frame. f_trace_opcodes` to *1* on the frame."
2234
2234
msgstr ""
2235
2235
2236
- #: ../../c-api/init.rst:1949
2236
+ #: ../../c-api/init.rst:1950
2237
2237
msgid ""
2238
2238
"Set the profiler function to *func*. The *obj* parameter is passed to the "
2239
2239
"function as its first parameter, and may be any Python object, or ``NULL``. "
@@ -2243,29 +2243,29 @@ msgid ""
2243
2243
"`PyTrace_LINE` :c:data:`PyTrace_OPCODE` and :c:data:`PyTrace_EXCEPTION`."
2244
2244
msgstr ""
2245
2245
2246
- #: ../../c-api/init.rst:1956
2246
+ #: ../../c-api/init.rst:1957
2247
2247
msgid "See also the :func:`sys.setprofile` function."
2248
2248
msgstr ""
2249
2249
2250
- #: ../../c-api/init.rst:1958 ../../c-api/init.rst:1965
2251
- #: ../../c-api/init.rst:1984 ../../c-api/init.rst:1991
2250
+ #: ../../c-api/init.rst:1959 ../../c-api/init.rst:1966
2251
+ #: ../../c-api/init.rst:1985 ../../c-api/init.rst:1992
2252
2252
msgid "The caller must hold the :term:`GIL`."
2253
2253
msgstr "呼叫者必須持有 :term:`GIL`。"
2254
2254
2255
- #: ../../c-api/init.rst:1962
2255
+ #: ../../c-api/init.rst:1963
2256
2256
msgid ""
2257
2257
"Like :c:func:`PyEval_SetProfile` but sets the profile function in all "
2258
2258
"running threads belonging to the current interpreter instead of the setting "
2259
2259
"it only on the current thread."
2260
2260
msgstr ""
2261
2261
2262
- #: ../../c-api/init.rst:1967
2262
+ #: ../../c-api/init.rst:1968
2263
2263
msgid ""
2264
2264
"As :c:func:`PyEval_SetProfile`, this function ignores any exceptions raised "
2265
2265
"while setting the profile functions in all threads."
2266
2266
msgstr ""
2267
2267
2268
- #: ../../c-api/init.rst:1975
2268
+ #: ../../c-api/init.rst:1976
2269
2269
msgid ""
2270
2270
"Set the tracing function to *func*. This is similar to :c:func:"
2271
2271
"`PyEval_SetProfile`, except the tracing function does receive line-number "
@@ -2276,65 +2276,65 @@ msgid ""
2276
2276
"*what* parameter."
2277
2277
msgstr ""
2278
2278
2279
- #: ../../c-api/init.rst:1982
2279
+ #: ../../c-api/init.rst:1983
2280
2280
msgid "See also the :func:`sys.settrace` function."
2281
2281
msgstr "也請見 :func:`sys.settrace` 函式。"
2282
2282
2283
- #: ../../c-api/init.rst:1988
2283
+ #: ../../c-api/init.rst:1989
2284
2284
msgid ""
2285
2285
"Like :c:func:`PyEval_SetTrace` but sets the tracing function in all running "
2286
2286
"threads belonging to the current interpreter instead of the setting it only "
2287
2287
"on the current thread."
2288
2288
msgstr ""
2289
2289
2290
- #: ../../c-api/init.rst:1993
2290
+ #: ../../c-api/init.rst:1994
2291
2291
msgid ""
2292
2292
"As :c:func:`PyEval_SetTrace`, this function ignores any exceptions raised "
2293
2293
"while setting the trace functions in all threads."
2294
2294
msgstr ""
2295
2295
2296
- #: ../../c-api/init.rst:2002
2296
+ #: ../../c-api/init.rst:2003
2297
2297
msgid "Advanced Debugger Support"
2298
2298
msgstr ""
2299
2299
2300
- #: ../../c-api/init.rst:2007
2300
+ #: ../../c-api/init.rst:2008
2301
2301
msgid ""
2302
2302
"These functions are only intended to be used by advanced debugging tools."
2303
2303
msgstr ""
2304
2304
2305
- #: ../../c-api/init.rst:2012
2305
+ #: ../../c-api/init.rst:2013
2306
2306
msgid ""
2307
2307
"Return the interpreter state object at the head of the list of all such "
2308
2308
"objects."
2309
2309
msgstr ""
2310
2310
2311
- #: ../../c-api/init.rst:2017
2311
+ #: ../../c-api/init.rst:2018
2312
2312
msgid "Return the main interpreter state object."
2313
2313
msgstr ""
2314
2314
2315
- #: ../../c-api/init.rst:2022
2315
+ #: ../../c-api/init.rst:2023
2316
2316
msgid ""
2317
2317
"Return the next interpreter state object after *interp* from the list of all "
2318
2318
"such objects."
2319
2319
msgstr ""
2320
2320
2321
- #: ../../c-api/init.rst:2028
2321
+ #: ../../c-api/init.rst:2029
2322
2322
msgid ""
2323
2323
"Return the pointer to the first :c:type:`PyThreadState` object in the list "
2324
2324
"of threads associated with the interpreter *interp*."
2325
2325
msgstr ""
2326
2326
2327
- #: ../../c-api/init.rst:2034
2327
+ #: ../../c-api/init.rst:2035
2328
2328
msgid ""
2329
2329
"Return the next thread state object after *tstate* from the list of all such "
2330
2330
"objects belonging to the same :c:type:`PyInterpreterState` object."
2331
2331
msgstr ""
2332
2332
2333
- #: ../../c-api/init.rst:2041
2333
+ #: ../../c-api/init.rst:2042
2334
2334
msgid "Thread Local Storage Support"
2335
2335
msgstr ""
2336
2336
2337
- #: ../../c-api/init.rst:2045
2337
+ #: ../../c-api/init.rst:2046
2338
2338
msgid ""
2339
2339
"The Python interpreter provides low-level support for thread-local storage "
2340
2340
"(TLS) which wraps the underlying native TLS implementation to support the "
@@ -2344,109 +2344,109 @@ msgid ""
2344
2344
"thread."
2345
2345
msgstr ""
2346
2346
2347
- #: ../../c-api/init.rst:2052
2347
+ #: ../../c-api/init.rst:2053
2348
2348
msgid ""
2349
2349
"The GIL does *not* need to be held when calling these functions; they supply "
2350
2350
"their own locking."
2351
2351
msgstr ""
2352
2352
2353
- #: ../../c-api/init.rst:2055
2353
+ #: ../../c-api/init.rst:2056
2354
2354
msgid ""
2355
2355
"Note that :file:`Python.h` does not include the declaration of the TLS APIs, "
2356
2356
"you need to include :file:`pythread.h` to use thread-local storage."
2357
2357
msgstr ""
2358
2358
2359
- #: ../../c-api/init.rst:2059
2359
+ #: ../../c-api/init.rst:2060
2360
2360
msgid ""
2361
2361
"None of these API functions handle memory management on behalf of the :c:"
2362
2362
"expr:`void*` values. You need to allocate and deallocate them yourself. If "
2363
2363
"the :c:expr:`void*` values happen to be :c:expr:`PyObject*`, these functions "
2364
2364
"don't do refcount operations on them either."
2365
2365
msgstr ""
2366
2366
2367
- #: ../../c-api/init.rst:2067
2367
+ #: ../../c-api/init.rst:2068
2368
2368
msgid "Thread Specific Storage (TSS) API"
2369
2369
msgstr ""
2370
2370
2371
- #: ../../c-api/init.rst:2069
2371
+ #: ../../c-api/init.rst:2070
2372
2372
msgid ""
2373
2373
"TSS API is introduced to supersede the use of the existing TLS API within "
2374
2374
"the CPython interpreter. This API uses a new type :c:type:`Py_tss_t` "
2375
2375
"instead of :c:expr:`int` to represent thread keys."
2376
2376
msgstr ""
2377
2377
2378
- #: ../../c-api/init.rst:2075
2378
+ #: ../../c-api/init.rst:2076
2379
2379
msgid "\" A New C-API for Thread-Local Storage in CPython\" (:pep:`539`)"
2380
2380
msgstr ""
2381
2381
2382
- #: ../../c-api/init.rst:2080
2382
+ #: ../../c-api/init.rst:2081
2383
2383
msgid ""
2384
2384
"This data structure represents the state of a thread key, the definition of "
2385
2385
"which may depend on the underlying TLS implementation, and it has an "
2386
2386
"internal field representing the key's initialization state. There are no "
2387
2387
"public members in this structure."
2388
2388
msgstr ""
2389
2389
2390
- #: ../../c-api/init.rst:2085
2390
+ #: ../../c-api/init.rst:2086
2391
2391
msgid ""
2392
2392
"When :ref:`Py_LIMITED_API <stable>` is not defined, static allocation of "
2393
2393
"this type by :c:macro:`Py_tss_NEEDS_INIT` is allowed."
2394
2394
msgstr ""
2395
2395
2396
- #: ../../c-api/init.rst:2091
2396
+ #: ../../c-api/init.rst:2092
2397
2397
msgid ""
2398
2398
"This macro expands to the initializer for :c:type:`Py_tss_t` variables. Note "
2399
2399
"that this macro won't be defined with :ref:`Py_LIMITED_API <stable>`."
2400
2400
msgstr ""
2401
2401
2402
- #: ../../c-api/init.rst:2096
2402
+ #: ../../c-api/init.rst:2097
2403
2403
msgid "Dynamic Allocation"
2404
2404
msgstr ""
2405
2405
2406
- #: ../../c-api/init.rst:2098
2406
+ #: ../../c-api/init.rst:2099
2407
2407
msgid ""
2408
2408
"Dynamic allocation of the :c:type:`Py_tss_t`, required in extension modules "
2409
2409
"built with :ref:`Py_LIMITED_API <stable>`, where static allocation of this "
2410
2410
"type is not possible due to its implementation being opaque at build time."
2411
2411
msgstr ""
2412
2412
2413
- #: ../../c-api/init.rst:2105
2413
+ #: ../../c-api/init.rst:2106
2414
2414
msgid ""
2415
2415
"Return a value which is the same state as a value initialized with :c:macro:"
2416
2416
"`Py_tss_NEEDS_INIT`, or ``NULL`` in the case of dynamic allocation failure."
2417
2417
msgstr ""
2418
2418
2419
- #: ../../c-api/init.rst:2112
2419
+ #: ../../c-api/init.rst:2113
2420
2420
msgid ""
2421
2421
"Free the given *key* allocated by :c:func:`PyThread_tss_alloc`, after first "
2422
2422
"calling :c:func:`PyThread_tss_delete` to ensure any associated thread locals "
2423
2423
"have been unassigned. This is a no-op if the *key* argument is ``NULL``."
2424
2424
msgstr ""
2425
2425
2426
- #: ../../c-api/init.rst:2118
2426
+ #: ../../c-api/init.rst:2119
2427
2427
msgid ""
2428
2428
"A freed key becomes a dangling pointer. You should reset the key to ``NULL``."
2429
2429
msgstr ""
2430
2430
2431
- #: ../../c-api/init.rst:2123
2431
+ #: ../../c-api/init.rst:2124
2432
2432
msgid "Methods"
2433
2433
msgstr "方法"
2434
2434
2435
- #: ../../c-api/init.rst:2125
2435
+ #: ../../c-api/init.rst:2126
2436
2436
msgid ""
2437
2437
"The parameter *key* of these functions must not be ``NULL``. Moreover, the "
2438
2438
"behaviors of :c:func:`PyThread_tss_set` and :c:func:`PyThread_tss_get` are "
2439
2439
"undefined if the given :c:type:`Py_tss_t` has not been initialized by :c:"
2440
2440
"func:`PyThread_tss_create`."
2441
2441
msgstr ""
2442
2442
2443
- #: ../../c-api/init.rst:2133
2443
+ #: ../../c-api/init.rst:2134
2444
2444
msgid ""
2445
2445
"Return a non-zero value if the given :c:type:`Py_tss_t` has been initialized "
2446
2446
"by :c:func:`PyThread_tss_create`."
2447
2447
msgstr ""
2448
2448
2449
- #: ../../c-api/init.rst:2139
2449
+ #: ../../c-api/init.rst:2140
2450
2450
msgid ""
2451
2451
"Return a zero value on successful initialization of a TSS key. The behavior "
2452
2452
"is undefined if the value pointed to by the *key* argument is not "
@@ -2455,7 +2455,7 @@ msgid ""
2455
2455
"no-op and immediately returns success."
2456
2456
msgstr ""
2457
2457
2458
- #: ../../c-api/init.rst:2148
2458
+ #: ../../c-api/init.rst:2149
2459
2459
msgid ""
2460
2460
"Destroy a TSS key to forget the values associated with the key across all "
2461
2461
"threads, and change the key's initialization state to uninitialized. A "
@@ -2464,31 +2464,31 @@ msgid ""
2464
2464
"key -- calling it on an already destroyed key is a no-op."
2465
2465
msgstr ""
2466
2466
2467
- #: ../../c-api/init.rst:2157
2467
+ #: ../../c-api/init.rst:2158
2468
2468
msgid ""
2469
2469
"Return a zero value to indicate successfully associating a :c:expr:`void*` "
2470
2470
"value with a TSS key in the current thread. Each thread has a distinct "
2471
2471
"mapping of the key to a :c:expr:`void*` value."
2472
2472
msgstr ""
2473
2473
2474
- #: ../../c-api/init.rst:2164
2474
+ #: ../../c-api/init.rst:2165
2475
2475
msgid ""
2476
2476
"Return the :c:expr:`void*` value associated with a TSS key in the current "
2477
2477
"thread. This returns ``NULL`` if no value is associated with the key in the "
2478
2478
"current thread."
2479
2479
msgstr ""
2480
2480
2481
- #: ../../c-api/init.rst:2172
2481
+ #: ../../c-api/init.rst:2173
2482
2482
msgid "Thread Local Storage (TLS) API"
2483
2483
msgstr ""
2484
2484
2485
- #: ../../c-api/init.rst:2174
2485
+ #: ../../c-api/init.rst:2175
2486
2486
msgid ""
2487
2487
"This API is superseded by :ref:`Thread Specific Storage (TSS) API <thread-"
2488
2488
"specific-storage-api>`."
2489
2489
msgstr ""
2490
2490
2491
- #: ../../c-api/init.rst:2179
2491
+ #: ../../c-api/init.rst:2180
2492
2492
msgid ""
2493
2493
"This version of the API does not support platforms where the native TLS key "
2494
2494
"is defined in a way that cannot be safely cast to ``int``. On such "
@@ -2497,7 +2497,7 @@ msgid ""
2497
2497
"platforms."
2498
2498
msgstr ""
2499
2499
2500
- #: ../../c-api/init.rst:2184
2500
+ #: ../../c-api/init.rst:2185
2501
2501
msgid ""
2502
2502
"Due to the compatibility problem noted above, this version of the API should "
2503
2503
"not be used in new code."
0 commit comments