![[]](https://github.githubassets.com/assets/platform-4ce65ae0bf273ce2.png){kind=link}
![[]](https://github.githubassets.com/assets/platform-dark-ac89fbf373737ed3.png){kind=link}
![[]](https://github.githubassets.com/assets/copilot-e2b89335a66dba00.png){kind=link}
![[]](https://github.githubassets.com/assets/copilot-dark-2b28403b6080e898.png){kind=link}
![[]](https://github.githubassets.com/assets/changelog-fd687bff072883b0.png){kind=link}
![[]](https://github.githubassets.com/assets/changelog-dark-b1c25ae971bd641b.png){kind=link}
![[]](https://github.githubassets.com/assets/universe-a98cd54821b27569.png){kind=link}
{{ message }}
Repository navigation
More items
BlameMore file actions
Latest commit
1555 lines (1360 loc) 66.4 KB
3.10
File metadata and controls
- Code
- Blame
1555 lines (1360 loc) 66.4 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
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
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001-2025, Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
# Translators:
# python-doc bot, 2025
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.10\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-09-22 21:19+0000\n"
"PO-Revision-Date: 2025-09-22 15:56+0000\n"
"Last-Translator: python-doc bot, 2025\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/arg.rst:6
msgid "Parsing arguments and building values"
msgstr "Anlise de argumentos e construo de valores"
#: ../../c-api/arg.rst:8
msgid ""
"These functions are useful when creating your own extensions functions and "
"methods. Additional information and examples are available in :ref:"
"`extending-index`."
msgstr ""
"Essas funes so teis ao criar funes e mtodos das suas extenses. "
"Informaes adicionais e exemplos esto disponveis em :ref:`extending-"
"index`."
#: ../../c-api/arg.rst:12
msgid ""
"The first three of these functions described, :c:func:`PyArg_ParseTuple`, :c:"
"func:`PyArg_ParseTupleAndKeywords`, and :c:func:`PyArg_Parse`, all use "
"*format strings* which are used to tell the function about the expected "
"arguments. The format strings use the same syntax for each of these "
"functions."
msgstr ""
"As trs primeiras funes descritas, :c:func:`PyArg_ParseTuple`, :c:func:"
"`PyArg_ParseTupleAndKeywords`, e :c:func:`PyArg_Parse`, todas usam a *string "
"de formatao* que informam funo sobre os argumentos esperados. As "
"strings de formato usam a mesma sintaxe para cada uma dessas funes."
#: ../../c-api/arg.rst:19
msgid "Parsing arguments"
msgstr "Anlise de argumentos"
#: ../../c-api/arg.rst:21
msgid ""
"A format string consists of zero or more \"format units.\" A format unit "
"describes one Python object; it is usually a single character or a "
"parenthesized sequence of format units. With a few exceptions, a format "
"unit that is not a parenthesized sequence normally corresponds to a single "
"address argument to these functions. In the following description, the "
"quoted form is the format unit; the entry in (round) parentheses is the "
"Python object type that matches the format unit; and the entry in [square] "
"brackets is the type of the C variable(s) whose address should be passed."
msgstr ""
"Uma string de formato consiste em zero ou mais \"unidades de formato\". Uma "
"unidade de formato descreve um objeto Python; geralmente um nico "
"caractere ou uma sequncia entre parnteses de unidades de formato. Com "
"algumas poucas excees, uma unidade de formato que no uma sequncia "
"entre parnteses normalmente corresponde a um nico argumento de endereo "
"para essas funes. Na descrio a seguir, a forma citada a unidade de "
"formato; a entrada em parnteses ( ) o tipo de objeto Python que "
"corresponde unidade de formato; e a entrada em colchetes [ ] o tipo da "
"varivel(s) C cujo endereo deve ser passado."
#: ../../c-api/arg.rst:31
msgid "Strings and buffers"
msgstr "Strings e buffers"
#: ../../c-api/arg.rst:33
msgid ""
"These formats allow accessing an object as a contiguous chunk of memory. You "
"don't have to provide raw storage for the returned unicode or bytes area."
msgstr ""
"Esses formatos permitem acessar um objeto como um pedao contguo de "
"memria. Voc no precisa fornecer armazenamento bruto para a rea de "
"unicode ou bytes retornada."
#: ../../c-api/arg.rst:37
msgid "Unless otherwise stated, buffers are not NUL-terminated."
msgstr "Salvo indicao em contrrio, os buffers no so terminados em NUL."
#: ../../c-api/arg.rst:39
msgid "There are three ways strings and buffers can be converted to C:"
msgstr ""
"Existem trs maneiras pelas quais strings e buffers podem ser convertidos em "
"C:"
#: ../../c-api/arg.rst:41
msgid ""
"Formats such as ``y*`` and ``s*`` fill a :c:type:`Py_buffer` structure. This "
"locks the underlying buffer so that the caller can subsequently use the "
"buffer even inside a :c:type:`Py_BEGIN_ALLOW_THREADS` block without the risk "
"of mutable data being resized or destroyed. As a result, **you have to "
"call** :c:func:`PyBuffer_Release` after you have finished processing the "
"data (or in any early abort case)."
msgstr ""
"Formatos como ``y*`` e ``s*`` esto dentro de uma estrutura :c:type:"
"`Py_buffer`. Isso bloqueia o buffer subjacente para que o chamador possa "
"posteriormente usar o buffer, mesmo dentro de um bloco :c:type:"
"`Py_BEGIN_ALLOW_THREADS` sem que haja o risco de que dados mutveis sejam "
"redimensionados ou destrudos. Dessa forma, **voc precisa chamar** :c:func:"
"`PyBuffer_Release` depois de ter concludo o processamento de dados (ou em "
"qualquer caso de interrupo precoce)."
#: ../../c-api/arg.rst:48
msgid ""
"The ``es``, ``es#``, ``et`` and ``et#`` formats allocate the result buffer. "
"**You have to call** :c:func:`PyMem_Free` after you have finished processing "
"the data (or in any early abort case)."
msgstr ""
"Os formatos ``es``, ``es#``, ``et`` e ``et#`` alocam o buffer resultante. "
"**Voc precisa chamar** :c:func:`PyMem_Free` depois de ter concludo o "
"processamento de dados (ou em qualquer caso de interrupo precoce)."
#: ../../c-api/arg.rst:54
msgid ""
"Other formats take a :class:`str` or a read-only :term:`bytes-like object`, "
"such as :class:`bytes`, and provide a ``const char *`` pointer to its "
"buffer. In this case the buffer is \"borrowed\": it is managed by the "
"corresponding Python object, and shares the lifetime of this object. You "
"won't have to release any memory yourself."
msgstr ""
"Outros formatos usam um :class:`str` ou um :term:`objeto bytes ou similar` "
"somente leitura, como :class:`bytes`, e fornecem um ponteiro ``const char "
"*`` para seu buffer. Nesse caso, o buffer \"emprestado\": ele gerenciado "
"pelo objeto Python correspondente e compartilha o tempo de vida desse "
"objeto. Voc mesmo no precisar liberar nenhuma memria."
#: ../../c-api/arg.rst:61
msgid ""
"To ensure that the underlying buffer may be safely borrowed, the object's :c:"
"member:`PyBufferProcs.bf_releasebuffer` field must be ``NULL``. This "
"disallows common mutable objects such as :class:`bytearray`, but also some "
"read-only objects such as :class:`memoryview` of :class:`bytes`."
msgstr ""
"Para garantir que o buffer subjacente possa ser emprestado com segurana, o "
"campo :c:member:`PyBufferProcs.bf_releasebuffer` do objeto deve ser "
"``NULL``. Isso no permite objetos mutveis comuns, como :class:`bytearray`, "
"mas tambm alguns objetos somente leitura, como :class:`memoryview` ou :"
"class:`bytes`."
#: ../../c-api/arg.rst:67
msgid ""
"Besides this ``bf_releasebuffer`` requirement, there is no check to verify "
"whether the input object is immutable (e.g. whether it would honor a request "
"for a writable buffer, or whether another thread can mutate the data)."
msgstr ""
"Alm desse requisito ``bf_releasebuffer``, no h nenhuma verificao para "
"saber se o objeto de entrada imutvel (por exemplo, se ele atenderia a uma "
"solicitao de um buffer gravvel ou se outro thread pode alterar os dados)."
#: ../../c-api/arg.rst:73
msgid ""
"For all ``#`` variants of formats (``s#``, ``y#``, etc.), the macro :c:macro:"
"`PY_SSIZE_T_CLEAN` must be defined before including :file:`Python.h`. On "
"Python 3.9 and older, the type of the length argument is :c:type:"
"`Py_ssize_t` if the :c:macro:`PY_SSIZE_T_CLEAN` macro is defined, or int "
"otherwise."
msgstr ""
"Para todas as variantes de formatos ``#`` (``s#``, ``y#``, etc.), a macro :c:"
"macro:`PY_SSIZE_T_CLEAN` deve ser definida antes de incluir :file:`Python."
"h`. No Python 3.9 e mais antigo, o tipo do argumento de comprimento :c:"
"type:`Py_ssize_t` se a macro :c:macro:`PY_SSIZE_T_CLEAN` definida, ou int "
"caso contrrio."
#: ../../c-api/arg.rst:98
msgid "``s`` (:class:`str`) [const char \\*]"
msgstr "``s`` (:class:`str`) [const char \\*]"
#: ../../c-api/arg.rst:81
msgid ""
"Convert a Unicode object to a C pointer to a character string. A pointer to "
"an existing string is stored in the character pointer variable whose address "
"you pass. The C string is NUL-terminated. The Python string must not "
"contain embedded null code points; if it does, a :exc:`ValueError` exception "
"is raised. Unicode objects are converted to C strings using ``'utf-8'`` "
"encoding. If this conversion fails, a :exc:`UnicodeError` is raised."
msgstr ""
"Converte um objeto Unicode para um ponteiro em C para uma string. Um "
"ponteiro para uma string existente armazenado na varivel do ponteiro do "
"caractere cujo o endereo que voc est passando. A string em C terminada "
"em NULO. A string no Python no deve conter pontos de cdigo nulo embutidos; "
"se isso acontecer, uma exceo :exc:`ValueError` levantada. Objetos "
"Unicode so convertidos para strings em C usando a codificao ``'utf-8'``. "
"Se essa converso falhar, uma exceo :exc:`UnicodeError` levantada."
#: ../../c-api/arg.rst:90
msgid ""
"This format does not accept :term:`bytes-like objects <bytes-like object>`. "
"If you want to accept filesystem paths and convert them to C character "
"strings, it is preferable to use the ``O&`` format with :c:func:"
"`PyUnicode_FSConverter` as *converter*."
msgstr ""
"Esse formato no aceita :term:`objetos bytes ou similares <bytes-like "
"object>`. Se voc quer aceitar caminhos de sistema de arquivos e convert-"
"los para strings de caracteres em C, prefervel que use o formato ``O&`` "
"com :c:func:`PyUnicode_FSConverter` como *conversor*."
#: ../../c-api/arg.rst:96 ../../c-api/arg.rst:164
msgid ""
"Previously, :exc:`TypeError` was raised when embedded null code points were "
"encountered in the Python string."
msgstr ""
"Anteriormente, a exceo :exc:`TypeError` era levantada quando pontos de "
"cdigo nulo embutidos em string Python eram encontrados."
#: ../../c-api/arg.rst:104
msgid "``s*`` (:class:`str` or :term:`bytes-like object`) [Py_buffer]"
msgstr "``s*`` (:class:`str` ou :term:`objeto bytes ou similar`) [Py_buffer]"
#: ../../c-api/arg.rst:101
msgid ""
"This format accepts Unicode objects as well as bytes-like objects. It fills "
"a :c:type:`Py_buffer` structure provided by the caller. In this case the "
"resulting C string may contain embedded NUL bytes. Unicode objects are "
"converted to C strings using ``'utf-8'`` encoding."
msgstr ""
"Esse formato aceita tanto objetos Unicode quanto objetos bytes ou similares. "
"Preenche uma estrutura :c:type:`Py_buffer` fornecida pelo chamador. Nesse "
"caso, a string em C resultante pode conter bytes NUL embutidos. Objetos "
"Unicode so convertidos para strings em C usando codificao ``'utf-8'``."
#: ../../c-api/arg.rst:111
msgid ""
"``s#`` (:class:`str`, read-only :term:`bytes-like object`) [const char \\*, :"
"c:type:`Py_ssize_t`]"
msgstr ""
"``s#`` (:class:`str`, :term:`objeto bytes ou similar <bytes-like object>` "
"somente leitura) [const char \\*, :c:type:`Py_ssize_t`]"
#: ../../c-api/arg.rst:107
msgid ""
"Like ``s*``, except that it provides a :ref:`borrowed buffer <c-arg-borrowed-"
"buffer>`. The result is stored into two C variables, the first one a pointer "
"to a C string, the second one its length. The string may contain embedded "
"null bytes. Unicode objects are converted to C strings using ``'utf-8'`` "
"encoding."
msgstr ""
"Como ``s*``, exceto que no fornece um :ref:`buffer emprestado <c-arg-"
"borrowed-buffer>`. O resultado armazenado em duas variveis em C, a "
"primeira um ponteiro para uma string em C, a segunda o tamanho. A string "
"pode conter bytes nulos embutidos. Objetos Unicode so convertidos para "
"strings em C usando codificao ``'utf-8'``."
#: ../../c-api/arg.rst:115 ../../c-api/arg.rst:584
msgid "``z`` (:class:`str` or ``None``) [const char \\*]"
msgstr "``z`` (:class:`str` ou ``None``) [const char \\*]"
#: ../../c-api/arg.rst:114
msgid ""
"Like ``s``, but the Python object may also be ``None``, in which case the C "
"pointer is set to ``NULL``."
msgstr ""
"Como ``s``, mas o objeto Python tambm pode ser ``None``, caso em que o "
"ponteiro C definido como ``NULL``."
#: ../../c-api/arg.rst:119
msgid ""
"``z*`` (:class:`str`, :term:`bytes-like object` or ``None``) [Py_buffer]"
msgstr ""
"``z*`` (:class:`str`, :term:`objeto bytes ou similar` ou ``None``) "
"[Py_buffer]"
#: ../../c-api/arg.rst:118
msgid ""
"Like ``s*``, but the Python object may also be ``None``, in which case the "
"``buf`` member of the :c:type:`Py_buffer` structure is set to ``NULL``."
msgstr ""
"Como ``s*``, mas o objeto Python tambm pode ser ``None``, caso em que o "
"membro ``buf`` da estrutura :c:type:`Py_buffer` definida como ``NULL``."
#: ../../c-api/arg.rst:123
msgid ""
"``z#`` (:class:`str`, read-only :term:`bytes-like object` or ``None``) "
"[const char \\*, :c:type:`Py_ssize_t`]"
msgstr ""
"``z#`` (:class:`str`, :term:`objeto bytes ou similar` somente leitura ou "
"``None``) [const char \\*, :c:type:`Py_ssize_t`]"
#: ../../c-api/arg.rst:122
msgid ""
"Like ``s#``, but the Python object may also be ``None``, in which case the C "
"pointer is set to ``NULL``."
msgstr ""
"Como ``s#``, mas o objeto Python tambm pode ser ``None``, caso em que o "
"ponteiro C definido como ``NULL``."
#: ../../c-api/arg.rst:134
msgid "``y`` (read-only :term:`bytes-like object`) [const char \\*]"
msgstr ""
"``y`` (:term:`objeto bytes ou similar` somente leitura) [const char \\*]"
#: ../../c-api/arg.rst:126
msgid ""
"This format converts a bytes-like object to a C pointer to a :ref:`borrowed "
"<c-arg-borrowed-buffer>` character string; it does not accept Unicode "
"objects. The bytes buffer must not contain embedded null bytes; if it does, "
"a :exc:`ValueError` exception is raised."
msgstr ""
"Este formato converte um objeto bytes ou similar para um ponteiro C para uma "
"string de caracteres :ref:`emprestada <c-arg-borrowed-buffer>`; no aceita "
"objetos Unicode. O buffer de bytes no pode conter bytes nulos embutidos; se "
"isso ocorrer uma exceo :exc:`ValueError` ser levantada."
#: ../../c-api/arg.rst:132
msgid ""
"Previously, :exc:`TypeError` was raised when embedded null bytes were "
"encountered in the bytes buffer."
msgstr ""
"Anteriormente, a exceo :exc:`TypeError` era levantada quando pontos de "
"cdigo nulo embutidos em string Python eram encontrados no buffer de bytes."
#: ../../c-api/arg.rst:139
msgid "``y*`` (:term:`bytes-like object`) [Py_buffer]"
msgstr "``y*`` (:term:`objeto bytes ou similar`) [Py_buffer]"
#: ../../c-api/arg.rst:137
msgid ""
"This variant on ``s*`` doesn't accept Unicode objects, only bytes-like "
"objects. **This is the recommended way to accept binary data.**"
msgstr ""
"Esta variante em ``s*`` no aceita objetos unicode, apenas objetos bytes ou "
"similares. **Esta a maneira recomendada para aceitar dados binrios.**"
#: ../../c-api/arg.rst:143
msgid ""
"``y#`` (read-only :term:`bytes-like object`) [const char \\*, :c:type:"
"`Py_ssize_t`]"
msgstr ""
"``y#`` (:term:`objeto bytes ou similar` somente leitura) [const char \\*, :c:"
"type:`Py_ssize_t`]"
#: ../../c-api/arg.rst:142
msgid ""
"This variant on ``s#`` doesn't accept Unicode objects, only bytes-like "
"objects."
msgstr ""
"Esta variao de ``s#`` no aceita objetos Unicode, apenas objetos bytes ou "
"similares."
#: ../../c-api/arg.rst:148
msgid "``S`` (:class:`bytes`) [PyBytesObject \\*]"
msgstr "``S`` (:class:`bytes`) [PyBytesObject \\*]"
#: ../../c-api/arg.rst:146
msgid ""
"Requires that the Python object is a :class:`bytes` object, without "
"attempting any conversion. Raises :exc:`TypeError` if the object is not a "
"bytes object. The C variable may also be declared as :c:expr:`PyObject*`."
msgstr ""
"Exige que o objeto Python seja um objeto :class:`bytes`, sem tentar nenhuma "
"converso. Levanta :exc:`TypeError` se o objeto no for um objeto byte. A "
"varivel C pode ser declarada como :c:expr:`PyObject*`."
#: ../../c-api/arg.rst:153
msgid "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
msgstr "``Y`` (:class:`bytearray`) [PyByteArrayObject \\*]"
#: ../../c-api/arg.rst:151
msgid ""
"Requires that the Python object is a :class:`bytearray` object, without "
"attempting any conversion. Raises :exc:`TypeError` if the object is not a :"
"class:`bytearray` object. The C variable may also be declared as :c:expr:"
"`PyObject*`."
msgstr ""
"Exige que o objeto Python seja um objeto :class:`bytearray`, sem aceitar "
"qualquer converso. Levanta :exc:`TypeError` se o objeto no um objeto :"
"class:`bytearray`. A varivel C apenas pode ser declarada como :c:expr:"
"`PyObject*`."
#: ../../c-api/arg.rst:170
msgid "``u`` (:class:`str`) [const Py_UNICODE \\*]"
msgstr "``u`` (:class:`str`) [const Py_UNICODE \\*]"
#: ../../c-api/arg.rst:156
msgid ""
"Convert a Python Unicode object to a C pointer to a NUL-terminated buffer of "
"Unicode characters. You must pass the address of a :c:type:`Py_UNICODE` "
"pointer variable, which will be filled with the pointer to an existing "
"Unicode buffer. Please note that the width of a :c:type:`Py_UNICODE` "
"character depends on compilation options (it is either 16 or 32 bits). The "
"Python string must not contain embedded null code points; if it does, a :exc:"
"`ValueError` exception is raised."
msgstr ""
"Converte um objeto Python Unicode para um ponteiro C para um buffer de "
"caracteres Unicode terminado em NUL. Voc deve passar o endereo de uma "
"varivel ponteiro :c:type:`Py_UNICODE`, que ser preenchida com um ponteiro "
"para um buffer Unicode existente. Por favor, note que o comprimento de um "
"caractere :c:type:`Py_UNICODE` depende das opes de compilao (est entre "
"16 ou 32 bits). A string Python no deve conter pontos de cdigo nulos "
"incorporados, se isso ocorrer uma exceo :exc:`ValueError` ser levantada."
#: ../../c-api/arg.rst:171 ../../c-api/arg.rst:180 ../../c-api/arg.rst:188
#: ../../c-api/arg.rst:196
msgid ""
"Part of the old-style :c:type:`Py_UNICODE` API; please migrate to using :c:"
"func:`PyUnicode_AsWideCharString`."
msgstr ""
"Parte do estilo antigo :c:type:`Py_UNICODE` API; por favor migre o uso para :"
"c:func:`PyUnicode_AsWideCharString`."
#: ../../c-api/arg.rst:179
msgid "``u#`` (:class:`str`) [const Py_UNICODE \\*, :c:type:`Py_ssize_t`]"
msgstr "``u#`` (:class:`str`) [const Py_UNICODE \\*, :c:type:`Py_ssize_t`]"
#: ../../c-api/arg.rst:173
msgid ""
"This variant on ``u`` stores into two C variables, the first one a pointer "
"to a Unicode data buffer, the second one its length. This variant allows "
"null code points."
msgstr ""
"Esta variante de ``u`` armazena em duas variveis C, a primeira um ponteiro "
"para um buffer Unicode de dados, a segunda para seu comprimento. Esta "
"variante permite ponteiros para nulos."
#: ../../c-api/arg.rst:187
msgid "``Z`` (:class:`str` or ``None``) [const Py_UNICODE \\*]"
msgstr "``Z`` (:class:`str` ou ``None``) [const Py_UNICODE \\*]"
#: ../../c-api/arg.rst:182
msgid ""
"Like ``u``, but the Python object may also be ``None``, in which case the :c:"
"type:`Py_UNICODE` pointer is set to ``NULL``."
msgstr ""
"Como ``u``, mas o objeto Python tambm pode ser ``None``, nesse caso o "
"ponteiro :c:type:`Py_UNICODE` definido como ``NULL``."
#: ../../c-api/arg.rst:195
msgid ""
"``Z#`` (:class:`str` or ``None``) [const Py_UNICODE \\*, :c:type:"
"`Py_ssize_t`]"
msgstr ""
"``Z#`` (:class:`str` ou ``None``) [const Py_UNICODE \\*, :c:type:"
"`Py_ssize_t`]"
#: ../../c-api/arg.rst:190
msgid ""
"Like ``u#``, but the Python object may also be ``None``, in which case the :"
"c:type:`Py_UNICODE` pointer is set to ``NULL``."
msgstr ""
"Como ``u#``, mas o objeto Python tambm pode ser ``None``, nesse caso o "
"ponteiro :c:type:`Py_UNICODE` definido como ``NULL``"
#: ../../c-api/arg.rst:200
msgid "``U`` (:class:`str`) [PyObject \\*]"
msgstr "``U`` (:class:`str`) [PyObject \\*]"
#: ../../c-api/arg.rst:198
msgid ""
"Requires that the Python object is a Unicode object, without attempting any "
"conversion. Raises :exc:`TypeError` if the object is not a Unicode object. "
"The C variable may also be declared as :c:expr:`PyObject*`."
msgstr ""
"Exige que o objeto python seja um objeto Unicode, sem tentar alguma "
"converso. Levanta :exc:`TypeError` se o objeto no for um objeto Unicode. A "
"varivel C deve ser declarada como :c:expr:`PyObject*`."
#: ../../c-api/arg.rst:206
msgid "``w*`` (read-write :term:`bytes-like object`) [Py_buffer]"
msgstr ""
"``w*`` (:term:`objeto bytes ou similar` de leitura e escrita) [Py_buffer]"
#: ../../c-api/arg.rst:203
msgid ""
"This format accepts any object which implements the read-write buffer "
"interface. It fills a :c:type:`Py_buffer` structure provided by the caller. "
"The buffer may contain embedded null bytes. The caller have to call :c:func:"
"`PyBuffer_Release` when it is done with the buffer."
msgstr ""
"Este formato aceita qualquer objeto que implemente a interface do buffer de "
"leitura e escrita. Ele preenche uma estrutura :c:type:`Py_buffer` fornecida "
"pelo chamador. O buffer pode conter bytes nulos incorporados. O chamador "
"deve chamar :c:func:`PyBuffer_Release` quando isso for feito com o buffer."
#: ../../c-api/arg.rst:223
msgid "``es`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer]"
msgstr "``es`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer]"
#: ../../c-api/arg.rst:209
msgid ""
"This variant on ``s`` is used for encoding Unicode into a character buffer. "
"It only works for encoded data without embedded NUL bytes."
msgstr ""
"Esta variante em ``s`` utilizada para codificao do Unicode em um buffer "
"de caracteres. Ele s funciona para dados codificados sem NUL bytes "
"incorporados."
#: ../../c-api/arg.rst:212
msgid ""
"This format requires two arguments. The first is only used as input, and "
"must be a :c:expr:`const char*` which points to the name of an encoding as a "
"NUL-terminated string, or ``NULL``, in which case ``'utf-8'`` encoding is "
"used. An exception is raised if the named encoding is not known to Python. "
"The second argument must be a :c:expr:`char**`; the value of the pointer it "
"references will be set to a buffer with the contents of the argument text. "
"The text will be encoded in the encoding specified by the first argument."
msgstr ""
"Este formato exige dois argumentos. O primeiro usado apenas como entrada e "
"deve ser a :c:expr:`const char*` que aponta para o nome de uma codificao "
"como uma string terminada em NUL ou ``NULL``, nesse caso a codificao "
"``'utf-8'`` usada. Uma exceo levantada se a codificao nomeada no "
"for conhecida pelo Python. O segundo argumento deve ser um :c:expr:`char**`; "
"o valor do ponteiro a que ele faz referncia ser definido como um buffer "
"com o contedo do texto do argumento. O texto ser codificado na codificao "
"especificada pelo primeiro argumento."
#: ../../c-api/arg.rst:220
msgid ""
":c:func:`PyArg_ParseTuple` will allocate a buffer of the needed size, copy "
"the encoded data into this buffer and adjust *\\*buffer* to reference the "
"newly allocated storage. The caller is responsible for calling :c:func:"
"`PyMem_Free` to free the allocated buffer after use."
msgstr ""
":c:func:`PyArg_ParseTuple` alocar um buffer do tamanho necessrio, copiar "
"os dados codificados nesse buffer e ajustar *\\*buffer* para referenciar o "
"armazenamento recm-alocado. O chamador responsvel por chamar :c:func:"
"`PyMem_Free` para liberar o buffer alocado aps o uso."
#: ../../c-api/arg.rst:228
msgid ""
"``et`` (:class:`str`, :class:`bytes` or :class:`bytearray`) [const char "
"\\*encoding, char \\*\\*buffer]"
msgstr ""
"``et`` (:class:`str`, :class:`bytes` ou :class:`bytearray`) [const char "
"\\*encoding, char \\*\\*buffer]"
#: ../../c-api/arg.rst:226
msgid ""
"Same as ``es`` except that byte string objects are passed through without "
"recoding them. Instead, the implementation assumes that the byte string "
"object uses the encoding passed in as parameter."
msgstr ""
"O mesmo que ``es``, exceto que os objetos strings de bytes so passados sem "
"os recodificar. Em vez disso, a implementao presume que o objeto string de "
"bytes usa a codificao passada como parmetro."
#: ../../c-api/arg.rst:259
msgid ""
"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:"
"`Py_ssize_t` \\*buffer_length]"
msgstr ""
"``es#`` (:class:`str`) [const char \\*encoding, char \\*\\*buffer, :c:type:"
"`Py_ssize_t` \\*buffer_length]"
#: ../../c-api/arg.rst:231
msgid ""
"This variant on ``s#`` is used for encoding Unicode into a character buffer. "
"Unlike the ``es`` format, this variant allows input data which contains NUL "
"characters."
msgstr ""
"Essa variante em ``s#`` usada para codificar Unicode em um buffer de "
"caracteres. Diferente do formato ``es``, essa variante permite a entrada de "
"dados que contm caracteres NUL."
#: ../../c-api/arg.rst:235
msgid ""
"It requires three arguments. The first is only used as input, and must be "
"a :c:expr:`const char*` which points to the name of an encoding as a NUL-"
"terminated string, or ``NULL``, in which case ``'utf-8'`` encoding is used. "
"An exception is raised if the named encoding is not known to Python. The "
"second argument must be a :c:expr:`char**`; the value of the pointer it "
"references will be set to a buffer with the contents of the argument text. "
"The text will be encoded in the encoding specified by the first argument. "
"The third argument must be a pointer to an integer; the referenced integer "
"will be set to the number of bytes in the output buffer."
msgstr ""
"Exige trs argumentos. O primeiro usado apenas como entrada e deve ser a :"
"c:expr:`const char*` que aponta para o nome de uma codificao como uma "
"string terminada em NUL ou ``NULL``, nesse caso a codificao ``'utf-8'`` "
"usada. Uma exceo ser gerada se a codificao nomeada no for conhecida "
"pelo Python. O segundo argumento deve ser um :c:expr:`char**`; o valor do "
"ponteiro a que ele faz referncia ser definido como um buffer com o "
"contedo do texto do argumento. O texto ser codificado na codificao "
"especificada pelo primeiro argumento. O terceiro argumento deve ser um "
"ponteiro para um nmero inteiro; o nmero inteiro referenciado ser definido "
"como o nmero de bytes no buffer de sada."
#: ../../c-api/arg.rst:245
msgid "There are two modes of operation:"
msgstr "H dois modos de operao:"
#: ../../c-api/arg.rst:247
msgid ""
"If *\\*buffer* points a ``NULL`` pointer, the function will allocate a "
"buffer of the needed size, copy the encoded data into this buffer and set "
"*\\*buffer* to reference the newly allocated storage. The caller is "
"responsible for calling :c:func:`PyMem_Free` to free the allocated buffer "
"after usage."
msgstr ""
"Se *\\*buffer* apontar um ponteiro ``NULL``, a funo ir alocar um buffer "
"do tamanho necessrio, copiar os dados codificados para dentro desse buffer "
"e configurar *\\*buffer* para referenciar o novo armazenamento alocado. O "
"chamador responsvel por chamar :c:func:`PyMem_Free` para liberar o buffer "
"alocado aps o uso."
#: ../../c-api/arg.rst:252
msgid ""
"If *\\*buffer* points to a non-``NULL`` pointer (an already allocated "
"buffer), :c:func:`PyArg_ParseTuple` will use this location as the buffer and "
"interpret the initial value of *\\*buffer_length* as the buffer size. It "
"will then copy the encoded data into the buffer and NUL-terminate it. If "
"the buffer is not large enough, a :exc:`ValueError` will be set."
msgstr ""
"Se *\\*buffer* apontar para um ponteiro que no seja ``NULL`` (um buffer j "
"alocado), :c:func:`PyArg_ParseTuple` ir usar essa localizao como buffer e "
"interpretar o valor inicial de *\\*buffer_length* como sendo o tamanho do "
"buffer. Depois ela vai copiar os dados codificados para dentro do buffer e "
"termin-lo com NUL. Se o buffer no for suficientemente grande, um :exc:"
"`ValueError` ser definido."
#: ../../c-api/arg.rst:258
msgid ""
"In both cases, *\\*buffer_length* is set to the length of the encoded data "
"without the trailing NUL byte."
msgstr ""
"Em ambos os casos, o *\\*buffer_length* definido como o comprimento dos "
"dados codificados sem o byte NUL direita."
#: ../../c-api/arg.rst:264
msgid ""
"``et#`` (:class:`str`, :class:`bytes` or :class:`bytearray`) [const char "
"\\*encoding, char \\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]"
msgstr ""
"``et#`` (:class:`str`, :class:`bytes` ou :class:`bytearray`) [const char "
"\\*encoding, char \\*\\*buffer, :c:type:`Py_ssize_t` \\*buffer_length]"
#: ../../c-api/arg.rst:262
msgid ""
"Same as ``es#`` except that byte string objects are passed through without "
"recoding them. Instead, the implementation assumes that the byte string "
"object uses the encoding passed in as parameter."
msgstr ""
"O mesmo que ``es#``, exceto que os objetos strings de bytes so passados sem "
"que sejam recodificados. Em vez disso, a implementao presume que o objeto "
"string de bytes usa a codificao passada como parmetro."
#: ../../c-api/arg.rst:267
msgid "Numbers"
msgstr "Nmeros"
#: ../../c-api/arg.rst:271
msgid "``b`` (:class:`int`) [unsigned char]"
msgstr "``b`` (:class:`int`) [unsigned char]"
#: ../../c-api/arg.rst:270
msgid ""
"Convert a nonnegative Python integer to an unsigned tiny int, stored in a C :"
"c:expr:`unsigned char`."
msgstr ""
"Converte um inteiro Python no negativo em um inteiro pequeno sem sinal "
"(unsigned tiny int), armazenado em um :c:expr:`unsigned char` do C."
#: ../../c-api/arg.rst:275 ../../c-api/arg.rst:618
msgid "``B`` (:class:`int`) [unsigned char]"
msgstr "``B`` (:class:`int`) [unsigned char]"
#: ../../c-api/arg.rst:274
msgid ""
"Convert a Python integer to a tiny int without overflow checking, stored in "
"a C :c:expr:`unsigned char`."
msgstr ""
"Converte um inteiro Python para um inteiro pequeno (tiny int) sem "
"verificao de estouro, armazenado em um :c:expr:`unsigned char` do C."
#: ../../c-api/arg.rst:278 ../../c-api/arg.rst:612
msgid "``h`` (:class:`int`) [short int]"
msgstr "``h`` (:class:`int`) [short int]"
#: ../../c-api/arg.rst:278
msgid "Convert a Python integer to a C :c:expr:`short int`."
msgstr "Converte um inteiro Python para um :c:expr:`short int` do C."
#: ../../c-api/arg.rst:282 ../../c-api/arg.rst:621
msgid "``H`` (:class:`int`) [unsigned short int]"
msgstr "``H`` (:class:`int`) [unsigned short int]"
#: ../../c-api/arg.rst:281
msgid ""
"Convert a Python integer to a C :c:expr:`unsigned short int`, without "
"overflow checking."
msgstr ""
"Converte um inteiro Python para um :c:expr:`unsigned short int` do C, sem "
"verificao de estouro."
#: ../../c-api/arg.rst:285 ../../c-api/arg.rst:606
msgid "``i`` (:class:`int`) [int]"
msgstr "``i`` (:class:`int`) [int]"
#: ../../c-api/arg.rst:285
msgid "Convert a Python integer to a plain C :c:expr:`int`."
msgstr "Converte um inteiro Python para um :c:expr:`int` simples do C."
#: ../../c-api/arg.rst:289 ../../c-api/arg.rst:624
msgid "``I`` (:class:`int`) [unsigned int]"
msgstr "``I`` (:class:`int`) [unsigned int]"
#: ../../c-api/arg.rst:288
msgid ""
"Convert a Python integer to a C :c:expr:`unsigned int`, without overflow "
"checking."
msgstr ""
"Converte um inteiro Python para um :c:expr:`unsigned int` do C, sem "
"verificao de estouro."
#: ../../c-api/arg.rst:292 ../../c-api/arg.rst:615
msgid "``l`` (:class:`int`) [long int]"
msgstr "``l`` (:class:`int`) [long int]"
#: ../../c-api/arg.rst:292
msgid "Convert a Python integer to a C :c:expr:`long int`."
msgstr "Converte um inteiro Python para um :c:expr:`long int` do C."
#: ../../c-api/arg.rst:296 ../../c-api/arg.rst:627
msgid "``k`` (:class:`int`) [unsigned long]"
msgstr "``k`` (:class:`int`) [unsigned long]"
#: ../../c-api/arg.rst:295
msgid ""
"Convert a Python integer to a C :c:expr:`unsigned long` without overflow "
"checking."
msgstr ""
"Converte um inteiro Python para um :c:expr:`unsigned long` do C sem "
"verificao de estouro."
#: ../../c-api/arg.rst:299 ../../c-api/arg.rst:630
msgid "``L`` (:class:`int`) [long long]"
msgstr "``L`` (:class:`int`) [longo longo]"
#: ../../c-api/arg.rst:299
msgid "Convert a Python integer to a C :c:expr:`long long`."
msgstr "Converte um inteiro Python para um :c:expr:`long long` do C."
#: ../../c-api/arg.rst:303 ../../c-api/arg.rst:633
msgid "``K`` (:class:`int`) [unsigned long long]"
msgstr "``K`` (:class:`int`) [unsigned long long]"
#: ../../c-api/arg.rst:302
msgid ""
"Convert a Python integer to a C :c:expr:`unsigned long long` without "
"overflow checking."
msgstr ""
"Converte um inteiro Python para um :c:expr:`unsigned long long` do C sem "
"verificao de estouro."
#: ../../c-api/arg.rst:306 ../../c-api/arg.rst:636
msgid "``n`` (:class:`int`) [:c:type:`Py_ssize_t`]"
msgstr "``n`` (:class:`int`) [:c:type:`Py_ssize_t`]"
#: ../../c-api/arg.rst:306
msgid "Convert a Python integer to a C :c:type:`Py_ssize_t`."
msgstr "Converte um inteiro Python para um :c:type:`Py_ssize_t` do C."
#: ../../c-api/arg.rst:313
msgid "``c`` (:class:`bytes` or :class:`bytearray` of length 1) [char]"
msgstr "``c`` (:class:`bytes` ou :class:`bytearray` de comprimento 1) [char]"
#: ../../c-api/arg.rst:309
msgid ""
"Convert a Python byte, represented as a :class:`bytes` or :class:`bytearray` "
"object of length 1, to a C :c:expr:`char`."
msgstr ""
"Converte um byte Python, representado com um objeto :class:`byte` ou :class:"
"`bytearray` de comprimento 1, para um :c:expr:`char` do C."
#: ../../c-api/arg.rst:312
msgid "Allow :class:`bytearray` objects."
msgstr "Permite objetos :class:`bytearray`."
#: ../../c-api/arg.rst:317 ../../c-api/arg.rst:644
msgid "``C`` (:class:`str` of length 1) [int]"
msgstr "``C`` (:class:`str` de comprimento 1) [int]"
#: ../../c-api/arg.rst:316
msgid ""
"Convert a Python character, represented as a :class:`str` object of length "
"1, to a C :c:expr:`int`."
msgstr ""
"Converte um caractere Python, representado como uma :class:`str` objeto de "
"comprimento 1, para um :c:expr:`int` do C"
#: ../../c-api/arg.rst:320 ../../c-api/arg.rst:650
msgid "``f`` (:class:`float`) [float]"
msgstr "``f``` (:class:`float`) [float]"
#: ../../c-api/arg.rst:320
msgid "Convert a Python floating point number to a C :c:expr:`float`."
msgstr ""
"Converte um nmero de ponto flutuante Python para um :c:expr:`float` do C."
#: ../../c-api/arg.rst:323 ../../c-api/arg.rst:647
msgid "``d`` (:class:`float`) [double]"
msgstr "``d`` (:class:`float`) [double]"
#: ../../c-api/arg.rst:323
msgid "Convert a Python floating point number to a C :c:expr:`double`."
msgstr ""
"Converte um nmero de ponto flutuante Python para um :c:expr:`double` do C."
#: ../../c-api/arg.rst:326
msgid "``D`` (:class:`complex`) [Py_complex]"
msgstr "``D`` (:class:`complex`) [Py_complex]"
#: ../../c-api/arg.rst:326
msgid "Convert a Python complex number to a C :c:type:`Py_complex` structure."
msgstr ""
"Converte um nmero complexo Python para uma estrutura C :c:type:`Py_complex`"
#: ../../c-api/arg.rst:329
msgid "Other objects"
msgstr "Outros objetos"
#: ../../c-api/arg.rst:336 ../../c-api/arg.rst:663
msgid "``O`` (object) [PyObject \\*]"
msgstr "``O`` (objeto) [PyObject\\*]"
#: ../../c-api/arg.rst:332
msgid ""
"Store a Python object (without any conversion) in a C object pointer. The C "
"program thus receives the actual object that was passed. A new :term:"
"`strong reference` to the object is not created (i.e. its reference count is "
"not increased). The pointer stored is not ``NULL``."
msgstr ""
"Armazena um objeto Python (sem qualquer converso) em um ponteiro de objeto "
"C. O programa C ento recebe o objeto real que foi passado. Uma nova :term:"
"`referncia forte` ao objeto no criado (isto sua contagem de "
"referncias no aumentada). O ponteiro armazenado no ``NULL``."
#: ../../c-api/arg.rst:343
msgid "``O!`` (object) [*typeobject*, PyObject \\*]"
msgstr "``O!`` (objeto) [*typeobject*, PyObject \\*]"
#: ../../c-api/arg.rst:339
msgid ""
"Store a Python object in a C object pointer. This is similar to ``O``, but "
"takes two C arguments: the first is the address of a Python type object, the "
"second is the address of the C variable (of type :c:expr:`PyObject*`) into "
"which the object pointer is stored. If the Python object does not have the "
"required type, :exc:`TypeError` is raised."
msgstr ""
"Armazena um objeto Python em um ponteiro de objeto C. Isso similar a "
"``O``, mas usa dois argumentos C: o primeiro o endereo de um objeto do "
"tipo Python, o segundo um endereo da varivel C (de tipo :c:expr:"
"`PyObject*`) no qual o ponteiro do objeto est armazenado. Se o objeto "
"Python no tiver o tipo necessrio, :exc:`TypeError` levantada."
#: ../../c-api/arg.rst:368 ../../c-api/arg.rst:677
msgid "``O&`` (object) [*converter*, *anything*]"
msgstr "``O&`` (objeto) [*converter*, *anything*]"
#: ../../c-api/arg.rst:348
msgid ""
"Convert a Python object to a C variable through a *converter* function. "
"This takes two arguments: the first is a function, the second is the address "
"of a C variable (of arbitrary type), converted to :c:expr:`void *`. The "
"*converter* function in turn is called as follows::"
msgstr ""
"Converte um objeto Python em uma varivel C atravs de uma funo "
"*converter*. Isso leva dois argumentos: o primeiro a funo, o segundo o "
"endereo da varivel C (de tipo arbitrrio), convertendo para :c:expr:"
"`void*`. A funo *converter* por sua vez, chamada da seguinte maneira::"
#: ../../c-api/arg.rst:355
msgid ""
"where *object* is the Python object to be converted and *address* is the :c:"
"expr:`void*` argument that was passed to the ``PyArg_Parse*`` function. The "
"returned *status* should be ``1`` for a successful conversion and ``0`` if "
"the conversion has failed. When the conversion fails, the *converter* "
"function should raise an exception and leave the content of *address* "
"unmodified."
msgstr ""
"onde *object* o objeto Python a ser convertido e *address* o argumento :"
"c:expr:`void*` que foi passado para a funo ``PyArg_Parse*``. O *status* "
"retornado deve ser ``1`` para uma converso bem-sucedida e ``0`` se a "
"converso falhar. Quando a converso falha, a funo *converter* deve "
"levantar uma exceo e deixar o contedo de *address* inalterado."
#: ../../c-api/arg.rst:361
msgid ""
"If the *converter* returns ``Py_CLEANUP_SUPPORTED``, it may get called a "
"second time if the argument parsing eventually fails, giving the converter a "
"chance to release any memory that it had already allocated. In this second "
"call, the *object* parameter will be ``NULL``; *address* will have the same "
"value as in the original call."
msgstr ""
"Se o *converter* retornar ``Py_CLEANUP_SUPPORTED``, ele poder ser chamado "
"uma segunda vez se a anlise do argumento eventualmente falhar, dando ao "
"conversor a chance de liberar qualquer memria que j havia alocado. Nesta "
"segunda chamada, o parmetro *object* ser ``NULL``; *address* ter o mesmo "
"valor que na chamada original."
#: ../../c-api/arg.rst:367
msgid "``Py_CLEANUP_SUPPORTED`` was added."
msgstr "109 ``Py_CLEANUP_SUPPORTED`` foi adicionado."
#: ../../c-api/arg.rst:377
msgid "``p`` (:class:`bool`) [int]"
msgstr "``p`` (:class:`bool`) [int]"
#: ../../c-api/arg.rst:371
msgid ""
"Tests the value passed in for truth (a boolean **p**\\ redicate) and "
"converts the result to its equivalent C true/false integer value. Sets the "
"int to ``1`` if the expression was true and ``0`` if it was false. This "
"accepts any valid Python value. See :ref:`truth` for more information about "
"how Python tests values for truth."
msgstr ""
"Testa o valor transmitido para a verdade (um booleano **p**\\ redicado) e "
"converte o resultado em seu valor inteiro C verdadeiro/falso equivalente. "
"Define o int como ``1`` se a expresso for verdadeira e ``0`` se for falsa. "
"Isso aceita qualquer valor vlido do Python. Veja :ref:`truth` para obter "
"mais informaes sobre como o Python testa valores para a verdade."
#: ../../c-api/arg.rst:382 ../../c-api/arg.rst:680
msgid "``(items)`` (:class:`tuple`) [*matching-items*]"
msgstr "``(items)`` (:class:`tuple`) [*matching-items*]"
#: ../../c-api/arg.rst:380
msgid ""
"The object must be a Python sequence whose length is the number of format "
"units in *items*. The C arguments must correspond to the individual format "
"units in *items*. Format units for sequences may be nested."
msgstr ""
"O objeto deve ser uma sequncia Python cujo comprimento seja o nmero de "
"unidades de formato em *items*. Os argumentos C devem corresponder s "
"unidades de formato individuais em *items*. As unidades de formato para "
"sequncias podem ser aninhadas."
#: ../../c-api/arg.rst:384
msgid ""
"It is possible to pass \"long\" integers (integers whose value exceeds the "
"platform's :const:`LONG_MAX`) however no proper range checking is done --- "
"the most significant bits are silently truncated when the receiving field is "
"too small to receive the value (actually, the semantics are inherited from "
"downcasts in C --- your mileage may vary)."
msgstr ""
" possvel passar inteiros \"long\" (inteiros em que o valor excede a "
"constante da plataforma :const:`LONG_MAX`) contudo nenhuma checagem de "
"intervalo propriamente feita --- os bits mais significativos so "
"silenciosamente truncados quando o campo de recebimento muito pequeno para "
"receber o valor (na verdade, a semntica herdada de downcasts no C --- seu "
"raio de ao pode variar)."
#: ../../c-api/arg.rst:390
msgid ""
"A few other characters have a meaning in a format string. These may not "
"occur inside nested parentheses. They are:"
msgstr ""
"Alguns outros caracteres possuem significados na string de formatao. Isso "
"pode no ocorrer dentro de parnteses aninhados. Eles so:"
#: ../../c-api/arg.rst:398
msgid "``|``"
msgstr "``|``"
#: ../../c-api/arg.rst:394
msgid ""
"Indicates that the remaining arguments in the Python argument list are "
"optional. The C variables corresponding to optional arguments should be "
"initialized to their default value --- when an optional argument is not "
"specified, :c:func:`PyArg_ParseTuple` does not touch the contents of the "
"corresponding C variable(s)."
msgstr ""
"Indica que os argumentos restantes na lista de argumentos do Python so "
"opcionais. As variveis C correspondentes a argumentos opcionais devem ser "
"inicializadas para seus valores padro --- quando um argumento opcional no "
" especificado, :c:func:`PyArg_ParseTuple` no toca no contedo da(s) "
"varivel(eis) C correspondente(s)."
#: ../../c-api/arg.rst:407
msgid "``$``"
msgstr "``$``"
#: ../../c-api/arg.rst:401
msgid ""
":c:func:`PyArg_ParseTupleAndKeywords` only: Indicates that the remaining "
"arguments in the Python argument list are keyword-only. Currently, all "
"keyword-only arguments must also be optional arguments, so ``|`` must always "
"be specified before ``$`` in the format string."
msgstr ""
":c:func:`PyArg_ParseTupleAndKeywords` apenas: Indica que os argumentos "
"restantes na lista de argumentos do Python so somente-nomeados. Atualmente, "
"todos os argumentos somente-nomeados devem ser tambm argumentos opcionais, "
"ento ``|`` deve sempre ser especificado antes de ``$`` na string de "
"formatao."
#: ../../c-api/arg.rst:412
msgid "``:``"
Footer
Footer navigation
You cant perform that action at this time.