python-docs-zh-tw/tutorial/classes.html at gh-pages · python/python-docs-zh-tw

History

881 lines (803 loc) · 102 KB

Raw

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

718

719

720

721

722

723

724

725

726

727

728

729

730

731

732

733

734

735

736

737

738

739

740

741

742

743

744

745

746

747

748

749

750

751

752

753

754

755

756

757

758

759

760

761

762

763

764

765

766

767

768

769

770

771

772

773

774

775

776

777

778

779

780

781

782

783

784

785

786

787

788

789

790

791

792

793

794

795

796

797

798

799

800

801

802

803

804

805

806

807

808

809

810

811

812

813

814

815

816

817

818

819

820

821

822

823

824

825

826

827

828

829

830

831

832

833

834

835

836

837

838

839

840

841

842

843

844

845

846

847

848

849

850

851

852

853

854

855

856

857

858

859

860

861

862

863

864

865

866

867

868

869

870

871

872

873

874

875

876

877

878

879

880

881

<!DOCTYPE html>

<head>

<title>9. Class（類別） — Python 3.14.3 說明文件</title><meta name="viewport" content="width=device-width, initial-scale=1.0">

title="在 Python 3.14.3 說明文件中搜尋"

href="../_static/opensearch.xml"/>

<style>

@media only screen {

table.full-width-table {

width: 100%;

}

</style>

</head>

<body>

<input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

aria-pressed="false" aria-expanded="false" role="button" aria-label="選單">

</label>

</a>

</svg>

</form>

</nav>

主題

</select>

</label>

<div>

<ul>

<li><a class="reference internal" href="#">9. Class（類別）</a><ul>

<li><a class="reference internal" href="#a-word-about-names-and-objects">9.1. 關於名稱與物件的一段話</a></li>

<li><a class="reference internal" href="#python-scopes-and-namespaces">9.2. Python 作用域 (Scope) 及命名空間 (Namespace)</a><ul>

<li><a class="reference internal" href="#scopes-and-namespaces-example">9.2.1. 作用域和命名空間的範例</a></li>

</ul>

</li>

<li><a class="reference internal" href="#a-first-look-at-classes">9.3. 初見 class</a><ul>

<li><a class="reference internal" href="#class-definition-syntax">9.3.1. Class definition（類別定義）語法</a></li>

<li><a class="reference internal" href="#class-objects">9.3.2. Class 物件</a></li>

<li><a class="reference internal" href="#method-objects">9.3.4. Method 物件</a></li>

<li><a class="reference internal" href="#class-and-instance-variables">9.3.5. Class 及實例變數</a></li>

</ul>

</li>

<li><a class="reference internal" href="#random-remarks">9.4. 隨意的備註</a></li>

<li><a class="reference internal" href="#inheritance">9.5. 繼承 (Inheritance)</a><ul>

</ul>

</li>

<li><a class="reference internal" href="#iterators">9.8. 疊代器 (Iterator)</a></li>

<li><a class="reference internal" href="#generators">9.9. 產生器 (Generator)</a></li>

<li><a class="reference internal" href="#generator-expressions">9.10. 產生器運算式</a></li>

</ul>

</li>

</ul>

</div>

<div>

<a href="errors.html"

title="上一章">8. 錯誤和例外</a>

</div>

<div>

<a href="stdlib.html"

title="下一章">10. Python 標準函式庫概覽</a>

</div>

document.addEventListener('DOMContentLoaded', () => {

const title = document.querySelector('meta[property="og:title"]').content;

const elements = document.querySelectorAll('.improvepage');

const pageurl = window.location.href.split('?')[0];

elements.forEach(element => {

const url = new URL(element.href.split('?')[0].replace("-nojs", ""));

url.searchParams.set('pagetitle', title);

url.searchParams.set('pageurl', pageurl);

url.searchParams.set('pagesource', "tutorial/classes.rst");

element.href = url.toString();

});

</script>

<li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>

<li>

<a href="https://github.com/python/cpython/blob/main/Doc/tutorial/classes.rst?plain=1"

rel="nofollow">顯示原始碼

</a>

</li>

<li>

<a href="https://github.com/python/python-docs-zh-TW/blob/3.14/tutorial/classes.po?plain=1"

rel="nofollow">顯示翻譯原始碼</a>

</li>

</ul>

</div>

</nav>

</div>

<ul>

<a href="../genindex.html" title="總索引"

accesskey="I">索引</a></li>

<a href="../py-modindex.html" title="Python 模組索引"

>模組</a> |</li>

<a href="stdlib.html" title="10. Python 標準函式庫概覽"

accesskey="N">下一頁</a> |</li>

<a href="errors.html" title="8. 錯誤和例外"

accesskey="P">上一頁</a> |</li>

<li><a href="https://www.python.org/">Python</a> »</li>

</li>

<li>

</li>

<a href="../index.html">3.14.3 Documentation</a> »

</li>

<li class="nav-item nav-item-1"><a href="index.html" accesskey="U">Python 教學</a> »</li>

<li class="nav-item nav-item-this"><a href="">9. Class（類別）</a></li>

</form>

</div>

</li>

主題

</select>

</label> |</li>

</ul>

</div>

<h1>9. Class（類別）<a class="headerlink" href="#classes" title="連結到這個標頭">¶</a></h1>

Class 提供了一種結合資料與功能的手段。建立一個 class 將會新增一個物件的型別 (type)，並且允許建立該型別的新實例 (instance)。每一個 class 實例可以擁有一些維持該實例狀態的屬性 (attribute)。Class 實例也可以有一些（由其 class 所定義的）method（方法），用於修改該實例的狀態。

與其他程式語言相比，Python 的 class 機制為 class 增加了最少的新語法跟語意。他混合了 C++ 和 Modula-3 的 class 機制。Python 的 class 提供了所有物件導向程式設計 (Object Oriented Programming) 的標準特色：class 繼承機制允許多個 base class（基底類別），一個 derived class（衍生類別）可以覆寫 (override) 其 base class 的任何 method，且一個 method 可以用相同的名稱呼叫其 base class 的 method。物件可以包含任意數量及任意種類的資料。如同模組一樣，class 也具有 Python 的動態特性：他們在執行期 (runtime) 被建立，且可以在建立之後被修改。

在 C++ 的術語中，class 成員（包含資料成員）通常都是公開的（除了以下內容：<a class="reference internal" href="#tut-private">私有變數</a>），而所有的成員函式都是虛擬的。如同在 Modula-3 中一樣，Python 並沒有提供簡寫可以從物件的 method 裡參照其成員：method 函式與一個外顯的 (explicit)、第一個代表物件的引數被宣告，而此引數是在呼叫時隱性地 (implicitly) 被提供。如同在 Smalltak 中，class 都是物件，這為 import 及重新命名提供了語意。不像 C++ 和 Modula-3，Pyhon 內建的型別可以被使用者以 base class 用於其他擴充 (extension)。另外，如同在 C++ 中，大多數有著特別語法的內建運算子（算術運算子、下標等）都可以為了 class 實例而被重新定義。

（由於缺乏普遍能接受的術語來討論 class，我偶爾會使用 Smalltalk 和 C++ 的術語。我會使用 Modula-3 的術語，因為它比 C++ 更接近 Python 的物件導向語意，但我預期比較少的讀者會聽過它。）

<h2>9.1. 關於名稱與物件的一段話<a class="headerlink" href="#a-word-about-names-and-objects" title="連結到這個標頭">¶</a></h2>

物件有個體性 (individuality)，且多個名稱（在多個作用域 (scope) ）可以被連結到相同的物件。這在其他語言中被稱為別名 (aliasing)。初次接觸 Python 時通常不會注意這件事，而在處理不可變的基本型別（數值、字串、tuple）時，它也可以安全地被忽略。然而，別名在含有可變物件（如 list（串列）、dictionary（字典）、和大多數其他的型別）的 Python 程式碼語意中，可能會有意外的效果。這通常有利於程式，因為別名在某些方面表現得像指標 (pointer)。舉例來說，在實作時傳遞一個物件是便宜的，因為只有指標被傳遞；假如函式修改了一個作為引數傳遞的物件，呼叫函式者 (caller) 能夠見到這些改變——這消除了在 Pascal 中兩個相異引數傳遞機制的需求。

</section>

<h2>9.2. Python 作用域 (Scope) 及命名空間 (Namespace)<a class="headerlink" href="#python-scopes-and-namespaces" title="連結到這個標頭">¶</a></h2>

在介紹 class 之前，我必須先告訴你一些關於 Python 作用域的規則。Class definition（類別定義）以命名空間展現了一些俐落的技巧，而你需要了解作用域和命名空間的運作才能完整理解正在發生的事情。順帶一提，關於這個主題的知識對任何進階的 Python 程式設計師都是很有用的。

讓我們從一些定義開始。

命名空間是從名稱到物件的對映。大部分的命名空間現在都是以 Python 的 dictionary 被實作，但通常不會以任何方式被察覺（除了性能），且它可能會在未來改變。命名空間的例子有：內建名稱的集合（包含如 <a class="reference internal" href="../library/functions.html#abs" title="abs"><code class="xref py py-func docutils literal notranslate">abs()</code></a> 的函式，和內建的例外名稱）；模組中的全域 (global) 名稱；和在函式呼叫中的區域 (local) 名稱。某種意義上，物件中的屬性集合也會形成一個命名空間。關於命名空間的重要一點是，不同命名空間中的名稱之間絕對沒有關係；舉例來說，兩個不一樣的模組都可以定義一個 <code class="docutils literal notranslate">maximize</code> 函式而不會混淆——模組的使用者必須為它加上前綴 (prefix) 模組名稱。

順帶一提，我使用屬性 (attribute) 這個字，統稱句號 (dot) 後面的任何名稱——例如，運算式中的 <code class="docutils literal notranslate">z.real</code>，<code class="docutils literal notranslate">real</code> 是物件 <code class="docutils literal notranslate">z</code> 的一個屬性。嚴格來說，模組中名稱的參照都是屬性參照：在運算式 <code class="docutils literal notranslate">modname.funcname</code> 中，<code class="docutils literal notranslate">modname</code> 是模組物件而 <code class="docutils literal notranslate">funcname</code> 是它的屬性。在這種情況下，模組的屬性和模組中定義的全域名稱碰巧有一個直接的對映：他們共享了相同的命名空間！<a class="footnote-reference brackets" href="#id2" id="id1" role="doc-noteref">[1]</a>

屬性可以是唯讀的或可寫的。在後者的情況下，對屬性的賦值是可能的。模組屬性是可寫的：你可以寫 <code class="docutils literal notranslate">modname.the_answer = 42</code>。可寫屬性也可以用 <a class="reference internal" href="../reference/simple_stmts.html#del"><code class="xref std std-keyword docutils literal notranslate">del</code></a> 陳述式刪除。例如，<code class="docutils literal notranslate">del modname.the_answer</code> 將從名為 <code class="docutils literal notranslate">modname</code> 的物件中刪除屬性 <code class="xref py py-attr docutils literal notranslate">the_answer</code>。

命名空間在不同的時刻被建立，並且有不同的壽命。當 Python 直譯器啟動時，含有內建名稱的命名空間會被建立，並且永遠不會被刪除。當模組定義被讀入時，模組的全域命名空間會被建立；一般情況下，模組的命名空間也會持續到直譯器結束。被直譯器的頂層呼叫 (top-level invocation) 執行的陳述式，不論是從腳本檔案讀取的或是互動模式中的，會被視為一個稱為 <a class="reference internal" href="../library/__main__.html#module-__main__" title="__main__: The environment where top-level code is run. Covers command-line interfaces, import-time behavior, and ``__name__ == '__main__'``."><code class="xref py py-mod docutils literal notranslate">__main__</code></a> 的模組的一部分，因此它們具有自己的全域命名空間。（內建名稱實際上也存在一個模組中，它被稱為 <a class="reference internal" href="../library/builtins.html#module-builtins" title="builtins: The module that provides the built-in namespace."><code class="xref py py-mod docutils literal notranslate">builtins</code></a>。）

函式的區域命名空間是在呼叫函式時建立的，而當函式回傳，或引發了未在函式中處理的例外時，此命名空間將會被刪除。（實際上，忘記是描述實際發生的事情的更好方法。）當然，每個遞迴呼叫 (recursive invocation) 都有自己的區域命名空間。

作用域是 Python 程式中的一個文本區域 (textual region)，在此區域，命名空間是可直接存取的。這裡的「可直接存取的」意思是，對一個名稱的非限定參照 (unqualified reference) 可以在命名空間內嘗試尋找該名稱。

儘管作用域是靜態地被決定，但它們是動態地被使用的。在執行期間內的任何時間點，都會有 3 或 4 個巢狀的作用域，其命名空間是可以被直接存取的：

<li>最內層作用域，會最先被搜尋，而它包含了區域名稱</li>

<li>任何外圍函式 (enclosing function) 的作用域，會從最近的外圍作用域開始搜尋，它包含了非區域 (non-local) 和非全域 (non-global) 的名稱</li>

<li>倒數第二個作用域，包含目前模組的全域名稱</li>

<li>最外面的作用域（最後搜尋），是包含內建名稱的命名空間</li>

</ul>

如果一個名稱被宣告為全域，則所有的參照和賦值將直接轉到包含模組全域名稱的倒數第二個作用域。要重新連結最內層作用域以外找到的變數，可以使用 <a class="reference internal" href="../reference/simple_stmts.html#nonlocal"><code class="xref std std-keyword docutils literal notranslate">nonlocal</code></a> 陳述式；如果那些變數沒有被宣告為 nonlocal，則它們會是唯讀的（嘗試寫入這樣的變數只會在最內層的作用域內建立一個新的區域變數，同名的外部變數則維持不變）。

通常，區域作用域會參照（文本的）目前函式的區域名稱。在函式外部，區域作用域與全域作用域參照相同的命名空間：模組的命名空間。然而，Class definition 會在區域作用域中放置另一個命名空間。

務必要了解，作用域是按文本被決定的：在模組中定義的函式，其全域作用域便是該模組的命名空間，無論函式是從何處或以什麼別名被呼叫。另一方面，對名稱的實際搜尋是在執行時期 (run time) 動態完成的——但是，語言定義的發展，正朝向在「編譯」時期 (compile time) 的靜態名稱解析 (static name resolution)，所以不要太依賴動態名稱解析 (dynamic name resolution)！（事實上，局部變數已經是靜態地被決定。）

一個 Python 的特殊癖好是——假如沒有 <a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> 或 <a class="reference internal" href="../reference/simple_stmts.html#nonlocal"><code class="xref std std-keyword docutils literal notranslate">nonlocal</code></a> 陳述式的效果——名稱的賦值 (assignment) 都會指向最內層作用域。賦值不會複製資料——它們只會把名稱連結至物件。刪除也是一樣：陳述式 <code class="docutils literal notranslate">del x</code> 會從區域作用域參照的命名空間移除 <code class="docutils literal notranslate">x</code> 的連結。事實上，引入新名稱的所有運算都使用區域作用域：特別是 <a class="reference internal" href="../reference/simple_stmts.html#import"><code class="xref std std-keyword docutils literal notranslate">import</code></a> 陳述式和函式定義，會連結區域作用域內的模組或函式名稱。

<a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> 陳述式可以用來表示特定變數存活在全域作用域，應該被重新綁定到那裡；<a class="reference internal" href="../reference/simple_stmts.html#nonlocal"><code class="xref std std-keyword docutils literal notranslate">nonlocal</code></a> 陳述式表示特定變數存活在外圍作用域內，應該被重新綁定到那裡。

<h3>9.2.1. 作用域和命名空間的範例<a class="headerlink" href="#scopes-and-namespaces-example" title="連結到這個標頭">¶</a></h3>

這是一個範例，演示如何參照不同的作用域和命名空間，以及 <a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> 和 <a class="reference internal" href="../reference/simple_stmts.html#nonlocal"><code class="xref std std-keyword docutils literal notranslate">nonlocal</code></a> 如何影響變數的綁定：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>def scope_test():

def do_local():

spam = "local spam"

def do_nonlocal():

nonlocal spam

spam = "nonlocal spam"

def do_global():

global spam

spam = "global spam"

spam = "test spam"

do_local()

print("After local assignment:", spam)

do_nonlocal()

print("After nonlocal assignment:", spam)

do_global()

print("After global assignment:", spam)

scope_test()

print("In global scope:", spam)

</pre></div>

</div>

範例程式碼的輸出是：

<div class="highlight-none notranslate"><div class="highlight"><pre>After local assignment: test spam

After nonlocal assignment: nonlocal spam

After global assignment: nonlocal spam

In global scope: global spam

</pre></div>

</div>

請注意，區域賦值（預設情況）不會改變 scope_test 對 spam 的連結。<a class="reference internal" href="../reference/simple_stmts.html#nonlocal"><code class="xref std std-keyword docutils literal notranslate">nonlocal</code></a> 賦值改變了 scope_test 對 spam 的連結，而 <a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> 賦值改變了模組層次的連結。

你還可以發現，在 <a class="reference internal" href="../reference/simple_stmts.html#global"><code class="xref std std-keyword docutils literal notranslate">global</code></a> 賦值之前，沒有對 spam 的連結。

</section>

<h2>9.3. 初見 class<a class="headerlink" href="#a-first-look-at-classes" title="連結到這個標頭">¶</a></h2>

Class 採用一些新的語法，三個新的物件型別，以及一些新的語意。

<h3>9.3.1. Class definition（類別定義）語法<a class="headerlink" href="#class-definition-syntax" title="連結到這個標頭">¶</a></h3>

Class definition 最簡單的形式如下：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class ClassName:

<statement-1>

.

<statement-N>

</pre></div>

</div>

Class definition，如同函式定義（<a class="reference internal" href="../reference/compound_stmts.html#def"><code class="xref std std-keyword docutils literal notranslate">def</code></a> 陳述式），必須在它們有任何效果前先執行。（你可以想像把 class definition 放在一個 <a class="reference internal" href="../reference/compound_stmts.html#if"><code class="xref std std-keyword docutils literal notranslate">if</code></a> 陳述式的分支，或在函式裡。）

在實作時，class definition 內的陳述式通常會是函式定義，但其他陳述式也是允許的，有時很有用——我們稍後會回到這裡。Class 中的函式定義通常會有一個獨特的引數列表形式，取決於 method 的呼叫慣例——再一次地，這將會在稍後解釋。

當進入 class definition，一個新的命名空間將會被建立，並且作為區域作用域——因此，所有區域變數的賦值將進入這個新的命名空間。特別是，函式定義會在這裡連結新函式的名稱。

正常地（從結尾處）離開 class definition 時，一個 class 物件會被建立。基本上這是一個包裝器 (wrapper)，裝著 class definition 建立的命名空間內容；我們將在下一節中更加了解 class 物件。原始的區域作用域（在進入 class definition 之前已生效的作用域）會恢復，在此 class 物件會被連結到 class definition 標頭中給出的 class 名稱（在範例中為 <code class="xref py py-class docutils literal notranslate">ClassName</code>）。

</section>

<h3>9.3.2. Class 物件<a class="headerlink" href="#class-objects" title="連結到這個標頭">¶</a></h3>

Class 物件支援兩種運算：屬性參照 (attribute reference) 和實例化 (instantiation)。

屬性參照使用 Python 中所有屬性參照的標準語法：<code class="docutils literal notranslate">obj.name</code>。有效的屬性名稱是 class 物件被建立時，class 的命名空間中所有的名稱。所以，如果 class definition 看起來像這樣：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class MyClass:

"""一個簡單的類別範例"""

i = 12345

def f(self):

return 'hello world'

</pre></div>

</div>

那麼 <code class="docutils literal notranslate">MyClass.i</code> 和 <code class="docutils literal notranslate">MyClass.f</code> 都是有效的屬性參照，會分別回傳一個整數和一個函式物件。Class 屬性也可以被指派 (assign)，所以你可以透過賦值改變 <code class="docutils literal notranslate">MyClass.i</code> 的值。<a class="reference internal" href="../reference/datamodel.html#type.__doc__" title="type.__doc__"><code class="xref py py-attr docutils literal notranslate">__doc__</code></a> 也是一個有效的屬性，會回傳屬於該 class 的說明字串 (docstring)：<code class="docutils literal notranslate">"A simple example class"</code>。

Class 實例化使用了函式記法 (function notation)。就好像 class 物件是一個沒有參數的函式，它回傳一個新的 class 實例。例如（假設是上述的 class）：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>x = MyClass()

</pre></div>

</div>

建立 class 的一個新實例，並將此物件指派給區域變數 <code class="docutils literal notranslate">x</code>。

實例化運算（「呼叫」一個 class 物件）會建立一個空的物件。許多 class 喜歡在建立物件時有著自訂的特定實例初始狀態。因此，class 可以定義一個名為 <a class="reference internal" href="../reference/datamodel.html#object.__init__" title="object.__init__"><code class="xref py py-meth docutils literal notranslate">__init__()</code></a> 的特別 method，像這樣：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>def __init__(self):

self.data = []

</pre></div>

</div>

當 class 定義了 <a class="reference internal" href="../reference/datamodel.html#object.__init__" title="object.__init__"><code class="xref py py-meth docutils literal notranslate">__init__()</code></a> method，class 實例化會為新建的 class 實例自動叫用 <code class="xref py py-meth docutils literal notranslate">__init__()</code>。所以在這個範例中，一個新的、初始化的實例可以如此獲得：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>x = MyClass()

</pre></div>

</div>

當然，<a class="reference internal" href="../reference/datamodel.html#object.__init__" title="object.__init__"><code class="xref py py-meth docutils literal notranslate">__init__()</code></a> method 可能為了更多的彈性而有引數。在這種情況下，要給 class 實例化運算子的引數會被傳遞給 <code class="xref py py-meth docutils literal notranslate">__init__()</code>。例如：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> class Complex:

... def __init__(self, realpart, imagpart):

... self.r = realpart

... self.i = imagpart

...

>>> x = Complex(3.0, -4.5)

>>> x.r, x.i

(3.0, -4.5)

</pre></div>

</div>

</section>

現在，我們可以如何處理實例物件？實例物件能理解的唯一運算就是屬性參照。有兩種有效的屬性名稱：資料屬性 (data attribute) 和 method。

資料屬性對應 Smalltalk 中的「實例變數」，以及 C++ 中的「資料成員」。資料屬性不需要被宣告；和區域變數一樣，它們在第一次被賦值時就會立即存在。例如，如果 <code class="docutils literal notranslate">x</code> 是 <code class="xref py py-class docutils literal notranslate">MyClass</code> 在上述例子中建立的實例，下面的程式碼將印出值 <code class="docutils literal notranslate">16</code>，而不留下蹤跡：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>x.counter = 1

while x.counter < 10:

x.counter = x.counter * 2

print(x.counter)

del x.counter

</pre></div>

</div>

另一種執行個體屬性參考是 方法 (method)。方法是"屬於"一個物件的函式。

實例物件的有效 method 名稱取決於其 class。根據定義，一個 class 中所有的函式物件屬性，就定義了實例的對應 method。所以在我們的例子中，<code class="docutils literal notranslate">x.f</code> 是一個有效的 method 參照，因為 <code class="docutils literal notranslate">MyClass.f</code> 是一個函式，但 <code class="docutils literal notranslate">x.i</code> 不是，因為 <code class="docutils literal notranslate">MyClass.i</code> 不是。但 <code class="docutils literal notranslate">x.f</code> 與 <code class="docutils literal notranslate">MyClass.f</code> 是不一樣的——它是一個 method 物件，而不是函式物件。

</section>

<h3>9.3.4. Method 物件<a class="headerlink" href="#method-objects" title="連結到這個標頭">¶</a></h3>

通常，一個 method 在它被連結後隨即被呼叫：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>x.f()

</pre></div>

</div>

如果像上面一樣 <code class="docutils literal notranslate">x = MyClass()</code>，這將回傳字串 <code class="docutils literal notranslate">'hello world'</code>。然而，並沒有必要立即呼叫一個 method：<code class="docutils literal notranslate">x.f</code> 是一個 method 物件，並且可以被儲藏起來，之後再被呼叫。舉例來說：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>xf = x.f

while True:

print(xf())

</pre></div>

</div>

將會持續印出 <code class="docutils literal notranslate">hello world</code> 直到天荒地老。

當一個 method 被呼叫時究竟會發生什麼事？你可能已經注意到 <code class="docutils literal notranslate">x.f()</code> 被呼叫時沒有任何的引數，儘管 <code class="xref py py-meth docutils literal notranslate">f()</code> 的函式定義有指定一個引數。這個引數發生了什麼事？當一個需要引數的函式被呼叫而沒有給任何引數時，Python 肯定會引發例外——即使該引數實際上沒有被使用...

事實上，你可能已經猜到了答案：method 的特殊之處在於，實例物件會作為函式中的第一個引數被傳遞。在我們的例子中，<code class="docutils literal notranslate">x.f()</code> 這個呼叫等同於 <code class="docutils literal notranslate">MyClass.f(x)</code>。一般來說，呼叫一個有 n 個引數的 method，等同於呼叫一個對應函式，其引數列表 (argument list) 被建立時，會在第一個引數前插入該 method 的實例物件。

一般來說，方法的工作原理如下。當一個實例的非資料屬性被參照時，將會搜尋該實例的 class。如果該名稱是一個有效的 class 屬性，而且是一個函式物件，則對實例物件和函式物件的參照都會被打包到方法物件中。當使用引數串列呼叫方法物件時，會根據實例物件和引數串列來建構一個新的引數串列，並使用該新引數串列來呼叫函式物件。

</section>

<h3>9.3.5. Class 及實例變數<a class="headerlink" href="#class-and-instance-variables" title="連結到這個標頭">¶</a></h3>

一般來說，實例變數用於每一個實例的獨特資料，而 class 變數用於該 class 的所有實例共享的屬性和 method：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Dog:

kind = 'canine' # 所有實例共享的類別變數

def __init__(self, name):

self.name = name # 每個實例獨有的實例變數

>>> d = Dog('Fido')

>>> e = Dog('Buddy')

>>> d.kind # 為所有 Dog 實例所共享

'canine'

>>> e.kind # 為所有 Dog 實例所共享

'canine'

>>> d.name # d 獨有

'Fido'

>>> e.name # e 獨有

'Buddy'

</pre></div>

</div>

如同在<a class="reference internal" href="#tut-object">關於名稱與物件的一段話</a>的討論，共享的資料若涉及 <a class="reference internal" href="../glossary.html#term-mutable">mutable</a> 物件，如 list 和 dictionary，可能會產生意外的影響。舉例來說，下列程式碼的 tricks list 不應該作為一個 class 變數使用，因為這個 list 將會被所有的 Dog 實例所共享：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Dog:

tricks = [] # 誤用類別變數

self.name = name

def add_trick(self, trick):

self.tricks.append(trick)

>>> d = Dog('Fido')

>>> e = Dog('Buddy')

>>> d.add_trick('roll over')

>>> e.add_trick('play dead')

>>> d.tricks # 出乎意料地被所有 dog 共享

['roll over', 'play dead']

</pre></div>

</div>

正確的 class 設計應該使用實例變數：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Dog:

self.name = name

self.tricks = [] # 為每一個 dog 建立空 list

>>> d = Dog('Fido')

>>> e = Dog('Buddy')

>>> d.add_trick('roll over')

>>> e.add_trick('play dead')

>>> d.tricks

['roll over']

>>> e.tricks

['play dead']

</pre></div>

</div>

</section>

<h2>9.4. 隨意的備註<a class="headerlink" href="#random-remarks" title="連結到這個標頭">¶</a></h2>

如果屬性名稱同時出現在一個實例和一個 class 中，則屬性的尋找會以實例為優先：

... purpose = 'storage'

... region = 'west'

...

>>> w1 = Warehouse()

>>> print(w1.purpose, w1.region)

storage west

>>> w2 = Warehouse()

>>> w2.region = 'east'

>>> print(w2.purpose, w2.region)

storage east

</pre></div>

</div>

資料屬性可能被 method 或是被物件的一般使用者（「用戶端」）所參照。也就是說，class 不可用於實作純粹抽象的資料型別。事實上，在 Python 中沒有任何可能的方法，可強制隱藏資料——這都是基於慣例。（另一方面，以 C 編寫的 Python 實作可以完全隱藏實作細節並且在必要時控制物件的存取；這可以被以 C 編寫的 Python 擴充所使用。）

用戶端應該小心使用資料屬性——用戶端可能會因為覆寫他們的資料屬性，而破壞了被 method 維護的不變性。注意，用戶端可以增加他們自己的資料屬性到實例物件，但不影響 method 的有效性，只要避免名稱衝突即可——再一次提醒，命名慣例可以在這裡節省很多麻煩。

在 method 中參照資料屬性（或其他 method！）是沒有簡寫的。我發現這實際上增加了 method 的可閱讀性：在瀏覽 method 時，絕不會混淆區域變數和實例變數。

通常，方法的第一個引數稱為 <code class="docutils literal notranslate">self</code>。這僅僅只是一個慣例：<code class="docutils literal notranslate">self</code> 這個名字對 Python 來說完全沒有特別的意義。但請注意，如果不遵循慣例，你的程式碼可能對其他 Python 程式設計師來說可讀性較低，此外，也可以想像一個可能因信任此慣例而編寫的 class 瀏覽器 (browser) 程式。

任何一個作為 class 屬性的函式物件都為該 class 的實例定義了一個相應的 method。函式定義不一定要包含在 class definition 的文本中：將函式物件指定給 class 中的區域變數也是可以的。例如：

<div class="highlight-python3 notranslate"><div class="highlight"><pre># 在類別以外定義的函式

def f1(self, x, y):

return min(x, x+y)

class C:

f = f1

def g(self):

return 'hello world'

h = g

</pre></div>

</div>

現在 <code class="docutils literal notranslate">f</code>、<code class="docutils literal notranslate">g</code> 和 <code class="docutils literal notranslate">h</code> 都是 class <code class="xref py py-class docutils literal notranslate">C</code> 的屬性，並指向函式物件，所以他們都是class <code class="xref py py-class docutils literal notranslate">C</code> 實例的 method —— <code class="docutils literal notranslate">h</code> 與 <code class="docutils literal notranslate">g</code> 是完全一樣的。請注意，這種做法通常只會使該程式的讀者感到困惑。

Method 可以藉由使用 <code class="docutils literal notranslate">self</code> 引數的 method 屬性，呼叫其他 method：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Bag:

def __init__(self):

self.data = []

def add(self, x):

self.data.append(x)

def addtwice(self, x):

self.add(x)

</pre></div>

</div>

Method 可以用與一般函式相同的方式參照全域名稱。與 method 相關的全域作用域，就是包含其定義的模組。（class 永遠不會被用作全域作用域。）雖然人們很少有在 method 中使用全域資料的充分理由，但全域作用域仍有許多合法的使用：比方說，被 import 至全域作用域的函式和模組，可以被 method 以及在該作用域中定義的函式和 class 所使用。通常，包含 method 的 class，它本身就是被定義在這個全域作用域，在下一節，我們將看到 method 想要參照自己的 class 的一些好原因。

每個值都是一個物件，因此都具有一個 class，也可以稱為它的 type（型別）。它以 <code class="docutils literal notranslate">object.__class__</code> 被儲存。

</section>

<h2>9.5. 繼承 (Inheritance)<a class="headerlink" href="#inheritance" title="連結到這個標頭">¶</a></h2>

當然，如果沒有支援繼承，「class」這個語言特色就不值得被稱為 class。一個 derived class（衍生類別）定義的語法看起來如下：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class DerivedClassName(BaseClassName):

<statement-1>

.

<statement-N>

</pre></div>

</div>

名稱 <code class="xref py py-class docutils literal notranslate">BaseClassName</code> 必須被定義於作用域可及的命名空間，且該作用域要包含 derived class 定義。要代替 base class（基底類別）的名稱，用其他任意的運算式也是被允許的。這會很有用，例如，當一個 base class 是在另一個模組中被定義時：

</pre></div>

</div>

執行 derived class 定義的過程，與執行 base class 相同。當 class 物件被建構時，base class 會被記住。這是用於解析屬性參照：如果一個要求的屬性無法在該 class 中找到，則會繼續在 base class 中搜尋。假如該 base class 本身也是衍生自其他 class，則這個規則會遞迴地被應用。

關於 derived class 的實例化並沒有特別之處：<code class="docutils literal notranslate">DerivedClassName()</code> 會建立該 class 的一個新實例。Method 的參照被解析如下：對應的 class 屬性會被搜尋，如果需要，沿著 base class 的繼承鍊往下走，如果這產生了一個函式物件，則該 method 的參照是有效的。

Derived class 可以覆寫其 base class 的 method。因為 method 在呼叫同一個物件的其他 method 時沒有特別的特權，所以當 base class 的一個 method 在呼叫相同 base class 中定義的另一個 method 時，最終可能會呼叫到一個覆寫它的 derived class 中的 method。（給 C++ 程式設計師：Python 中所有 method 實際上都是 <code class="docutils literal notranslate">virtual</code>。）

一個在 derived class 覆寫的 method 可能事實上是想要擴充而非單純取代 base class 中相同名稱的 method。要直接呼叫 base class 的 method 有一個簡單的方法：只要呼叫 <code class="docutils literal notranslate">BaseClassName.methodname(self, arguments)</code>。這有時對用戶端也很有用。（請注意，只有在 base class 在全域作用域可以用 <code class="docutils literal notranslate">BaseClassName</code> 被存取時，這方法才有效。）

Python 有兩個內建函式可以用於繼承：

<li>使用 <a class="reference internal" href="../library/functions.html#isinstance" title="isinstance"><code class="xref py py-func docutils literal notranslate">isinstance()</code></a> 判斷一個實例的型別：<code class="docutils literal notranslate">isinstance(obj, int)</code> 只有在 <code class="docutils literal notranslate">obj.__class__</code> 是 <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> 或衍伸自 <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> 時，結果才會是 <code class="docutils literal notranslate">True</code>。</li>

<li>使用 <a class="reference internal" href="../library/functions.html#issubclass" title="issubclass"><code class="xref py py-func docutils literal notranslate">issubclass()</code></a> 判斷 class 繼承：<code class="docutils literal notranslate">issubclass(bool, int)</code> 會是 <code class="docutils literal notranslate">True</code>，因為 <a class="reference internal" href="../library/functions.html#bool" title="bool"><code class="xref py py-class docutils literal notranslate">bool</code></a> 是 <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> 的 subclass（子類別）。但是，<code class="docutils literal notranslate">issubclass(float, int)</code> 是 <code class="docutils literal notranslate">False</code>，因為 <a class="reference internal" href="../library/functions.html#float" title="float"><code class="xref py py-class docutils literal notranslate">float</code></a> 並不是 <a class="reference internal" href="../library/functions.html#int" title="int"><code class="xref py py-class docutils literal notranslate">int</code></a> 的 subclass。</li>

</ul>

Python 也支援多重繼承的形式。一個有多個 base class 的 class definition 看起來像這樣子：

<statement-1>

.

<statement-N>

</pre></div>

</div>

在大多數情況下，最簡單的例子裡，你可以這樣思考，對於繼承自 parent class（父類別）的屬性，其搜尋規則為：深度優先、從左到右、在階層裡重疊的相同 class 中不重複搜尋。因此，假如有一個屬性在 <code class="xref py py-class docutils literal notranslate">DerivedClassName</code> 沒有被找到，則在 <code class="xref py py-class docutils literal notranslate">Base1</code> 搜尋它，接著（遞迴地）在 <code class="xref py py-class docutils literal notranslate">Base1</code> 的 base class 中搜尋，假如在那裡又沒有找到的話，會在 <code class="xref py py-class docutils literal notranslate">Base2</code> 搜尋，依此類推。

事實上，它稍微複雜一些；method 的解析順序是動態地變化，以支援對 <a class="reference internal" href="../library/functions.html#super" title="super"><code class="xref py py-func docutils literal notranslate">super()</code></a> 的合作呼叫。這個方式在其他的多重繼承語言中，稱為呼叫下一個方法 (call-next-method)，且比在單一繼承語言中的 super call（超級呼叫）來得更強大。

動態排序是必要的，因為多重繼承的所有情況都表現一或多的菱形關係（其中至少一個 parent class 可以從最底層 class 透過多個路徑存取）。例如，所有的 class 都繼承自 <a class="reference internal" href="../library/functions.html#object" title="object"><code class="xref py py-class docutils literal notranslate">object</code></a>，因此任何多重繼承的情況都提供了多個到達 <a class="reference internal" href="../library/functions.html#object" title="object"><code class="xref py py-class docutils literal notranslate">object</code></a> 的路徑。為了避免 base class 被多次存取，動態演算法以這些方式將搜尋順序線性化 (linearize)：保留每個 class 中規定的從左到右的順序、對每個 parent 只會呼叫一次、使用單調的 (monotonic) 方式（意思是，一個 class 可以被 subclassed（子類別化），而不會影響其 parent 的搜尋優先順序）。總之，這些特性使設計出可靠又可擴充、具有多重繼承的 class 成為可能。更多資訊，請見 <a class="reference internal" href="../howto/mro.html#python-2-3-mro">Python 2.3 方法解析順序</a>。

</section>

「私有」(private) 實例變數，指的是不在物件內部便無法存取的變數，這在 Python 中是不存在的。但是，大多數 Python 的程式碼都遵守一個慣例：前綴為一個底線的名稱（如：<code class="docutils literal notranslate">_spam</code>）應被視為 API （應用程式介面）的非公有 (non-public) 部分（無論它是函式、方法或是資料成員）。這被視為一個實作細節，如有調整，亦不另行通知。

既然 class 私有的成員已有一個有效的用例（即避免名稱與 subclass 定義的名稱衝突），這種機制也存在另一個有限的支援，稱為 name mangling（名稱修飾）。任何格式為 <code class="docutils literal notranslate">__spam</code>（至少兩個前導下底線，最多一個尾隨下底線）的物件名稱 (identifier) 會被文本地被替換為 <code class="docutils literal notranslate">_classname__spam</code>，在此 <code class="docutils literal notranslate">classname</code> 就是去掉前導下底線的目前 class 名稱。只要這個修飾是在 class 的定義之中發生，它就會在不考慮該物件名稱的語法位置的情況下完成。

也參考

參閱<a class="reference internal" href="../reference/expressions.html#private-name-mangling">私有名稱修飾規格</a>的詳情與特殊情況。

</div>

名稱修飾對於讓 subclass 覆寫 method 而不用破壞 class 內部的 method 呼叫，是有幫助的。舉例來說：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Mapping:

self.items_list = []

self.__update(iterable)

def update(self, iterable):

for item in iterable:

self.items_list.append(item)

__update = update # 原始 update() 方法的私有副本

class MappingSubclass(Mapping):

# 為 update() 提供新的函式簽名

# 但不會破壞 __init__()

for item in zip(keys, values):

</pre></div>

</div>

在上例中，就算在 <code class="docutils literal notranslate">MappingSubclass</code> 當中加入 <code class="docutils literal notranslate">__update</code> 識別符，也能順利運作，因為在 <code class="docutils literal notranslate">Mapping</code> class 中，它會被替換為 <code class="docutils literal notranslate">_Mapping__update</code>，而在 <code class="docutils literal notranslate">MappingSubclass</code> class 中，它會被替換為 <code class="docutils literal notranslate">_MappingSubclass__update</code>。

請注意，修飾規則是被設計來避免意外；它仍可能存取或修改一個被視為私有的變數。這在特殊情況下甚至可能很有用，例如在除錯器 (debugger)。

另外也注意，傳遞給 <code class="docutils literal notranslate">exec()</code> 或 <code class="docutils literal notranslate">eval()</code> 的程式碼不會把叫用 class 的名稱視為目前的 class；這和 <code class="docutils literal notranslate">global</code> 陳述式的效果類似，該效果同樣僅限於整體被位元組編譯後 (byte-compiled) 的程式碼。同樣的限制適用於 <code class="docutils literal notranslate">getattr()</code>，<code class="docutils literal notranslate">setattr()</code> 和 <code class="docutils literal notranslate">delattr()</code>，以及直接參照 <code class="docutils literal notranslate">__dict__</code> 時。

</section>

如果有一種資料型別，類似於 Pascal 的「record」或 C 的「struct」，可以將一些有名稱的資料項目捆綁在一起，有時候這會很有用。符合語言習慣的做法是使用 <a class="reference internal" href="../library/dataclasses.html#module-dataclasses" title="dataclasses: Generate special methods on user-defined classes."><code class="xref py py-mod docutils literal notranslate">dataclasses</code></a>：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>from dataclasses import dataclass

@dataclass

class Employee:

name: str

dept: str

salary: int

</pre></div>

</div>

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> john = Employee('john', 'computer lab', 1000)

>>> john.dept

'computer lab'

>>> john.salary

1000

</pre></div>

</div>

用來處理特殊抽象資料型別的一段 Python 程式碼，經常能以傳遞一個 class 來替代，此 class 模擬該資料型別的多種 method。例如，如果你有一個函式，它會從一個檔案物件來格式化某些資料，你也可以定義一個有 <a class="reference internal" href="../library/io.html#io.TextIOBase.read" title="io.TextIOBase.read"><code class="xref py py-meth docutils literal notranslate">read()</code></a> 和 <a class="reference internal" href="../library/io.html#io.TextIOBase.readline" title="io.TextIOBase.readline"><code class="xref py py-meth docutils literal notranslate">readline()</code></a> method 的 class 作為替代方式，從字串緩衝區取得資料，並將其作為引數來傳遞。

<a class="reference internal" href="../reference/datamodel.html#instance-methods">實例的 method 物件</a>也具有屬性：<a class="reference internal" href="../reference/datamodel.html#method.__self__" title="method.__self__"><code class="xref py py-attr docutils literal notranslate">m.__self__</code></a> 就是帶有 method <code class="xref py py-meth docutils literal notranslate">m()</code> 的實例物件，而 <a class="reference internal" href="../reference/datamodel.html#method.__func__" title="method.__func__"><code class="xref py py-attr docutils literal notranslate">m.__func__</code></a> 則是該 method 所對應的<a class="reference internal" href="../reference/datamodel.html#user-defined-funcs">函式物件</a>。

</section>

<h2>9.8. 疊代器 (Iterator)<a class="headerlink" href="#iterators" title="連結到這個標頭">¶</a></h2>

到目前為止，你可能已經注意到大多數的容器 (container) 物件都可以使用 <a class="reference internal" href="../reference/compound_stmts.html#for"><code class="xref std std-keyword docutils literal notranslate">for</code></a> 陳述式來進行迴圈：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>for element in [1, 2, 3]:

print(element)

for element in (1, 2, 3):

print(element)

for key in {'one':1, 'two':2}:

print(key)

for char in "123":

print(char)

for line in open("myfile.txt"):

print(line, end='')

</pre></div>

</div>

這種存取風格清晰、簡潔且方便。疊代器的使用在 Python 中處處可見且用法一致。在幕後，<a class="reference internal" href="../reference/compound_stmts.html#for"><code class="xref std std-keyword docutils literal notranslate">for</code></a> 陳述式會在容器物件上呼叫 <a class="reference internal" href="../library/functions.html#iter" title="iter"><code class="xref py py-func docutils literal notranslate">iter()</code></a>。該函式回傳一個疊代器物件，此物件定義了 <a class="reference internal" href="../library/stdtypes.html#iterator.__next__" title="iterator.__next__"><code class="xref py py-meth docutils literal notranslate">__next__()</code></a> method，而此 method 會逐一存取容器中的元素。當元素用盡時，<a class="reference internal" href="../library/stdtypes.html#iterator.__next__" title="iterator.__next__"><code class="xref py py-meth docutils literal notranslate">__next__()</code></a> 將引發 <a class="reference internal" href="../library/exceptions.html#StopIteration" title="StopIteration"><code class="xref py py-exc docutils literal notranslate">StopIteration</code></a> 例外，來通知 <code class="xref std std-keyword docutils literal notranslate">for</code> 終止迴圈。你可以使用內建函式 <a class="reference internal" href="../library/functions.html#next" title="next"><code class="xref py py-func docutils literal notranslate">next()</code></a> 來呼叫 <a class="reference internal" href="../library/stdtypes.html#iterator.__next__" title="iterator.__next__"><code class="xref py py-meth docutils literal notranslate">__next__()</code></a> method；這個例子展示了它的運作方式：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> s = 'abc'

>>> it = iter(s)

>>> it

<str_iterator object at 0x10c90e650>

>>> next(it)

'a'

>>> next(it)

'b'

>>> next(it)

'c'

>>> next(it)

Traceback (most recent call last):

File "<stdin>", line 1, in <module>

next(it)

StopIteration

</pre></div>

</div>

看過疊代器協定的幕後機制後，在你的 class 加入疊代器的行為就很容易了。定義一個 <a class="reference internal" href="../library/stdtypes.html#container.__iter__" title="container.__iter__"><code class="xref py py-meth docutils literal notranslate">__iter__()</code></a> method 來回傳一個帶有 <a class="reference internal" href="../library/stdtypes.html#iterator.__next__" title="iterator.__next__"><code class="xref py py-meth docutils literal notranslate">__next__()</code></a> method 的物件。如果 class 已定義了 <code class="xref py py-meth docutils literal notranslate">__next__()</code>，則 <code class="xref py py-meth docutils literal notranslate">__iter__()</code> 可以只回傳 <code class="docutils literal notranslate">self</code>：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>class Reverse:

"""用於向後迴圈遍歷序列的疊代器。"""

self.data = data

self.index = len(data)

def __iter__(self):

return self

def __next__(self):

if self.index == 0:

raise StopIteration

self.index = self.index - 1

return self.data[self.index]

</pre></div>

</div>

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> rev = Reverse('spam')

>>> iter(rev)

<__main__.Reverse object at 0x00A1DB50>

>>> for char in rev:

... print(char)

...

m

a

p

s

</pre></div>

</div>

</section>

<h2>9.9. 產生器 (Generator)<a class="headerlink" href="#generators" title="連結到這個標頭">¶</a></h2>

<a class="reference internal" href="../glossary.html#term-generator">產生器</a>是一個用於建立疊代器的簡單而強大的工具。它們的寫法和常規的函式一樣，但當它們要回傳資料時，會使用 <a class="reference internal" href="../reference/simple_stmts.html#yield"><code class="xref std std-keyword docutils literal notranslate">yield</code></a> 陳述式。每次在產生器上呼叫 <a class="reference internal" href="../library/functions.html#next" title="next"><code class="xref py py-func docutils literal notranslate">next()</code></a> 時，它會從上次離開的位置恢復執行（它會記得所有資料值以及上一個被執行的陳述式）。以下範例顯示，建立產生器可以相當地容易：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>def reverse(data):

for index in range(len(data)-1, -1, -1):

yield data[index]

</pre></div>

</div>

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> for char in reverse('golf'):

... print(char)

...

f

l

o

g

</pre></div>

</div>

任何可以用產生器來完成的事，也能用以 class 為基礎的疊代器來完成，如同前一節的描述。而讓產生器的程式碼更為精簡的原因是，<a class="reference internal" href="../library/stdtypes.html#iterator.__iter__" title="iterator.__iter__"><code class="xref py py-meth docutils literal notranslate">__iter__()</code></a> 和 <a class="reference internal" href="../reference/expressions.html#generator.__next__" title="generator.__next__"><code class="xref py py-meth docutils literal notranslate">__next__()</code></a> method 會自動被建立。

另一個關鍵的特性在於，區域變數和執行狀態會在每次呼叫之間自動被儲存。這使得該函式比使用 <code class="docutils literal notranslate">self.index</code> 和 <code class="docutils literal notranslate">self.data</code> 這種實例變數的方式更容易編寫且更為清晰。

除了會自動建立 method 和儲存程式狀態，當產生器終止時，它們還會自動引發 <a class="reference internal" href="../library/exceptions.html#StopIteration" title="StopIteration"><code class="xref py py-exc docutils literal notranslate">StopIteration</code></a>。這些特性結合在一起，使建立疊代器能與編寫常規函式一樣容易。

</section>

<h2>9.10. 產生器運算式<a class="headerlink" href="#generator-expressions" title="連結到這個標頭">¶</a></h2>

某些簡單的產生器可以寫成如運算式一般的簡潔程式碼，所用的語法類似 list comprehension（串列綜合運算），但外層為括號而非方括號。這種運算式被設計用於產生器將立即被外圍函式 (enclosing function) 所使用的情況。產生器運算式與完整的產生器定義相比，程式碼較精簡但功能較少，也比等效的 list comprehension 更為節省記憶體。

例如：

<div class="highlight-python3 notranslate"><div class="highlight"><pre>>>> sum(i*i for i in range(10)) # 平方和

285

>>> xvec = [10, 20, 30]

>>> yvec = [7, 5, 3]

>>> sum(x*y for x,y in zip(xvec, yvec)) # 向量內積

260

>>> unique_words = set(word for line in page for word in line.split())

>>> valedictorian = max((student.gpa, student.name) for student in graduates)

>>> data = 'golf'

>>> list(data[i] for i in range(len(data)-1, -1, -1))

['f', 'l', 'o', 'g']

</pre></div>

</div>

註解

[<a role="doc-backlink" href="#id1">1</a>]

有一個例外。模組物件有一個秘密的唯讀屬性，稱為 <a class="reference internal" href="../reference/datamodel.html#object.__dict__" title="object.__dict__"><code class="xref py py-attr docutils literal notranslate">__dict__</code></a>，它回傳用於實作模組命名空間的 dictionary；<code class="docutils literal notranslate">__dict__</code> 這個名稱是一個屬性但不是全域名稱。顯然，使用此屬性將違反命名空間實作的抽象化，而應該僅限用於事後除錯器 (post-mortem debugger) 之類的東西。

</aside>

</section>

</div>

<div>

<ul>

<li><a class="reference internal" href="#">9. Class（類別）</a><ul>

<li><a class="reference internal" href="#a-word-about-names-and-objects">9.1. 關於名稱與物件的一段話</a></li>

<li><a class="reference internal" href="#python-scopes-and-namespaces">9.2. Python 作用域 (Scope) 及命名空間 (Namespace)</a><ul>

<li><a class="reference internal" href="#scopes-and-namespaces-example">9.2.1. 作用域和命名空間的範例</a></li>

</ul>

</li>

<li><a class="reference internal" href="#a-first-look-at-classes">9.3. 初見 class</a><ul>

<li><a class="reference internal" href="#class-definition-syntax">9.3.1. Class definition（類別定義）語法</a></li>

<li><a class="reference internal" href="#class-objects">9.3.2. Class 物件</a></li>

<li><a class="reference internal" href="#method-objects">9.3.4. Method 物件</a></li>

<li><a class="reference internal" href="#class-and-instance-variables">9.3.5. Class 及實例變數</a></li>

</ul>

</li>

<li><a class="reference internal" href="#random-remarks">9.4. 隨意的備註</a></li>

<li><a class="reference internal" href="#inheritance">9.5. 繼承 (Inheritance)</a><ul>

</ul>

</li>

<li><a class="reference internal" href="#iterators">9.8. 疊代器 (Iterator)</a></li>

<li><a class="reference internal" href="#generators">9.9. 產生器 (Generator)</a></li>

<li><a class="reference internal" href="#generator-expressions">9.10. 產生器運算式</a></li>

</ul>

</li>

</ul>

</div>

<div>

<a href="errors.html"

title="上一章">8. 錯誤和例外</a>

</div>

<div>

<a href="stdlib.html"

title="下一章">10. Python 標準函式庫概覽</a>

</div>

document.addEventListener('DOMContentLoaded', () => {

const title = document.querySelector('meta[property="og:title"]').content;

const elements = document.querySelectorAll('.improvepage');

const pageurl = window.location.href.split('?')[0];

elements.forEach(element => {

const url = new URL(element.href.split('?')[0].replace("-nojs", ""));

url.searchParams.set('pagetitle', title);

url.searchParams.set('pageurl', pageurl);

url.searchParams.set('pagesource', "tutorial/classes.rst");

element.href = url.toString();

});

</script>

<li><a class="improvepage" href="../improve-page-nojs.html">改進此頁面</a></li>

<li>

<a href="https://github.com/python/cpython/blob/main/Doc/tutorial/classes.rst?plain=1"

rel="nofollow">顯示原始碼

</a>

</li>

<li>

<a href="https://github.com/python/python-docs-zh-TW/blob/3.14/tutorial/classes.po?plain=1"

rel="nofollow">顯示翻譯原始碼</a>

</li>

</ul>

</div>

«

</div>

</div>

<ul>

<a href="../genindex.html" title="總索引"

>索引</a></li>

<a href="../py-modindex.html" title="Python 模組索引"

>模組</a> |</li>

<a href="stdlib.html" title="10. Python 標準函式庫概覽"

>下一頁</a> |</li>

<a href="errors.html" title="8. 錯誤和例外"

>上一頁</a> |</li>

<li><a href="https://www.python.org/">Python</a> »</li>

</li>

<li>

</li>

<a href="../index.html">3.14.3 Documentation</a> »

</li>

<li class="nav-item nav-item-1"><a href="index.html" >Python 教學</a> »</li>

<li class="nav-item nav-item-this"><a href="">9. Class（類別）</a></li>

</form>

</div>

</li>

主題

</select>

</label> |</li>

</ul>

</div>

此頁面採用 Python 軟體基金會授權條款第 2 版。

文件中的範例、應用技巧與其他程式碼額外採用了 Zero Clause BSD 授權條款。

更多訊息請見<a href="/license.html">歷史與授權條款</a>。

Python 軟體基金會是一家非營利法人。

最後更新於 2月 26, 2026 (18:25 UTC)。

<a href="/bugs.html">發現 bug</a>？

以 <a href="https://www.sphinx-doc.org/">Sphinx</a>8.2.3建立。

</div>

</body>

</html>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

FilesExpand file tree

classes.html

Latest commit

History

classes.html

File metadata and controls