|
8 | 8 | msgstr "" |
9 | 9 | "Project-Id-Version:Python 3.11\n" |
10 | 10 | "Report-Msgid-Bugs-To:\n" |
11 | | -"POT-Creation-Date:2022-10-06 00:23+0000\n" |
| 11 | +"POT-Creation-Date:2023-01-25 00:17+0000\n" |
12 | 12 | "PO-Revision-Date:2018-05-23 14:06+0000\n" |
13 | 13 | "Last-Translator:Adrian Liaw <adrianliaw2000@gmail.com>\n" |
14 | 14 | "Language-Team:Chinese - TAIWAN (https://github.com/python/python-docs-zh-" |
@@ -118,210 +118,217 @@ msgid "" |
118 | 118 | "are no digits, :exc:`ValueError` will be raised." |
119 | 119 | msgstr"" |
120 | 120 |
|
121 | | -#:../../c-api/long.rst:99 |
| 121 | +#:../../c-api/long.rst:96 |
| 122 | +msgid"" |
| 123 | +"Python methods :meth:`int.to_bytes` and :meth:`int.from_bytes` to convert a :" |
| 124 | +"c:type:`PyLongObject` to/from an array of bytes in base ``256``. You can " |
| 125 | +"call those from C using :c:func:`PyObject_CallMethod`." |
| 126 | +msgstr"" |
| 127 | + |
| 128 | +#:../../c-api/long.rst:103 |
122 | 129 | msgid"" |
123 | 130 | "Convert a sequence of Unicode digits in the string *u* to a Python integer " |
124 | 131 | "value." |
125 | 132 | msgstr"" |
126 | 133 |
|
127 | | -#:../../c-api/long.rst:107 |
| 134 | +#:../../c-api/long.rst:111 |
128 | 135 | msgid"" |
129 | 136 | "Create a Python integer from the pointer *p*. The pointer value can be " |
130 | 137 | "retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`." |
131 | 138 | msgstr"" |
132 | 139 |
|
133 | | -#:../../c-api/long.rst:118../../c-api/long.rst:136 |
| 140 | +#:../../c-api/long.rst:122../../c-api/long.rst:140 |
134 | 141 | msgid"" |
135 | 142 | "Return a C :c:expr:`long` representation of *obj*. If *obj* is not an " |
136 | 143 | "instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method " |
137 | 144 | "(if present) to convert it to a :c:type:`PyLongObject`." |
138 | 145 | msgstr"" |
139 | 146 |
|
140 | | -#:../../c-api/long.rst:122 |
| 147 | +#:../../c-api/long.rst:126 |
141 | 148 | msgid"" |
142 | 149 | "Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" |
143 | 150 | "expr:`long`." |
144 | 151 | msgstr"" |
145 | 152 |
|
146 | | -#:../../c-api/long.rst:125../../c-api/long.rst:145../../c-api/long.rst:166 |
147 | | -#:../../c-api/long.rst:186../../c-api/long.rst:209 |
| 153 | +#:../../c-api/long.rst:129../../c-api/long.rst:149../../c-api/long.rst:170 |
| 154 | +#:../../c-api/long.rst:190../../c-api/long.rst:213 |
148 | 155 | msgid"Returns ``-1`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." |
149 | 156 | msgstr"" |
150 | 157 |
|
151 | | -#:../../c-api/long.rst:127../../c-api/long.rst:147../../c-api/long.rst:168 |
152 | | -#:../../c-api/long.rst:190../../c-api/long.rst:274../../c-api/long.rst:294 |
| 158 | +#:../../c-api/long.rst:131../../c-api/long.rst:151../../c-api/long.rst:172 |
| 159 | +#:../../c-api/long.rst:194../../c-api/long.rst:278../../c-api/long.rst:298 |
153 | 160 | msgid"Use :meth:`__index__` if available." |
154 | 161 | msgstr"" |
155 | 162 |
|
156 | | -#:../../c-api/long.rst:130../../c-api/long.rst:150../../c-api/long.rst:171 |
157 | | -#:../../c-api/long.rst:193../../c-api/long.rst:277../../c-api/long.rst:297 |
| 163 | +#:../../c-api/long.rst:134../../c-api/long.rst:154../../c-api/long.rst:175 |
| 164 | +#:../../c-api/long.rst:197../../c-api/long.rst:281../../c-api/long.rst:301 |
158 | 165 | msgid"This function will no longer use :meth:`__int__`." |
159 | 166 | msgstr"" |
160 | 167 |
|
161 | | -#:../../c-api/long.rst:140 |
| 168 | +#:../../c-api/long.rst:144 |
162 | 169 | msgid"" |
163 | 170 | "If the value of *obj* is greater than :const:`LONG_MAX` or less than :const:" |
164 | 171 | "`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and return " |
165 | 172 | "``-1``; otherwise, set *\\*overflow* to ``0``. If any other exception " |
166 | 173 | "occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." |
167 | 174 | msgstr"" |
168 | 175 |
|
169 | | -#:../../c-api/long.rst:159../../c-api/long.rst:177 |
| 176 | +#:../../c-api/long.rst:163../../c-api/long.rst:181 |
170 | 177 | msgid"" |
171 | 178 | "Return a C :c:expr:`long long` representation of *obj*. If *obj* is not an " |
172 | 179 | "instance of :c:type:`PyLongObject`, first call its :meth:`__index__` method " |
173 | 180 | "(if present) to convert it to a :c:type:`PyLongObject`." |
174 | 181 | msgstr"" |
175 | 182 |
|
176 | | -#:../../c-api/long.rst:163 |
| 183 | +#:../../c-api/long.rst:167 |
177 | 184 | msgid"" |
178 | 185 | "Raise :exc:`OverflowError` if the value of *obj* is out of range for a :c:" |
179 | 186 | "expr:`long long`." |
180 | 187 | msgstr"" |
181 | 188 |
|
182 | | -#:../../c-api/long.rst:181 |
| 189 | +#:../../c-api/long.rst:185 |
183 | 190 | msgid"" |
184 | 191 | "If the value of *obj* is greater than :const:`LLONG_MAX` or less than :const:" |
185 | 192 | "`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and return " |
186 | 193 | "``-1``; otherwise, set *\\*overflow* to ``0``. If any other exception " |
187 | 194 | "occurs set *\\*overflow* to ``0`` and return ``-1`` as usual." |
188 | 195 | msgstr"" |
189 | 196 |
|
190 | | -#:../../c-api/long.rst:203 |
| 197 | +#:../../c-api/long.rst:207 |
191 | 198 | msgid"" |
192 | 199 | "Return a C :c:type:`Py_ssize_t` representation of *pylong*. *pylong* must " |
193 | 200 | "be an instance of :c:type:`PyLongObject`." |
194 | 201 | msgstr"" |
195 | 202 |
|
196 | | -#:../../c-api/long.rst:206 |
| 203 | +#:../../c-api/long.rst:210 |
197 | 204 | msgid"" |
198 | 205 | "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" |
199 | 206 | "type:`Py_ssize_t`." |
200 | 207 | msgstr"" |
201 | 208 |
|
202 | | -#:../../c-api/long.rst:218 |
| 209 | +#:../../c-api/long.rst:222 |
203 | 210 | msgid"" |
204 | 211 | "Return a C :c:expr:`unsigned long` representation of *pylong*. *pylong* " |
205 | 212 | "must be an instance of :c:type:`PyLongObject`." |
206 | 213 | msgstr"" |
207 | 214 |
|
208 | | -#:../../c-api/long.rst:221 |
| 215 | +#:../../c-api/long.rst:225 |
209 | 216 | msgid"" |
210 | 217 | "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" |
211 | 218 | "expr:`unsigned long`." |
212 | 219 | msgstr"" |
213 | 220 |
|
214 | | -#:../../c-api/long.rst:224 |
| 221 | +#:../../c-api/long.rst:228 |
215 | 222 | msgid"" |
216 | 223 | "Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to " |
217 | 224 | "disambiguate." |
218 | 225 | msgstr"" |
219 | 226 |
|
220 | | -#:../../c-api/long.rst:234 |
| 227 | +#:../../c-api/long.rst:238 |
221 | 228 | msgid"" |
222 | 229 | "Return a C :c:type:`size_t` representation of *pylong*. *pylong* must be an " |
223 | 230 | "instance of :c:type:`PyLongObject`." |
224 | 231 | msgstr"" |
225 | 232 |
|
226 | | -#:../../c-api/long.rst:237 |
| 233 | +#:../../c-api/long.rst:241 |
227 | 234 | msgid"" |
228 | 235 | "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" |
229 | 236 | "type:`size_t`." |
230 | 237 | msgstr"" |
231 | 238 |
|
232 | | -#:../../c-api/long.rst:240 |
| 239 | +#:../../c-api/long.rst:244 |
233 | 240 | msgid"" |
234 | 241 | "Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to " |
235 | 242 | "disambiguate." |
236 | 243 | msgstr"" |
237 | 244 |
|
238 | | -#:../../c-api/long.rst:249 |
| 245 | +#:../../c-api/long.rst:253 |
239 | 246 | msgid"" |
240 | 247 | "Return a C :c:expr:`unsigned long long` representation of *pylong*. " |
241 | 248 | "*pylong* must be an instance of :c:type:`PyLongObject`." |
242 | 249 | msgstr"" |
243 | 250 |
|
244 | | -#:../../c-api/long.rst:252 |
| 251 | +#:../../c-api/long.rst:256 |
245 | 252 | msgid"" |
246 | 253 | "Raise :exc:`OverflowError` if the value of *pylong* is out of range for an :" |
247 | 254 | "c:expr:`unsigned long long`." |
248 | 255 | msgstr"" |
249 | 256 |
|
250 | | -#:../../c-api/long.rst:255 |
| 257 | +#:../../c-api/long.rst:259 |
251 | 258 | msgid"" |
252 | 259 | "Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to " |
253 | 260 | "disambiguate." |
254 | 261 | msgstr"" |
255 | 262 |
|
256 | | -#:../../c-api/long.rst:258 |
| 263 | +#:../../c-api/long.rst:262 |
257 | 264 | msgid"" |
258 | 265 | "A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`." |
259 | 266 | msgstr"" |
260 | 267 |
|
261 | | -#:../../c-api/long.rst:264 |
| 268 | +#:../../c-api/long.rst:268 |
262 | 269 | msgid"" |
263 | 270 | "Return a C :c:expr:`unsigned long` representation of *obj*. If *obj* is not " |
264 | 271 | "an instance of :c:type:`PyLongObject`, first call its :meth:`__index__` " |
265 | 272 | "method (if present) to convert it to a :c:type:`PyLongObject`." |
266 | 273 | msgstr"" |
267 | 274 |
|
268 | | -#:../../c-api/long.rst:268 |
| 275 | +#:../../c-api/long.rst:272 |
269 | 276 | msgid"" |
270 | 277 | "If the value of *obj* is out of range for an :c:expr:`unsigned long`, return " |
271 | 278 | "the reduction of that value modulo ``ULONG_MAX + 1``." |
272 | 279 | msgstr"" |
273 | 280 |
|
274 | | -#:../../c-api/long.rst:271 |
| 281 | +#:../../c-api/long.rst:275 |
275 | 282 | msgid"" |
276 | 283 | "Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to " |
277 | 284 | "disambiguate." |
278 | 285 | msgstr"" |
279 | 286 |
|
280 | | -#:../../c-api/long.rst:283 |
| 287 | +#:../../c-api/long.rst:287 |
281 | 288 | msgid"" |
282 | 289 | "Return a C :c:expr:`unsigned long long` representation of *obj*. If *obj* " |
283 | 290 | "is not an instance of :c:type:`PyLongObject`, first call its :meth:" |
284 | 291 | "`__index__` method (if present) to convert it to a :c:type:`PyLongObject`." |
285 | 292 | msgstr"" |
286 | 293 |
|
287 | | -#:../../c-api/long.rst:288 |
| 294 | +#:../../c-api/long.rst:292 |
288 | 295 | msgid"" |
289 | 296 | "If the value of *obj* is out of range for an :c:expr:`unsigned long long`, " |
290 | 297 | "return the reduction of that value modulo ``ULLONG_MAX + 1``." |
291 | 298 | msgstr"" |
292 | 299 |
|
293 | | -#:../../c-api/long.rst:291 |
| 300 | +#:../../c-api/long.rst:295 |
294 | 301 | msgid"" |
295 | 302 | "Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` " |
296 | 303 | "to disambiguate." |
297 | 304 | msgstr"" |
298 | 305 |
|
299 | | -#:../../c-api/long.rst:303 |
| 306 | +#:../../c-api/long.rst:307 |
300 | 307 | msgid"" |
301 | 308 | "Return a C :c:expr:`double` representation of *pylong*. *pylong* must be an " |
302 | 309 | "instance of :c:type:`PyLongObject`." |
303 | 310 | msgstr"" |
304 | 311 |
|
305 | | -#:../../c-api/long.rst:306 |
| 312 | +#:../../c-api/long.rst:310 |
306 | 313 | msgid"" |
307 | 314 | "Raise :exc:`OverflowError` if the value of *pylong* is out of range for a :c:" |
308 | 315 | "expr:`double`." |
309 | 316 | msgstr"" |
310 | 317 |
|
311 | | -#:../../c-api/long.rst:309 |
| 318 | +#:../../c-api/long.rst:313 |
312 | 319 | msgid"" |
313 | 320 | "Returns ``-1.0`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." |
314 | 321 | msgstr"" |
315 | 322 |
|
316 | | -#:../../c-api/long.rst:314 |
| 323 | +#:../../c-api/long.rst:318 |
317 | 324 | msgid"" |
318 | 325 | "Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong* " |
319 | 326 | "cannot be converted, an :exc:`OverflowError` will be raised. This is only " |
320 | 327 | "assured to produce a usable :c:expr:`void` pointer for values created with :" |
321 | 328 | "c:func:`PyLong_FromVoidPtr`." |
322 | 329 | msgstr"" |
323 | 330 |
|
324 | | -#:../../c-api/long.rst:319 |
| 331 | +#:../../c-api/long.rst:323 |
325 | 332 | msgid"" |
326 | 333 | "Returns ``NULL`` on error. Use :c:func:`PyErr_Occurred` to disambiguate." |
327 | 334 | msgstr"" |