Viewing: github-redirect.dependabot.com

Repository navigation

More items

Blame

History

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

# SOME DESCRIPTIVE TITLE.

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

# Translators:

# python-doc bot, 2025

# willian ohara, 2026

#, fuzzy

msgid ""

msgstr ""

"Project-Id-Version: Python 3.10\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2026-06-11 21:58+0000\n"

"PO-Revision-Date: 2025-09-22 15:57+0000\n"

"Last-Translator: willian ohara, 2026\n"

"Language-Team: Portuguese (Brazil) (https://app.transifex.com/python-doc/"

"teams/5390/pt_BR/)\n"

"Language: pt_BR\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=3; plural=(n == 0 || n == 1) ? 0 : n != 0 && n % "

"1000000 == 0 ? 1 : 2;\n"

#: ../../c-api/module.rst:6

msgid "Module Objects"

msgstr "Objetos do Mdulo"

#: ../../c-api/module.rst:15

msgid ""

"This instance of :c:type:`PyTypeObject` represents the Python module type. "

"This is exposed to Python programs as ``types.ModuleType``."

msgstr ""

"Esta instncia de :c:type:`PyTypeObject` representa o tipo de mdulo Python. "

"Isso exposto a programas Python como ``types.ModuleType``."

#: ../../c-api/module.rst:21

msgid ""

"Return true if *p* is a module object, or a subtype of a module object. This "

"function always succeeds."

msgstr ""

"Retorna true se *p* for um objeto de mdulo ou um subtipo de um objeto de "

"mdulo. Esta funo sempre bem-sucedida."

#: ../../c-api/module.rst:27

msgid ""

"Return true if *p* is a module object, but not a subtype of :c:data:"

"`PyModule_Type`. This function always succeeds."

msgstr ""

"Retorna true se *p* for um objeto de mdulo, mas no um subtipo de :c:data:"

"`PyModule_Type`. Essa funo sempre bem-sucedida."

#: ../../c-api/module.rst:40

msgid ""

"Return a new module object with the :attr:`__name__` attribute set to "

"*name*. The module's :attr:`__name__`, :attr:`__doc__`, :attr:`__package__`, "

"and :attr:`__loader__` attributes are filled in (all but :attr:`__name__` "

"are set to ``None``); the caller is responsible for providing a :attr:"

"`__file__` attribute."

msgstr ""

"Retorna um novo objeto de mdulo com o atributo :attr:`__name__` definido "

"como *name*. Os atributos de mdulo :attr:`__name__`, :attr:`__doc__`, :attr:"

"`__package__` e :attr:`__loader__` so preenchidos (todos exceto :attr:"

"`__name__` so definidos como ``None``); O chamador responssvel por "

"providenciar um atributo :attr:`__file__`."

#: ../../c-api/module.rst:48

msgid ":attr:`__package__` and :attr:`__loader__` are set to ``None``."

msgstr ":attr:`__package__` e :attr:`__loader__` so definidos como ``None``."

#: ../../c-api/module.rst:54

msgid ""

"Similar to :c:func:`PyModule_NewObject`, but the name is a UTF-8 encoded "

"string instead of a Unicode object."

msgstr ""

"Semelhante a :c:func:`PyModule_NewObject`, mas o nome uma string "

"codificada em UTF-8 em vez de um objeto Unicode."

#: ../../c-api/module.rst:62

msgid ""

"Return the dictionary object that implements *module*'s namespace; this "

"object is the same as the :attr:`~object.__dict__` attribute of the module "

"object. If *module* is not a module object (or a subtype of a module "

"object), :exc:`SystemError` is raised and ``NULL`` is returned."

msgstr ""

"Retorna o objeto dicionrio que implementa o espao de nomes de *module*; "

"este objeto o mesmo que o atributo :attr:`~object.__dict__` do objeto de "

"mdulo. Se *module* no for um objeto de mdulo (ou um subtipo de um objeto "

"de mdulo), :exc:`SystemError` levantada e ``NULL`` retornado."

#: ../../c-api/module.rst:67

msgid ""

"It is recommended extensions use other ``PyModule_*`` and ``PyObject_*`` "

"functions rather than directly manipulate a module's :attr:`~object."

"__dict__`."

msgstr ""

" recomendado que as extenses usem outras funes ``PyModule_*`` e "

"``PyObject_*`` em vez de manipular diretamente o :attr:`~object.__dict__` de "

"um mdulo."

#: ../../c-api/module.rst:78

msgid ""

"Return *module*'s :attr:`__name__` value. If the module does not provide "

"one, or if it is not a string, :exc:`SystemError` is raised and ``NULL`` is "

"returned."

msgstr ""

"Retorna o valor :attr:`__name__` do *mdulo*. Se o mdulo no fornecer um, "

"ou se no for uma string, :exc:`SystemError` levantada e ``NULL`` "

"retornado."

#: ../../c-api/module.rst:86

msgid ""

"Similar to :c:func:`PyModule_GetNameObject` but return the name encoded to "

"``'utf-8'``."

msgstr ""

"Semelhante a :c:func:`PyModule_GetNameObject` mas retorna o nome codificado "

"em ``'utf-8'``"

#: ../../c-api/module.rst:91

msgid ""

"Return the \"state\" of the module, that is, a pointer to the block of "

"memory allocated at module creation time, or ``NULL``. See :c:member:"

"`PyModuleDef.m_size`."

msgstr ""

"Retorna o \"estado\" do mdulo, ou seja, um ponteiro para o bloco de memria "

"alocado no momento de criao do mdulo, ou ``NULL``. Ver :c:member:"

"`PyModuleDef.m_size`."

#: ../../c-api/module.rst:98

msgid ""

"Return a pointer to the :c:type:`PyModuleDef` struct from which the module "

"was created, or ``NULL`` if the module wasn't created from a definition."

msgstr ""

"Retorna um ponteiro para a estrutura :c:type:`PyModuleDef` da qual o mdulo "

"foi criado, ou ``NULL`` se o mdulo no foi criado de uma definio."

#: ../../c-api/module.rst:108

msgid ""

"Return the name of the file from which *module* was loaded using *module*'s :"

"attr:`__file__` attribute. If this is not defined, or if it is not a "

"unicode string, raise :exc:`SystemError` and return ``NULL``; otherwise "

"return a reference to a Unicode object."

msgstr ""

"Retorna o nome do arquivo do qual o *mdulo* foi carregado usando o "

"atributo :attr:`__file__` do *mdulo*. Se no estiver definido, ou se no "

"for uma string unicode, levanta :exc:`SystemError` e retorna ``NULL``; Caso "

"contrrio, retorna uma referncia a um objeto Unicode."

#: ../../c-api/module.rst:118

msgid ""

"Similar to :c:func:`PyModule_GetFilenameObject` but return the filename "

"encoded to 'utf-8'."

msgstr ""

"Semelhante a :c:func:`PyModule_GetFilenameObject` mas retorna o nome do "

"arquivo codificado em 'utf-8'."

#: ../../c-api/module.rst:121

msgid ""

":c:func:`PyModule_GetFilename` raises :c:type:`UnicodeEncodeError` on "

"unencodable filenames, use :c:func:`PyModule_GetFilenameObject` instead."

msgstr ""

#: ../../c-api/module.rst:129

msgid "Initializing C modules"

msgstr "Inicializando mdulos C"

#: ../../c-api/module.rst:131

msgid ""

"Modules objects are usually created from extension modules (shared libraries "

"which export an initialization function), or compiled-in modules (where the "

"initialization function is added using :c:func:`PyImport_AppendInittab`). "

"See :ref:`building` or :ref:`extending-with-embedding` for details."

msgstr ""

"Objetos de mdulos so geralmente criados a partir de mdulos de extenso "

"(bibliotecas compartilhadas que exportam uma funo de inicializao), ou "

"mdulos compilados (onde a funo de inicializao adicionada usando :c:"

"func:`PyImport_AppendInittab`). Ver :ref:`building` ou :ref:`extending-with-"

"embedding` para mais detalhes."

#: ../../c-api/module.rst:136

msgid ""

"The initialization function can either pass a module definition instance to :"

"c:func:`PyModule_Create`, and return the resulting module object, or request "

"\"multi-phase initialization\" by returning the definition struct itself."

msgstr ""

"A funo de inicializao pode passar uma instncia de definio de mdulo "

"para :c:func:`PyModule_Create` e retornar o objeto de mdulo resultante ou "

"solicitar \"inicializao multifsica\" retornando a prpria estrutura de "

"definio."

#: ../../c-api/module.rst:142

msgid ""

"The module definition struct, which holds all information needed to create a "

"module object. There is usually only one statically initialized variable of "

"this type for each module."

msgstr ""

"A estrutura de definio de mdulo, que contm todas as informaes "

"necessria para criar um objeto de mdulo. Geralmente, h apenas uma "

"varivel inicializada estaticamente desse tipo para cada mdulo."

#: ../../c-api/module.rst:148

msgid "Always initialize this member to :const:`PyModuleDef_HEAD_INIT`."

msgstr "Sempre inicializa este membro para :const:`PyModuleDef_HEAD_INIT`."

#: ../../c-api/module.rst:152

msgid "Name for the new module."

msgstr "Nome para o novo mdulo."

#: ../../c-api/module.rst:156

msgid ""

"Docstring for the module; usually a docstring variable created with :c:macro:"

"`PyDoc_STRVAR` is used."

msgstr ""

"Docstring para o mdulo; geralmente uma varivel docstring criada com :c:"

"macro:`PyDoc_STRVAR` usada."

#: ../../c-api/module.rst:161

msgid ""

"Module state may be kept in a per-module memory area that can be retrieved "

"with :c:func:`PyModule_GetState`, rather than in static globals. This makes "

"modules safe for use in multiple sub-interpreters."

msgstr ""

"O estado do mdulo pode ser mantido em uma rea de memria por mdulo que "

"pode ser recuperada com :c:func:`PyModule_GetState`, em vez de em globais "

"estticos. Isso torna os mdulos seguros para uso em vrios "

"subinterpretadores."

#: ../../c-api/module.rst:165

msgid ""

"This memory area is allocated based on *m_size* on module creation, and "

"freed when the module object is deallocated, after the :c:member:`m_free` "

"function has been called, if present."

msgstr ""

#: ../../c-api/module.rst:169

msgid ""

"Setting ``m_size`` to ``-1`` means that the module does not support sub-"

"interpreters, because it has global state."

msgstr ""

"Definir ``m_size`` como ``-1`` significa que o mdulo no oferece suporte a "

"subinterpretadores, porque ele tem estado global."

#: ../../c-api/module.rst:172

msgid ""

"Setting it to a non-negative value means that the module can be re-"

"initialized and specifies the additional amount of memory it requires for "

"its state. Non-negative ``m_size`` is required for multi-phase "

"initialization."

msgstr ""

"Defini-lo como um valor no negativo significa que o mdulo pode ser "

"reinicializado e especifica a quantidade adicional de memria necessria "

"para seu estado. ``m_size`` no negativo necessrio para inicializao "

"multifsica."

#: ../../c-api/module.rst:177

msgid "See :PEP:`3121` for more details."

msgstr "Ver :PEP:`3121` para mais detalhes."

#: ../../c-api/module.rst:181

msgid ""

"A pointer to a table of module-level functions, described by :c:type:"

"`PyMethodDef` values. Can be ``NULL`` if no functions are present."

msgstr ""

"Um ponteiro para uma tabela de funes de nvel de mdulo, descritas por "

"valores :c:type:`PyMethodDef`. Pode ser ``NULL`` se nenhuma funo estiver "

"presente."

#: ../../c-api/module.rst:186

msgid ""

"An array of slot definitions for multi-phase initialization, terminated by a "

"``{0, NULL}`` entry. When using single-phase initialization, *m_slots* must "

"be ``NULL``."

msgstr ""

"Uma matriz de definies de slot para inicializao multifsica, terminada "

"por uma entrada ``{0, NULL}``. Ao usar inicializao monofsica, *m_slots* "

"deve ser ``NULL``."

#: ../../c-api/module.rst:192

msgid ""

"Prior to version 3.5, this member was always set to ``NULL``, and was "

"defined as:"

msgstr ""

"Antes da verso 3.5, esse membro era sempre definido como ``NULL`` e era "

"definido como:"

#: ../../c-api/module.rst:199

msgid ""

"A traversal function to call during GC traversal of the module object, or "

"``NULL`` if not needed."

msgstr ""

"Uma funo de travessia para chamar durante a travessia do GC do objeto do "

"mdulo, ou ``NULL`` se no for necessrio."

#: ../../c-api/module.rst:202 ../../c-api/module.rst:217

#: ../../c-api/module.rst:238

msgid ""

"This function is not called if the module state was requested but is not "

"allocated yet. This is the case immediately after the module is created and "

"before the module is executed (:c:data:`Py_mod_exec` function). More "

"precisely, this function is not called if :c:member:`m_size` is greater than "

"0 and the module state (as returned by :c:func:`PyModule_GetState`) is "

"``NULL``."

msgstr ""

#: ../../c-api/module.rst:209 ../../c-api/module.rst:230

#: ../../c-api/module.rst:245

msgid "No longer called before the module state is allocated."

msgstr "No mais chamado antes que o estado do mdulo seja alocado."

#: ../../c-api/module.rst:214

msgid ""

"A clear function to call during GC clearing of the module object, or "

"``NULL`` if not needed."

msgstr ""

"Uma funo de limpeza para chamar durante a limpeza do GC do objeto do "

"mdulo, ou ``NULL`` se no for necessrio."

#: ../../c-api/module.rst:224

msgid ""

"Like :c:member:`PyTypeObject.tp_clear`, this function is not *always* called "

"before a module is deallocated. For example, when reference counting is "

"enough to determine that an object is no longer used, the cyclic garbage "

"collector is not involved and :c:member:`~PyModuleDef.m_free` is called "

"directly."

msgstr ""

"Assim como :c:member:`PyTypeObject.tp_clear`, esta funo no *sempre* "

"chamada antes de um mdulo ser desalocado. Por exemplo, quando a contagem de "

"referncias suficiente para determinar que um objeto no mais usado, o "

"coletor de lixo cclico no envolvido e :c:member:`~PyModuleDef.m_free` "

"chamado diretamente."

#: ../../c-api/module.rst:235

msgid ""

"A function to call during deallocation of the module object, or ``NULL`` if "

"not needed."

msgstr ""

"Uma funo para ser chamada durante a desalocao do objeto do mdulo, ou "

"``NULL`` se no for necessrio."

#: ../../c-api/module.rst:249

msgid "Single-phase initialization"

msgstr "inicializao de fase nica"

#: ../../c-api/module.rst:251

msgid ""

"The module initialization function may create and return the module object "

"directly. This is referred to as \"single-phase initialization\", and uses "

"one of the following two module creation functions:"

msgstr ""

"A funo de inicializao do mdulo pode criar e retornar o objeto do mdulo "

"diretamente. Isso chamado de \"inicializao de fase nica\" e usa uma das "

"duas funes de criao de mdulo a seguir:"

#: ../../c-api/module.rst:257

msgid ""

"Create a new module object, given the definition in *def*. This behaves "

"like :c:func:`PyModule_Create2` with *module_api_version* set to :const:"

"`PYTHON_API_VERSION`."

msgstr ""

"Cria um novo objeto de mdulo, dada a definio em *def*. Isso se comporta "

"como :c:func:`PyModule_Create2` com *module_api_version* definido como :"

"const:`PYTHON_API_VERSION`"

#: ../../c-api/module.rst:264

msgid ""

"Create a new module object, given the definition in *def*, assuming the API "

"version *module_api_version*. If that version does not match the version of "

"the running interpreter, a :exc:`RuntimeWarning` is emitted."

msgstr ""

#: ../../c-api/module.rst:270

msgid ""

"Most uses of this function should be using :c:func:`PyModule_Create` "

"instead; only use this if you are sure you need it."

msgstr ""

"A maioria dos usos dessa funo deve ser feita com :c:func:"

"`PyModule_Create`; use-o apenas se tiver certeza de que precisa."

#: ../../c-api/module.rst:273

msgid ""

"Before it is returned from in the initialization function, the resulting "

"module object is typically populated using functions like :c:func:"

"`PyModule_AddObjectRef`."

msgstr ""

#: ../../c-api/module.rst:279

msgid "Multi-phase initialization"

msgstr "Inicializao multifsica"

#: ../../c-api/module.rst:281

msgid ""

"An alternate way to specify extensions is to request \"multi-phase "

"initialization\". Extension modules created this way behave more like Python "

"modules: the initialization is split between the *creation phase*, when the "

"module object is created, and the *execution phase*, when it is populated. "

"The distinction is similar to the :py:meth:`__new__` and :py:meth:`__init__` "

"methods of classes."

msgstr ""

#: ../../c-api/module.rst:288

msgid ""

"Unlike modules created using single-phase initialization, these modules are "

"not singletons: if the *sys.modules* entry is removed and the module is re-"

"imported, a new module object is created, and the old module is subject to "

"normal garbage collection -- as with Python modules. By default, multiple "

"modules created from the same definition should be independent: changes to "

"one should not affect the others. This means that all state should be "

"specific to the module object (using e.g. using :c:func:"

"`PyModule_GetState`), or its contents (such as the module's :attr:`__dict__` "

"or individual classes created with :c:func:`PyType_FromSpec`)."

msgstr ""

#: ../../c-api/module.rst:298

msgid ""

"All modules created using multi-phase initialization are expected to "

"support :ref:`sub-interpreters <sub-interpreter-support>`. Making sure "

"multiple modules are independent is typically enough to achieve this."

msgstr ""

#: ../../c-api/module.rst:302

msgid ""

"To request multi-phase initialization, the initialization function "

"(PyInit_modulename) returns a :c:type:`PyModuleDef` instance with non-empty :"

"c:member:`~PyModuleDef.m_slots`. Before it is returned, the ``PyModuleDef`` "

"instance must be initialized with the following function:"

msgstr ""

#: ../../c-api/module.rst:309

msgid ""

"Ensures a module definition is a properly initialized Python object that "

"correctly reports its type and reference count."

msgstr ""

"Garante que uma definio de mdulo um objeto Python devidamente "

"inicializado que reporta corretamente seu tipo e contagem de referncias."

#: ../../c-api/module.rst:312

msgid "Returns *def* cast to ``PyObject*``, or ``NULL`` if an error occurred."

msgstr ""

#: ../../c-api/module.rst:316

msgid ""

"The *m_slots* member of the module definition must point to an array of "

"``PyModuleDef_Slot`` structures:"

msgstr ""

#: ../../c-api/module.rst:323

msgid "A slot ID, chosen from the available values explained below."

msgstr ""

"Um ID de lot, escolhido a partir dos valores disponveis explicados abaixo."

#: ../../c-api/module.rst:327

msgid "Value of the slot, whose meaning depends on the slot ID."

msgstr "Valor do slot, cujo significado depende do ID do slot."

#: ../../c-api/module.rst:331

msgid "The *m_slots* array must be terminated by a slot with id 0."

msgstr ""

#: ../../c-api/module.rst:333

msgid "The available slot types are:"

msgstr "Os tipos de slot disponveis so:"

#: ../../c-api/module.rst:337

msgid ""

"Specifies a function that is called to create the module object itself. The "

"*value* pointer of this slot must point to a function of the signature:"

msgstr ""

#: ../../c-api/module.rst:342

msgid ""

"The function receives a :py:class:`~importlib.machinery.ModuleSpec` "

"instance, as defined in :PEP:`451`, and the module definition. It should "

"return a new module object, or set an error and return ``NULL``."

msgstr ""

#: ../../c-api/module.rst:347

msgid ""

"This function should be kept minimal. In particular, it should not call "

"arbitrary Python code, as trying to import the same module again may result "

"in an infinite loop."

msgstr ""

#: ../../c-api/module.rst:351

msgid ""

"Multiple ``Py_mod_create`` slots may not be specified in one module "

"definition."

msgstr ""

"Mltiplos slots ``Py_mod_create`` podem no estar especificados em uma "

"definio de mdulo."

#: ../../c-api/module.rst:354

msgid ""

"If ``Py_mod_create`` is not specified, the import machinery will create a "

"normal module object using :c:func:`PyModule_New`. The name is taken from "

"*spec*, not the definition, to allow extension modules to dynamically adjust "

"to their place in the module hierarchy and be imported under different names "

"through symlinks, all while sharing a single module definition."

msgstr ""

#: ../../c-api/module.rst:360

msgid ""

"There is no requirement for the returned object to be an instance of :c:type:"

"`PyModule_Type`. Any type can be used, as long as it supports setting and "

"getting import-related attributes. However, only ``PyModule_Type`` instances "

"may be returned if the ``PyModuleDef`` has non-``NULL`` ``m_traverse``, "

"``m_clear``, ``m_free``; non-zero ``m_size``; or slots other than "

"``Py_mod_create``."

msgstr ""

#: ../../c-api/module.rst:369

msgid ""

"Specifies a function that is called to *execute* the module. This is "

"equivalent to executing the code of a Python module: typically, this "

"function adds classes and constants to the module. The signature of the "

"function is:"

msgstr ""

#: ../../c-api/module.rst:376

msgid ""

"If multiple ``Py_mod_exec`` slots are specified, they are processed in the "

"order they appear in the *m_slots* array."

msgstr ""

"Se vrios slots ``Py_mod_exec`` forem especificados, eles sero processados "

"na ordem em que aparecem no vetor *m_slots*."

#: ../../c-api/module.rst:379

msgid "See :PEP:`489` for more details on multi-phase initialization."

msgstr ""

"Ver :PEP:`489` para obter mais detalhes sobre a inicializao multifsica."

#: ../../c-api/module.rst:382

msgid "Low-level module creation functions"

msgstr "Funes de criao de mdulo de baixo nvel"

#: ../../c-api/module.rst:384

msgid ""

"The following functions are called under the hood when using multi-phase "

"initialization. They can be used directly, for example when creating module "

"objects dynamically. Note that both ``PyModule_FromDefAndSpec`` and "

"``PyModule_ExecDef`` must be called to fully initialize a module."

msgstr ""

#: ../../c-api/module.rst:391

msgid ""

"Create a new module object, given the definition in *def* and the ModuleSpec "

"*spec*. This behaves like :c:func:`PyModule_FromDefAndSpec2` with "

"*module_api_version* set to :const:`PYTHON_API_VERSION`."

msgstr ""

#: ../../c-api/module.rst:399

msgid ""

"Create a new module object, given the definition in *def* and the ModuleSpec "

"*spec*, assuming the API version *module_api_version*. If that version does "

"not match the version of the running interpreter, a :exc:`RuntimeWarning` is "

"emitted."

msgstr ""

#: ../../c-api/module.rst:406

msgid ""

"Most uses of this function should be using :c:func:`PyModule_FromDefAndSpec` "

"instead; only use this if you are sure you need it."

msgstr ""

#: ../../c-api/module.rst:413

msgid "Process any execution slots (:c:data:`Py_mod_exec`) given in *def*."

msgstr ""

#: ../../c-api/module.rst:419

msgid ""

"Set the docstring for *module* to *docstring*. This function is called "

"automatically when creating a module from ``PyModuleDef``, using either "

"``PyModule_Create`` or ``PyModule_FromDefAndSpec``."

msgstr ""

#: ../../c-api/module.rst:428

msgid ""

"Add the functions from the ``NULL`` terminated *functions* array to "

"*module*. Refer to the :c:type:`PyMethodDef` documentation for details on "

"individual entries (due to the lack of a shared module namespace, module "

"level \"functions\" implemented in C typically receive the module as their "

"first parameter, making them similar to instance methods on Python classes). "

"This function is called automatically when creating a module from "

"``PyModuleDef``, using either ``PyModule_Create`` or "

"``PyModule_FromDefAndSpec``."

msgstr ""

#: ../../c-api/module.rst:440

msgid "Support functions"

msgstr ""

#: ../../c-api/module.rst:442

msgid ""

"The module initialization function (if using single phase initialization) or "

"a function called from a module execution slot (if using multi-phase "

"initialization), can use the following functions to help initialize the "

"module state:"

msgstr ""

#: ../../c-api/module.rst:449

msgid ""

"Add an object to *module* as *name*. This is a convenience function which "

"can be used from the module's initialization function."

msgstr ""

#: ../../c-api/module.rst:452

msgid ""

"On success, return ``0``. On error, raise an exception and return ``-1``."

msgstr ""

#: ../../c-api/module.rst:454

msgid ""

"Return ``NULL`` if *value* is ``NULL``. It must be called with an exception "

"raised in this case."

msgstr ""

#: ../../c-api/module.rst:457 ../../c-api/module.rst:506

msgid "Example usage::"

msgstr "Exemplo de uso::"

#: ../../c-api/module.rst:471 ../../c-api/module.rst:524

msgid ""

"The example can also be written without checking explicitly if *obj* is "

"``NULL``::"

msgstr ""

"O exemplo tambm pode ser escrito sem verificar explicitamente se *obj* "

"``NULL``::"

#: ../../c-api/module.rst:483 ../../c-api/module.rst:540

msgid ""

"Note that ``Py_XDECREF()`` should be used instead of ``Py_DECREF()`` in this "

"case, since *obj* can be ``NULL``."

msgstr ""

#: ../../c-api/module.rst:491

msgid ""

"Similar to :c:func:`PyModule_AddObjectRef`, but steals a reference to "

"*value* on success (if it returns ``0``)."

msgstr ""

#: ../../c-api/module.rst:494

msgid ""

"The new :c:func:`PyModule_AddObjectRef` function is recommended, since it is "

"easy to introduce reference leaks by misusing the :c:func:"

"`PyModule_AddObject` function."

msgstr ""

#: ../../c-api/module.rst:500

msgid ""

"Unlike other functions that steal references, ``PyModule_AddObject()`` only "

"releases the reference to *value* **on success**."

msgstr ""

#: ../../c-api/module.rst:503

msgid ""

"This means that its return value must be checked, and calling code must :c:"

"func:`Py_DECREF` *value* manually on error."

msgstr ""

#: ../../c-api/module.rst:546

msgid ""

"Add an integer constant to *module* as *name*. This convenience function "

"can be used from the module's initialization function. Return ``-1`` on "

"error, ``0`` on success."

msgstr ""

#: ../../c-api/module.rst:553

msgid ""

"Add a string constant to *module* as *name*. This convenience function can "

"be used from the module's initialization function. The string *value* must "

"be ``NULL``-terminated. Return ``-1`` on error, ``0`` on success."

msgstr ""

#: ../../c-api/module.rst:560

msgid ""

"Add an int constant to *module*. The name and the value are taken from "

"*macro*. For example ``PyModule_AddIntMacro(module, AF_INET)`` adds the int "

"constant *AF_INET* with the value of *AF_INET* to *module*. Return ``-1`` on "

"error, ``0`` on success."

msgstr ""

#: ../../c-api/module.rst:568

msgid "Add a string constant to *module*."

msgstr ""

#: ../../c-api/module.rst:572

msgid ""

"Add a type object to *module*. The type object is finalized by calling "

"internally :c:func:`PyType_Ready`. The name of the type object is taken from "

"the last component of :c:member:`~PyTypeObject.tp_name` after dot. Return "

"``-1`` on error, ``0`` on success."

msgstr ""

#: ../../c-api/module.rst:582

msgid "Module lookup"

msgstr "Pesquisa por mdulos"

#: ../../c-api/module.rst:584

msgid ""

"Single-phase initialization creates singleton modules that can be looked up "

"in the context of the current interpreter. This allows the module object to "

"be retrieved later with only a reference to the module definition."

msgstr ""

#: ../../c-api/module.rst:588

msgid ""

"These functions will not work on modules created using multi-phase "

"initialization, since multiple such modules can be created from a single "

"definition."

msgstr ""

#: ../../c-api/module.rst:593

msgid ""

"Returns the module object that was created from *def* for the current "

"interpreter. This method requires that the module object has been attached "

"to the interpreter state with :c:func:`PyState_AddModule` beforehand. In "

"case the corresponding module object is not found or has not been attached "

"to the interpreter state yet, it returns ``NULL``."

msgstr ""

#: ../../c-api/module.rst:600

msgid ""

"Attaches the module object passed to the function to the interpreter state. "

"This allows the module object to be accessible via :c:func:"

"`PyState_FindModule`."

msgstr ""

#: ../../c-api/module.rst:603

msgid "Only effective on modules created using single-phase initialization."

msgstr ""

#: ../../c-api/module.rst:605

msgid ""

"Python calls ``PyState_AddModule`` automatically after importing a module, "

"so it is unnecessary (but harmless) to call it from module initialization "

"code. An explicit call is needed only if the module's own init code "

"subsequently calls ``PyState_FindModule``. The function is mainly intended "

"for implementing alternative import mechanisms (either by calling it "

"directly, or by referring to its implementation for details of the required "

"state updates)."

msgstr ""

#: ../../c-api/module.rst:613 ../../c-api/module.rst:624

msgid "The caller must hold the GIL."

msgstr "O caller deve possuir o GIL."

#: ../../c-api/module.rst:615

msgid "Return 0 on success or -1 on failure."

msgstr ""

#: ../../c-api/module.rst:621

msgid ""

"Removes the module object created from *def* from the interpreter state. "

"Return 0 on success or -1 on failure."

msgstr ""

Terms
Privacy
Security
Status
Community
Docs
Contact
Manage cookies
Do not share my personal information

Navigation Menu

Repository navigation

Files

module.po

module.po

Navigation Menu

Repository navigation

FilesExpand file tree

Breadcrumbs

module.po

Latest commit

History

Breadcrumbs

module.po

File metadata and controls

Footer

Footer navigation

Files