-
-
Notifications
You must be signed in to change notification settings - Fork 224
Expand file tree
/
Copy pathstdlib.po
More file actions
717 lines (650 loc) · 25.1 KB
/
stdlib.po
File metadata and controls
717 lines (650 loc) · 25.1 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
#
# Translators:
# woodrow-shen <woodrow.shen@gmail.com>, 2015-2016
# Liang-Bo Wang <me@liang2.tw>, 2016
# Jason <chairco@gmail.com>, 2016
# 文俊 高 <jkw552403@gmail.com>, 2016
# Adrian Liaw <adrianliaw2000@gmail.com>, 2018
# Steven Hsu <hsuhaochun@gmail.com>, 2021
# Phil Lin <linooohon@gmail.com>, 2022
msgid ""
msgstr ""
"Project-Id-Version: Python 3.13\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2024-09-23 07:52+0800\n"
"PO-Revision-Date: 2022-01-31 18:14+0800\n"
"Last-Translator: Phil Lin <linooohon@gmail.com>\n"
"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
"tw)\n"
"Language: zh_TW\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=1; plural=0;\n"
"X-Generator: Poedit 3.0.1\n"
#: ../../tutorial/stdlib.rst:5
msgid "Brief Tour of the Standard Library"
msgstr "Python 標準函式庫概覽"
#: ../../tutorial/stdlib.rst:11
msgid "Operating System Interface"
msgstr "作業系統介面"
#: ../../tutorial/stdlib.rst:13
msgid ""
"The :mod:`os` module provides dozens of functions for interacting with the "
"operating system::"
msgstr ":mod:`os` 模組提供了數十個與作業系統溝通的函式： ::"
#: ../../tutorial/stdlib.rst:16
msgid ""
">>> import os\n"
">>> os.getcwd() # Return the current working directory\n"
"'C:\\\\Python313'\n"
">>> os.chdir('/server/accesslogs') # Change current working directory\n"
">>> os.system('mkdir today') # Run the command mkdir in the system shell\n"
"0"
msgstr ""
">>> import os\n"
">>> os.getcwd() # 回傳目前的工作目錄\n"
"'C:\\\\Python313'\n"
">>> os.chdir('/server/accesslogs') # 改變目前的工作目錄\n"
">>> os.system('mkdir today') # 在系統 shell 中執行 mkdir 指令\n"
"0"
#: ../../tutorial/stdlib.rst:23
msgid ""
"Be sure to use the ``import os`` style instead of ``from os import *``. "
"This will keep :func:`os.open` from shadowing the built-in :func:`open` "
"function which operates much differently."
msgstr ""
"務必使用 ``import os`` 而非 ``from os import *``。這將避免因系統不同而有實作"
"差異的 :func:`os.open` 覆蓋內建函式 :func:`open`。"
#: ../../tutorial/stdlib.rst:29
msgid ""
"The built-in :func:`dir` and :func:`help` functions are useful as "
"interactive aids for working with large modules like :mod:`os`::"
msgstr ""
"在使用 :mod:`os` 諸如此類大型模組時搭配內建函式 :func:`dir` 和 :func:`help` "
"是非常有用的： ::"
#: ../../tutorial/stdlib.rst:32
msgid ""
">>> import os\n"
">>> dir(os)\n"
"<returns a list of all module functions>\n"
">>> help(os)\n"
"<returns an extensive manual page created from the module's docstrings>"
msgstr ""
">>> import os\n"
">>> dir(os)\n"
"<returns a list of all module functions>\n"
">>> help(os)\n"
"<returns an extensive manual page created from the module's docstrings>"
#: ../../tutorial/stdlib.rst:38
msgid ""
"For daily file and directory management tasks, the :mod:`shutil` module "
"provides a higher level interface that is easier to use::"
msgstr ""
"對於日常檔案和目錄管理任務，:mod:`shutil` 模組提供了更容易使用的高階介面： ::"
#: ../../tutorial/stdlib.rst:41
msgid ""
">>> import shutil\n"
">>> shutil.copyfile('data.db', 'archive.db')\n"
"'archive.db'\n"
">>> shutil.move('/build/executables', 'installdir')\n"
"'installdir'"
msgstr ""
">>> import shutil\n"
">>> shutil.copyfile('data.db', 'archive.db')\n"
"'archive.db'\n"
">>> shutil.move('/build/executables', 'installdir')\n"
"'installdir'"
#: ../../tutorial/stdlib.rst:51
msgid "File Wildcards"
msgstr "檔案之萬用字元 (File Wildcards)"
#: ../../tutorial/stdlib.rst:53
msgid ""
"The :mod:`glob` module provides a function for making file lists from "
"directory wildcard searches::"
msgstr ""
":mod:`glob` 模組提供了一函式可以從目錄萬用字元中搜尋並產生檔案列表： ::"
#: ../../tutorial/stdlib.rst:56
msgid ""
">>> import glob\n"
">>> glob.glob('*.py')\n"
"['primes.py', 'random.py', 'quote.py']"
msgstr ""
">>> import glob\n"
">>> glob.glob('*.py')\n"
"['primes.py', 'random.py', 'quote.py']"
#: ../../tutorial/stdlib.rst:64
msgid "Command Line Arguments"
msgstr "命令列引數"
#: ../../tutorial/stdlib.rst:66
msgid ""
"Common utility scripts often need to process command line arguments. These "
"arguments are stored in the :mod:`sys` module's *argv* attribute as a list. "
"For instance, let's take the following :file:`demo.py` file::"
msgstr ""
"通用工具腳本常需要處理命令列引數。這些引數會以 list（串列）形式存放"
"在 :mod:`sys` 模組的 *argv* 屬性中。例如以下 :file:`demo.py` 檔案： ::"
#: ../../tutorial/stdlib.rst:70
msgid ""
"# File demo.py\n"
"import sys\n"
"print(sys.argv)"
msgstr ""
"# demo.py 檔案\n"
"import sys\n"
"print(sys.argv)"
#: ../../tutorial/stdlib.rst:74
msgid ""
"Here is the output from running ``python demo.py one two three`` at the "
"command line::"
msgstr "以下是在命令列運行 ``python demo.py one two three`` 的輸出： ::"
#: ../../tutorial/stdlib.rst:77
msgid "['demo.py', 'one', 'two', 'three']"
msgstr "['demo.py', 'one', 'two', 'three']"
#: ../../tutorial/stdlib.rst:79
msgid ""
"The :mod:`argparse` module provides a more sophisticated mechanism to "
"process command line arguments. The following script extracts one or more "
"filenames and an optional number of lines to be displayed::"
msgstr ""
":mod:`argparse` 模組提供了一種更複雜的機制來處理命令列引數。以下腳本可擷取一"
"個或多個檔案名稱，並可選擇要顯示的行數： ::"
#: ../../tutorial/stdlib.rst:83
msgid ""
"import argparse\n"
"\n"
"parser = argparse.ArgumentParser(\n"
" prog='top',\n"
" description='Show top lines from each file')\n"
"parser.add_argument('filenames', nargs='+')\n"
"parser.add_argument('-l', '--lines', type=int, default=10)\n"
"args = parser.parse_args()\n"
"print(args)"
msgstr ""
"import argparse\n"
"\n"
"parser = argparse.ArgumentParser(\n"
" prog='top',\n"
" description='Show top lines from each file')\n"
"parser.add_argument('filenames', nargs='+')\n"
"parser.add_argument('-l', '--lines', type=int, default=10)\n"
"args = parser.parse_args()\n"
"print(args)"
#: ../../tutorial/stdlib.rst:93
msgid ""
"When run at the command line with ``python top.py --lines=5 alpha.txt "
"beta.txt``, the script sets ``args.lines`` to ``5`` and ``args.filenames`` "
"to ``['alpha.txt', 'beta.txt']``."
msgstr ""
"當 ``python top.py --lines=5 alpha.txt beta.txt`` 在命令列執行時，該腳本會將 "
"``args.lines`` 設為 ``5``，並將 ``args.filenames`` 設為 ``['alpha.txt', "
"'beta.txt']``。"
#: ../../tutorial/stdlib.rst:101
msgid "Error Output Redirection and Program Termination"
msgstr "錯誤輸出重新導向與程式終止"
#: ../../tutorial/stdlib.rst:103
msgid ""
"The :mod:`sys` module also has attributes for *stdin*, *stdout*, and "
"*stderr*. The latter is useful for emitting warnings and error messages to "
"make them visible even when *stdout* has been redirected::"
msgstr ""
":mod:`sys` 模組也有 *stdin*，*stdout*，和 *stderr* 等屬性。即使當 *stdout* 被"
"重新導向時，後者 *stderr* 可輸出警告和錯誤訊息： ::"
#: ../../tutorial/stdlib.rst:107
msgid ""
">>> sys.stderr.write('Warning, log file not found starting a new one\\n')\n"
"Warning, log file not found starting a new one"
msgstr ""
">>> sys.stderr.write('Warning, log file not found starting a new one\\n')\n"
"Warning, log file not found starting a new one"
#: ../../tutorial/stdlib.rst:110
msgid "The most direct way to terminate a script is to use ``sys.exit()``."
msgstr "終止腳本最直接的方式就是利用 ``sys.exit()``。"
#: ../../tutorial/stdlib.rst:116
msgid "String Pattern Matching"
msgstr "字串樣式比對"
#: ../../tutorial/stdlib.rst:118
msgid ""
"The :mod:`re` module provides regular expression tools for advanced string "
"processing. For complex matching and manipulation, regular expressions offer "
"succinct, optimized solutions::"
msgstr ""
":mod:`re` 模組提供正規表示式 (regular expression) 做進階的字串處理。當要處理"
"複雜的比對以及操作時，正規表示式是簡潔且經過最佳化的解決方案： ::"
#: ../../tutorial/stdlib.rst:122
msgid ""
">>> import re\n"
">>> re.findall(r'\\bf[a-z]*', 'which foot or hand fell fastest')\n"
"['foot', 'fell', 'fastest']\n"
">>> re.sub(r'(\\b[a-z]+) \\1', r'\\1', 'cat in the the hat')\n"
"'cat in the hat'"
msgstr ""
">>> import re\n"
">>> re.findall(r'\\bf[a-z]*', 'which foot or hand fell fastest')\n"
"['foot', 'fell', 'fastest']\n"
">>> re.sub(r'(\\b[a-z]+) \\1', r'\\1', 'cat in the the hat')\n"
"'cat in the hat'"
#: ../../tutorial/stdlib.rst:128
msgid ""
"When only simple capabilities are needed, string methods are preferred "
"because they are easier to read and debug::"
msgstr ""
"當只需要簡單的字串操作時，因為可讀性以及方便除錯，字串本身的 method 是比較建"
"議的： ::"
#: ../../tutorial/stdlib.rst:131
msgid ""
">>> 'tea for too'.replace('too', 'two')\n"
"'tea for two'"
msgstr ""
">>> 'tea for too'.replace('too', 'two')\n"
"'tea for two'"
#: ../../tutorial/stdlib.rst:138
msgid "Mathematics"
msgstr "數學相關"
#: ../../tutorial/stdlib.rst:140
msgid ""
"The :mod:`math` module gives access to the underlying C library functions "
"for floating-point math::"
msgstr ":mod:`math` 模組提供了 C 函式庫中底層的浮點數運算的函式： ::"
#: ../../tutorial/stdlib.rst:143
msgid ""
">>> import math\n"
">>> math.cos(math.pi / 4)\n"
"0.70710678118654757\n"
">>> math.log(1024, 2)\n"
"10.0"
msgstr ""
">>> import math\n"
">>> math.cos(math.pi / 4)\n"
"0.70710678118654757\n"
">>> math.log(1024, 2)\n"
"10.0"
#: ../../tutorial/stdlib.rst:149
msgid "The :mod:`random` module provides tools for making random selections::"
msgstr ":mod:`random` 模組提供了隨機選擇的工具： ::"
#: ../../tutorial/stdlib.rst:151
msgid ""
">>> import random\n"
">>> random.choice(['apple', 'pear', 'banana'])\n"
"'apple'\n"
">>> random.sample(range(100), 10) # sampling without replacement\n"
"[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]\n"
">>> random.random() # random float from the interval [0.0, 1.0)\n"
"0.17970987693706186\n"
">>> random.randrange(6) # random integer chosen from range(6)\n"
"4"
msgstr ""
">>> import random\n"
">>> random.choice(['apple', 'pear', 'banana'])\n"
"'apple'\n"
">>> random.sample(range(100), 10) # 不重複抽樣\n"
"[30, 83, 16, 4, 8, 81, 41, 50, 18, 33]\n"
">>> random.random() # 區間 [0.0, 1.0) 中的隨機浮點數\n"
"0.17970987693706186\n"
">>> random.randrange(6) # 從 range(6) 中隨機選擇整數\n"
"4"
#: ../../tutorial/stdlib.rst:161
msgid ""
"The :mod:`statistics` module calculates basic statistical properties (the "
"mean, median, variance, etc.) of numeric data::"
msgstr ""
":mod:`statistics` 模組提供了替數值資料計算基本統計量（包括平均、中位數、變異"
"量數等）的功能： ::"
#: ../../tutorial/stdlib.rst:164
msgid ""
">>> import statistics\n"
">>> data = [2.75, 1.75, 1.25, 0.25, 0.5, 1.25, 3.5]\n"
">>> statistics.mean(data)\n"
"1.6071428571428572\n"
">>> statistics.median(data)\n"
"1.25\n"
">>> statistics.variance(data)\n"
"1.3720238095238095"
msgstr ""
">>> import statistics\n"
">>> data = [2.75, 1.75, 1.25, 0.25, 0.5, 1.25, 3.5]\n"
">>> statistics.mean(data)\n"
"1.6071428571428572\n"
">>> statistics.median(data)\n"
"1.25\n"
">>> statistics.variance(data)\n"
"1.3720238095238095"
#: ../../tutorial/stdlib.rst:173
msgid ""
"The SciPy project <https://scipy.org> has many other modules for numerical "
"computations."
msgstr "SciPy 專案 <https://scipy.org> 上也有許多數值計算相關的模組。"
#: ../../tutorial/stdlib.rst:179
msgid "Internet Access"
msgstr "網路存取"
#: ../../tutorial/stdlib.rst:181
msgid ""
"There are a number of modules for accessing the internet and processing "
"internet protocols. Two of the simplest are :mod:`urllib.request` for "
"retrieving data from URLs and :mod:`smtplib` for sending mail::"
msgstr ""
"Python 中有許多存取網路以及處理網路協定。最簡單的兩個例子包"
"括 :mod:`urllib.request` 模組可以從網址抓取資料以及 :mod:`smtplib` 可以用來寄"
"郵件： ::"
#: ../../tutorial/stdlib.rst:185
msgid ""
">>> from urllib.request import urlopen\n"
">>> with urlopen('http://worldtimeapi.org/api/timezone/etc/UTC.txt') as "
"response:\n"
"... for line in response:\n"
"... line = line.decode() # Convert bytes to a str\n"
"... if line.startswith('datetime'):\n"
"... print(line.rstrip()) # Remove trailing newline\n"
"...\n"
"datetime: 2022-01-01T01:36:47.689215+00:00\n"
"\n"
">>> import smtplib\n"
">>> server = smtplib.SMTP('localhost')\n"
">>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',\n"
"... \"\"\"To: jcaesar@example.org\n"
"... From: soothsayer@example.org\n"
"...\n"
"... Beware the Ides of March.\n"
"... \"\"\")\n"
">>> server.quit()"
msgstr ""
">>> from urllib.request import urlopen\n"
">>> with urlopen('http://worldtimeapi.org/api/timezone/etc/UTC.txt') as "
"response:\n"
"... for line in response:\n"
"... line = line.decode() # 將 bytes 轉換為 str\n"
"... if line.startswith('datetime'):\n"
"... print(line.rstrip()) # 移除最後面的換行符號\n"
"...\n"
"datetime: 2022-01-01T01:36:47.689215+00:00\n"
"\n"
">>> import smtplib\n"
">>> server = smtplib.SMTP('localhost')\n"
">>> server.sendmail('soothsayer@example.org', 'jcaesar@example.org',\n"
"... \"\"\"To: jcaesar@example.org\n"
"... From: soothsayer@example.org\n"
"...\n"
"... Beware the Ides of March.\n"
"... \"\"\")\n"
">>> server.quit()"
#: ../../tutorial/stdlib.rst:204
msgid "(Note that the second example needs a mailserver running on localhost.)"
msgstr "（注意第二個例子中需要在本地端執行一個郵件伺服器。）"
#: ../../tutorial/stdlib.rst:210
msgid "Dates and Times"
msgstr "日期與時間"
#: ../../tutorial/stdlib.rst:212
msgid ""
"The :mod:`datetime` module supplies classes for manipulating dates and times "
"in both simple and complex ways. While date and time arithmetic is "
"supported, the focus of the implementation is on efficient member extraction "
"for output formatting and manipulation. The module also supports objects "
"that are timezone aware. ::"
msgstr ""
":mod:`datetime` 模組提供許多 class 可以操作日期以及時間，從簡單從複雜都有。模"
"組支援日期與時間的運算，而實作的重點是有效率的成員擷取以達到輸出格式化以及操"
"作。模組也提供支援時區換算的類別。 ::"
#: ../../tutorial/stdlib.rst:218
msgid ""
">>> # dates are easily constructed and formatted\n"
">>> from datetime import date\n"
">>> now = date.today()\n"
">>> now\n"
"datetime.date(2003, 12, 2)\n"
">>> now.strftime(\"%m-%d-%y. %d %b %Y is a %A on the %d day of %B.\")\n"
"'12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.'\n"
"\n"
">>> # dates support calendar arithmetic\n"
">>> birthday = date(1964, 7, 31)\n"
">>> age = now - birthday\n"
">>> age.days\n"
"14368"
msgstr ""
">>> # 能夠輕易建立與格式化\n"
">>> from datetime import date\n"
">>> now = date.today()\n"
">>> now\n"
"datetime.date(2003, 12, 2)\n"
">>> now.strftime(\"%m-%d-%y. %d %b %Y is a %A on the %d day of %B.\")\n"
"'12-02-03. 02 Dec 2003 is a Tuesday on the 02 day of December.'\n"
"\n"
">>> # 支援運算\n"
">>> birthday = date(1964, 7, 31)\n"
">>> age = now - birthday\n"
">>> age.days\n"
"14368"
#: ../../tutorial/stdlib.rst:236
msgid "Data Compression"
msgstr "資料壓縮"
#: ../../tutorial/stdlib.rst:238
msgid ""
"Common data archiving and compression formats are directly supported by "
"modules "
"including: :mod:`zlib`, :mod:`gzip`, :mod:`bz2`, :mod:`lzma`, :mod:`zipfile` "
"and :mod:`tarfile`. ::"
msgstr ""
"常見的解壓縮以及壓縮格式都有直接支援的模組。包"
"括：:mod:`zlib`、:mod:`gzip`、:mod:`bz2`、:mod:`lzma`、:mod:`zipfile` 以"
"及 :mod:`tarfile`。 ::"
#: ../../tutorial/stdlib.rst:242
msgid ""
">>> import zlib\n"
">>> s = b'witch which has which witches wrist watch'\n"
">>> len(s)\n"
"41\n"
">>> t = zlib.compress(s)\n"
">>> len(t)\n"
"37\n"
">>> zlib.decompress(t)\n"
"b'witch which has which witches wrist watch'\n"
">>> zlib.crc32(s)\n"
"226805979"
msgstr ""
">>> import zlib\n"
">>> s = b'witch which has which witches wrist watch'\n"
">>> len(s)\n"
"41\n"
">>> t = zlib.compress(s)\n"
">>> len(t)\n"
"37\n"
">>> zlib.decompress(t)\n"
"b'witch which has which witches wrist watch'\n"
">>> zlib.crc32(s)\n"
"226805979"
#: ../../tutorial/stdlib.rst:258
msgid "Performance Measurement"
msgstr "效能量測"
#: ../../tutorial/stdlib.rst:260
msgid ""
"Some Python users develop a deep interest in knowing the relative "
"performance of different approaches to the same problem. Python provides a "
"measurement tool that answers those questions immediately."
msgstr ""
"有一些 Python 使用者很想了解同個問題的不同實作方法的效能差異。Python 提供了評"
"估效能差異的工具。"
#: ../../tutorial/stdlib.rst:264
msgid ""
"For example, it may be tempting to use the tuple packing and unpacking "
"feature instead of the traditional approach to swapping arguments. "
"The :mod:`timeit` module quickly demonstrates a modest performance "
"advantage::"
msgstr ""
"舉例來說，有人可能會試著用 tuple 的打包機制來交換引數代替傳統的方"
"式。:mod:`timeit` 模組可以迅速地展示效能的進步： ::"
#: ../../tutorial/stdlib.rst:268
msgid ""
">>> from timeit import Timer\n"
">>> Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()\n"
"0.57535828626024577\n"
">>> Timer('a,b = b,a', 'a=1; b=2').timeit()\n"
"0.54962537085770791"
msgstr ""
">>> from timeit import Timer\n"
">>> Timer('t=a; a=b; b=t', 'a=1; b=2').timeit()\n"
"0.57535828626024577\n"
">>> Timer('a,b = b,a', 'a=1; b=2').timeit()\n"
"0.54962537085770791"
#: ../../tutorial/stdlib.rst:274
msgid ""
"In contrast to :mod:`timeit`'s fine level of granularity, the :mod:`profile` "
"and :mod:`pstats` modules provide tools for identifying time critical "
"sections in larger blocks of code."
msgstr ""
"相對於 :mod:`timeit` 模組提供這麼細的粒度，:mod:`profile` 模組以"
"及 :mod:`pstats` 模組則提供了一些在大型的程式碼識別時間使用上關鍵的區塊 "
"(time critical section) 的工具。"
#: ../../tutorial/stdlib.rst:282
msgid "Quality Control"
msgstr "品質控管"
#: ../../tutorial/stdlib.rst:284
msgid ""
"One approach for developing high quality software is to write tests for each "
"function as it is developed and to run those tests frequently during the "
"development process."
msgstr ""
"達到高品質軟體的一個方法，是在開發時對每個函式寫測試，以及在開發過程中要不斷"
"地跑這些測試。"
#: ../../tutorial/stdlib.rst:288
msgid ""
"The :mod:`doctest` module provides a tool for scanning a module and "
"validating tests embedded in a program's docstrings. Test construction is "
"as simple as cutting-and-pasting a typical call along with its results into "
"the docstring. This improves the documentation by providing the user with an "
"example and it allows the doctest module to make sure the code remains true "
"to the documentation::"
msgstr ""
":mod:`doctest` 模組提供了一個工具，掃描模組並根據程式中內嵌的文件字串執行測"
"試。撰寫測試如同簡單地將它的呼叫及輸出結果剪下並貼上到文件字串中。透過提供範"
"例給使用者，它強化了說明文件，並允許 doctest 模組確認程式碼的結果與說明文件一"
"致： ::"
#: ../../tutorial/stdlib.rst:295
msgid ""
"def average(values):\n"
" \"\"\"Computes the arithmetic mean of a list of numbers.\n"
"\n"
" >>> print(average([20, 30, 70]))\n"
" 40.0\n"
" \"\"\"\n"
" return sum(values) / len(values)\n"
"\n"
"import doctest\n"
"doctest.testmod() # automatically validate the embedded tests"
msgstr ""
"def average(values):\n"
" \"\"\"計算數字串列的算術平均數。\n"
"\n"
" >>> print(average([20, 30, 70]))\n"
" 40.0\n"
" \"\"\"\n"
" return sum(values) / len(values)\n"
"\n"
"import doctest\n"
"doctest.testmod() # 自動驗證內嵌的測試"
#: ../../tutorial/stdlib.rst:306
msgid ""
"The :mod:`unittest` module is not as effortless as the :mod:`doctest` "
"module, but it allows a more comprehensive set of tests to be maintained in "
"a separate file::"
msgstr ""
":mod:`unittest` 模組不像 :mod:`doctest` 模組這般容易，但是它讓你可以在另外一"
"個檔案裡撰寫更完整的測試集： ::"
#: ../../tutorial/stdlib.rst:310
msgid ""
"import unittest\n"
"\n"
"class TestStatisticalFunctions(unittest.TestCase):\n"
"\n"
" def test_average(self):\n"
" self.assertEqual(average([20, 30, 70]), 40.0)\n"
" self.assertEqual(round(average([1, 5, 7]), 1), 4.3)\n"
" with self.assertRaises(ZeroDivisionError):\n"
" average([])\n"
" with self.assertRaises(TypeError):\n"
" average(20, 30, 70)\n"
"\n"
"unittest.main() # Calling from the command line invokes all tests"
msgstr ""
"import unittest\n"
"\n"
"class TestStatisticalFunctions(unittest.TestCase):\n"
"\n"
" def test_average(self):\n"
" self.assertEqual(average([20, 30, 70]), 40.0)\n"
" self.assertEqual(round(average([1, 5, 7]), 1), 4.3)\n"
" with self.assertRaises(ZeroDivisionError):\n"
" average([])\n"
" with self.assertRaises(TypeError):\n"
" average(20, 30, 70)\n"
"\n"
"unittest.main() # 從命令列呼叫會執行所有測試"
#: ../../tutorial/stdlib.rst:328
msgid "Batteries Included"
msgstr "標準模組庫"
#: ../../tutorial/stdlib.rst:330
msgid ""
"Python has a \"batteries included\" philosophy. This is best seen through "
"the sophisticated and robust capabilities of its larger packages. For "
"example:"
msgstr ""
"\"Batteries included\" 是 Python 的設計哲學。這個理念可以透過使用它的大型套"
"件，感受複雜與強大的功能，來得到印證。例如："
#: ../../tutorial/stdlib.rst:333
msgid ""
"The :mod:`xmlrpc.client` and :mod:`xmlrpc.server` modules make implementing "
"remote procedure calls into an almost trivial task. Despite the modules' "
"names, no direct knowledge or handling of XML is needed."
msgstr ""
"使用 :mod:`xmlrpc.client` 和 :mod:`xmlrpc.server` 模組使實作遠端程序呼叫變得"
"更為容易。即使模組名稱裡有 XML，使用者並不需要直接操作 XML 檔案或事先具備相關"
"知識。"
#: ../../tutorial/stdlib.rst:337
msgid ""
"The :mod:`email` package is a library for managing email messages, including "
"MIME and other :rfc:`2822`-based message documents. Unlike :mod:`smtplib` "
"and :mod:`poplib` which actually send and receive messages, the email "
"package has a complete toolset for building or decoding complex message "
"structures (including attachments) and for implementing internet encoding "
"and header protocols."
msgstr ""
"函式庫 :mod:`email` 套件用來管理 MIME 和其他 :rfc:`2822` 相關電子郵件訊息的文"
"件。相異於 :mod:`smtplib` 和 :mod:`poplib` 這些實際用來發送與接收訊息的模組，"
"email 套件擁有更完整的工具集，可用於建立與解碼複雜訊息結構（包含附件檔案）以"
"及實作編碼與標頭協定。"
#: ../../tutorial/stdlib.rst:344
msgid ""
"The :mod:`json` package provides robust support for parsing this popular "
"data interchange format. The :mod:`csv` module supports direct reading and "
"writing of files in Comma-Separated Value format, commonly supported by "
"databases and spreadsheets. XML processing is supported by "
"the :mod:`xml.etree.ElementTree`, :mod:`xml.dom` and :mod:`xml.sax` "
"packages. Together, these modules and packages greatly simplify data "
"interchange between Python applications and other tools."
msgstr ""
":mod:`json` 套件對 JSON 資料交換格式的剖析，提供強大的支援。:mod:`csv` 模組則"
"提供直接讀寫 CSV（以逗號分隔值的檔案格式，通常資料庫和電子表格都有支"
"援）。:mod:`xml.etree.ElementTree`、:mod:`xml.dom` 與 :mod:`xml.sax` 套件則支"
"援 XML 的處理。綜觀所有，這些模組和套件都簡化了 Python 應用程式與其他工具之間"
"的資料交換。"
#: ../../tutorial/stdlib.rst:353
msgid ""
"The :mod:`sqlite3` module is a wrapper for the SQLite database library, "
"providing a persistent database that can be updated and accessed using "
"slightly nonstandard SQL syntax."
msgstr ""
":mod:`sqllite3` 模組是 SQLite 資料庫函式庫的一層包裝，提供一個具持久性的資料"
"庫，可以使用稍微非標準的 SQL 語法來對它進行更新與存取。"
#: ../../tutorial/stdlib.rst:357
msgid ""
"Internationalization is supported by a number of modules "
"including :mod:`gettext`, :mod:`locale`, and the :mod:`codecs` package."
msgstr ""
"有數種支援國際化的模組，包括 :mod:`gettext`、:mod:`locale` 和 :mod:`codecs` "
"等套件。"
#: ../../tutorial/stdlib.rst:27
msgid "built-in function"
msgstr "built-in function（內建函式）"
#: ../../tutorial/stdlib.rst:27
msgid "help"
msgstr "help（幫助）"