id.po

# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# 
# Translators:
# oon arfiandwi <oon.arfiandwi@gmail.com>, 2024
# 
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2025-05-09 14:19+0000\n"
"PO-Revision-Date: 2021-06-28 00:49+0000\n"
"Last-Translator: oon arfiandwi <oon.arfiandwi@gmail.com>, 2024\n"
"Language-Team: Indonesian (https://app.transifex.com/python-doc/teams/5390/id/)\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Language: id\n"
"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/long.rst:6
msgid "Integer Objects"
msgstr ""

#: ../../c-api/long.rst:11
msgid ""
"All integers are implemented as \"long\" integer objects of arbitrary size."
msgstr ""

#: ../../c-api/long.rst:13
msgid ""
"On error, most ``PyLong_As*`` APIs return ``(return type)-1`` which cannot "
"be distinguished from a number.  Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""

#: ../../c-api/long.rst:18
msgid "This subtype of :c:type:`PyObject` represents a Python integer object."
msgstr ""

#: ../../c-api/long.rst:23
msgid ""
"This instance of :c:type:`PyTypeObject` represents the Python integer type. "
"This is the same object as :class:`int` in the Python layer."
msgstr ""

#: ../../c-api/long.rst:29
msgid ""
"Return true if its argument is a :c:type:`PyLongObject` or a subtype of "
":c:type:`PyLongObject`.  This function always succeeds."
msgstr ""

#: ../../c-api/long.rst:35
msgid ""
"Return true if its argument is a :c:type:`PyLongObject`, but not a subtype "
"of :c:type:`PyLongObject`.  This function always succeeds."
msgstr ""

#: ../../c-api/long.rst:41
msgid ""
"Return a new :c:type:`PyLongObject` object from *v*, or ``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:43
msgid ""
"The current implementation keeps an array of integer objects for all "
"integers between ``-5`` and ``256``. When you create an int in that range "
"you actually just get back a reference to the existing object."
msgstr ""

#: ../../c-api/long.rst:50
msgid ""
"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long`,"
" or ``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:56
msgid ""
"Return a new :c:type:`PyLongObject` object from a C :c:type:`Py_ssize_t`, or"
" ``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:62
msgid ""
"Return a new :c:type:`PyLongObject` object from a C :c:type:`size_t`, or "
"``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:68
msgid ""
"Return a new :c:type:`PyLongObject` object from a C :c:expr:`long long`, or "
"``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:75
msgid ""
"Return a new :c:type:`PyLongObject` object from a signed C :c:expr:`int32_t`"
" or :c:expr:`int64_t`, or ``NULL`` with an exception set on failure."
msgstr ""

#: ../../c-api/long.rst:84
msgid ""
"Return a new :c:type:`PyLongObject` object from a C :c:expr:`unsigned long "
"long`, or ``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:91
msgid ""
"Return a new :c:type:`PyLongObject` object from an unsigned C "
":c:expr:`uint32_t` or :c:expr:`uint64_t`, or ``NULL`` with an exception set "
"on failure."
msgstr ""

#: ../../c-api/long.rst:100
msgid ""
"Return a new :c:type:`PyLongObject` object from the integer part of *v*, or "
"``NULL`` on failure."
msgstr ""

#: ../../c-api/long.rst:106
msgid ""
"Return a new :c:type:`PyLongObject` based on the string value in *str*, "
"which is interpreted according to the radix in *base*, or ``NULL`` on "
"failure.  If *pend* is non-``NULL``, *\\*pend* will point to the end of "
"*str* on success or to the first character that could not be processed on "
"error.  If *base* is ``0``, *str* is interpreted using the :ref:`integers` "
"definition; in this case, leading zeros in a non-zero decimal number raises "
"a :exc:`ValueError`.  If *base* is not ``0``, it must be between ``2`` and "
"``36``, inclusive.  Leading and trailing whitespace and single underscores "
"after a base specifier and between digits are ignored.  If there are no "
"digits or *str* is not NULL-terminated following the digits and trailing "
"whitespace, :exc:`ValueError` will be raised."
msgstr ""

#: ../../c-api/long.rst:117
msgid ""
":c:func:`PyLong_AsNativeBytes()` and :c:func:`PyLong_FromNativeBytes()` "
"functions can be used to convert a :c:type:`PyLongObject` to/from an array "
"of bytes in base ``256``."
msgstr ""

#: ../../c-api/long.rst:124
msgid ""
"Convert a sequence of Unicode digits in the string *u* to a Python integer "
"value."
msgstr ""

#: ../../c-api/long.rst:132
msgid ""
"Create a Python integer from the pointer *p*. The pointer value can be "
"retrieved from the resulting value using :c:func:`PyLong_AsVoidPtr`."
msgstr ""

#: ../../c-api/long.rst:138
msgid ""
"Create a Python integer from the value contained in the first *n_bytes* of "
"*buffer*, interpreted as a two's-complement signed number."
msgstr ""

#: ../../c-api/long.rst:141
msgid ""
"*flags* are as for :c:func:`PyLong_AsNativeBytes`. Passing ``-1`` will "
"select the native endian that CPython was compiled with and assume that the "
"most-significant bit is a sign bit. Passing "
"``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` will produce the same result as calling"
" :c:func:`PyLong_FromUnsignedNativeBytes`. Other flags are ignored."
msgstr ""

#: ../../c-api/long.rst:152
msgid ""
"Create a Python integer from the value contained in the first *n_bytes* of "
"*buffer*, interpreted as an unsigned number."
msgstr ""

#: ../../c-api/long.rst:155
msgid ""
"*flags* are as for :c:func:`PyLong_AsNativeBytes`. Passing ``-1`` will "
"select the native endian that CPython was compiled with and assume that the "
"most-significant bit is not a sign bit. Flags other than endian are ignored."
msgstr ""

#: ../../c-api/long.rst:168 ../../c-api/long.rst:204
msgid ""
"Return a C :c:expr:`long` representation of *obj*.  If *obj* is not an "
"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__`"
" method (if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:172
msgid ""
"Raise :exc:`OverflowError` if the value of *obj* is out of range for a "
":c:expr:`long`."
msgstr ""

#: ../../c-api/long.rst:175 ../../c-api/long.rst:213 ../../c-api/long.rst:234
#: ../../c-api/long.rst:254 ../../c-api/long.rst:277
msgid ""
"Returns ``-1`` on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""

#: ../../c-api/long.rst:177 ../../c-api/long.rst:215 ../../c-api/long.rst:236
#: ../../c-api/long.rst:258 ../../c-api/long.rst:342 ../../c-api/long.rst:362
msgid "Use :meth:`~object.__index__` if available."
msgstr ""

#: ../../c-api/long.rst:180 ../../c-api/long.rst:218 ../../c-api/long.rst:239
#: ../../c-api/long.rst:261 ../../c-api/long.rst:345 ../../c-api/long.rst:365
msgid "This function will no longer use :meth:`~object.__int__`."
msgstr ""

#: ../../c-api/long.rst:187
msgid ""
"A :term:`soft deprecated` alias. Exactly equivalent to the preferred "
"``PyLong_AsLong``. In particular, it can fail with :exc:`OverflowError` or "
"another exception."
msgstr ""

#: ../../c-api/long.rst:191
msgid "The function is soft deprecated."
msgstr ""

#: ../../c-api/long.rst:196
msgid ""
"Similar to :c:func:`PyLong_AsLong`, but store the result in a C "
":c:expr:`int` instead of a C :c:expr:`long`."
msgstr ""

#: ../../c-api/long.rst:208
msgid ""
"If the value of *obj* is greater than :c:macro:`LONG_MAX` or less than "
":c:macro:`LONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, and"
" return ``-1``; otherwise, set *\\*overflow* to ``0``.  If any other "
"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."
msgstr ""

#: ../../c-api/long.rst:227 ../../c-api/long.rst:245
msgid ""
"Return a C :c:expr:`long long` representation of *obj*.  If *obj* is not an "
"instance of :c:type:`PyLongObject`, first call its :meth:`~object.__index__`"
" method (if present) to convert it to a :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:231
msgid ""
"Raise :exc:`OverflowError` if the value of *obj* is out of range for a "
":c:expr:`long long`."
msgstr ""

#: ../../c-api/long.rst:249
msgid ""
"If the value of *obj* is greater than :c:macro:`LLONG_MAX` or less than "
":c:macro:`LLONG_MIN`, set *\\*overflow* to ``1`` or ``-1``, respectively, "
"and return ``-1``; otherwise, set *\\*overflow* to ``0``.  If any other "
"exception occurs set *\\*overflow* to ``0`` and return ``-1`` as usual."
msgstr ""

#: ../../c-api/long.rst:271
msgid ""
"Return a C :c:type:`Py_ssize_t` representation of *pylong*.  *pylong* must "
"be an instance of :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:274
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
":c:type:`Py_ssize_t`."
msgstr ""

#: ../../c-api/long.rst:286
msgid ""
"Return a C :c:expr:`unsigned long` representation of *pylong*.  *pylong* "
"must be an instance of :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:289
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
":c:expr:`unsigned long`."
msgstr ""

#: ../../c-api/long.rst:292
msgid ""
"Returns ``(unsigned long)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""

#: ../../c-api/long.rst:302
msgid ""
"Return a C :c:type:`size_t` representation of *pylong*.  *pylong* must be an"
" instance of :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:305
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
":c:type:`size_t`."
msgstr ""

#: ../../c-api/long.rst:308
msgid ""
"Returns ``(size_t)-1`` on error. Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""

#: ../../c-api/long.rst:317
msgid ""
"Return a C :c:expr:`unsigned long long` representation of *pylong*.  "
"*pylong* must be an instance of :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:320
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for an "
":c:expr:`unsigned long long`."
msgstr ""

#: ../../c-api/long.rst:323
msgid ""
"Returns ``(unsigned long long)-1`` on error. Use :c:func:`PyErr_Occurred` to"
" disambiguate."
msgstr ""

#: ../../c-api/long.rst:326
msgid ""
"A negative *pylong* now raises :exc:`OverflowError`, not :exc:`TypeError`."
msgstr ""

#: ../../c-api/long.rst:332
msgid ""
"Return a C :c:expr:`unsigned long` representation of *obj*.  If *obj* is not"
" an instance of :c:type:`PyLongObject`, first call its "
":meth:`~object.__index__` method (if present) to convert it to a "
":c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:336
msgid ""
"If the value of *obj* is out of range for an :c:expr:`unsigned long`, return"
" the reduction of that value modulo ``ULONG_MAX + 1``."
msgstr ""

#: ../../c-api/long.rst:339
msgid ""
"Returns ``(unsigned long)-1`` on error.  Use :c:func:`PyErr_Occurred` to "
"disambiguate."
msgstr ""

#: ../../c-api/long.rst:351
msgid ""
"Return a C :c:expr:`unsigned long long` representation of *obj*.  If *obj* "
"is not an instance of :c:type:`PyLongObject`, first call its "
":meth:`~object.__index__` method (if present) to convert it to a "
":c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:356
msgid ""
"If the value of *obj* is out of range for an :c:expr:`unsigned long long`, "
"return the reduction of that value modulo ``ULLONG_MAX + 1``."
msgstr ""

#: ../../c-api/long.rst:359
msgid ""
"Returns ``(unsigned long long)-1`` on error.  Use :c:func:`PyErr_Occurred` "
"to disambiguate."
msgstr ""

#: ../../c-api/long.rst:372
msgid ""
"Set *\\*value* to a signed C :c:expr:`int32_t` or :c:expr:`int64_t` "
"representation of *obj*."
msgstr ""

#: ../../c-api/long.rst:375 ../../c-api/long.rst:396
msgid "If the *obj* value is out of range, raise an :exc:`OverflowError`."
msgstr ""

#: ../../c-api/long.rst:377 ../../c-api/long.rst:398
msgid ""
"Set *\\*value* and return ``0`` on success. Set an exception and return "
"``-1`` on error."
msgstr ""

#: ../../c-api/long.rst:380 ../../c-api/long.rst:401
msgid "*value* must not be ``NULL``."
msgstr ""

#: ../../c-api/long.rst:388
msgid ""
"Set *\\*value* to an unsigned C :c:expr:`uint32_t` or :c:expr:`uint64_t` "
"representation of *obj*."
msgstr ""

#: ../../c-api/long.rst:391
msgid ""
"If *obj* is not an instance of :c:type:`PyLongObject`, first call its "
":meth:`~object.__index__` method (if present) to convert it to a "
":c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:395
msgid "If *obj* is negative, raise a :exc:`ValueError`."
msgstr ""

#: ../../c-api/long.rst:408
msgid ""
"Return a C :c:expr:`double` representation of *pylong*.  *pylong* must be an"
" instance of :c:type:`PyLongObject`."
msgstr ""

#: ../../c-api/long.rst:411
msgid ""
"Raise :exc:`OverflowError` if the value of *pylong* is out of range for a "
":c:expr:`double`."
msgstr ""

#: ../../c-api/long.rst:414
msgid ""
"Returns ``-1.0`` on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""

#: ../../c-api/long.rst:419
msgid ""
"Convert a Python integer *pylong* to a C :c:expr:`void` pointer. If *pylong*"
" cannot be converted, an :exc:`OverflowError` will be raised.  This is only "
"assured to produce a usable :c:expr:`void` pointer for values created with "
":c:func:`PyLong_FromVoidPtr`."
msgstr ""

#: ../../c-api/long.rst:424
msgid ""
"Returns ``NULL`` on error.  Use :c:func:`PyErr_Occurred` to disambiguate."
msgstr ""

#: ../../c-api/long.rst:429
msgid ""
"Copy the Python integer value *pylong* to a native *buffer* of size "
"*n_bytes*. The *flags* can be set to ``-1`` to behave similarly to a C cast,"
" or to values documented below to control the behavior."
msgstr ""

#: ../../c-api/long.rst:433
msgid ""
"Returns ``-1`` with an exception raised on error.  This may happen if "
"*pylong* cannot be interpreted as an integer, or if *pylong* was negative "
"and the ``Py_ASNATIVEBYTES_REJECT_NEGATIVE`` flag was set."
msgstr ""

#: ../../c-api/long.rst:437
msgid ""
"Otherwise, returns the number of bytes required to store the value. If this "
"is equal to or less than *n_bytes*, the entire value was copied. All "
"*n_bytes* of the buffer are written: large buffers are padded with zeroes."
msgstr ""

#: ../../c-api/long.rst:442
msgid ""
"If the returned value is greater than than *n_bytes*, the value was "
"truncated: as many of the lowest bits of the value as could fit are written,"
" and the higher bits are ignored. This matches the typical behavior of a "
"C-style downcast."
msgstr ""

#: ../../c-api/long.rst:449
msgid ""
"Overflow is not considered an error. If the returned value is larger than "
"*n_bytes*, most significant bits were discarded."
msgstr ""

#: ../../c-api/long.rst:452
msgid "``0`` will never be returned."
msgstr ""

#: ../../c-api/long.rst:454
msgid "Values are always copied as two's-complement."
msgstr ""

#: ../../c-api/long.rst:456
msgid "Usage example::"
msgstr ""

#: ../../c-api/long.rst:458
msgid ""
"int32_t value;\n"
"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, &value, sizeof(value), -1);\n"
"if (bytes < 0) {\n"
"    // Failed. A Python exception was set with the reason.\n"
"    return NULL;\n"
"}\n"
"else if (bytes <= (Py_ssize_t)sizeof(value)) {\n"
"    // Success!\n"
"}\n"
"else {\n"
"    // Overflow occurred, but 'value' contains the truncated\n"
"    // lowest bits of pylong.\n"
"}"
msgstr ""

#: ../../c-api/long.rst:472
msgid ""
"Passing zero to *n_bytes* will return the size of a buffer that would be "
"large enough to hold the value. This may be larger than technically "
"necessary, but not unreasonably so. If *n_bytes=0*, *buffer* may be "
"``NULL``."
msgstr ""

#: ../../c-api/long.rst:479
msgid ""
"Passing *n_bytes=0* to this function is not an accurate way to determine the"
" bit length of the value."
msgstr ""

#: ../../c-api/long.rst:482
msgid ""
"To get at the entire Python value of an unknown size, the function can be "
"called twice: first to determine the buffer size, then to fill it::"
msgstr ""

#: ../../c-api/long.rst:485
msgid ""
"// Ask how much space we need.\n"
"Py_ssize_t expected = PyLong_AsNativeBytes(pylong, NULL, 0, -1);\n"
"if (expected < 0) {\n"
"    // Failed. A Python exception was set with the reason.\n"
"    return NULL;\n"
"}\n"
"assert(expected != 0);  // Impossible per the API definition.\n"
"uint8_t *bignum = malloc(expected);\n"
"if (!bignum) {\n"
"    PyErr_SetString(PyExc_MemoryError, \"bignum malloc failed.\");\n"
"    return NULL;\n"
"}\n"
"// Safely get the entire value.\n"
"Py_ssize_t bytes = PyLong_AsNativeBytes(pylong, bignum, expected, -1);\n"
"if (bytes < 0) {  // Exception has been set.\n"
"    free(bignum);\n"
"    return NULL;\n"
"}\n"
"else if (bytes > expected) {  // This should not be possible.\n"
"    PyErr_SetString(PyExc_RuntimeError,\n"
"        \"Unexpected bignum truncation after a size check.\");\n"
"    free(bignum);\n"
"    return NULL;\n"
"}\n"
"// The expected success given the above pre-check.\n"
"// ... use bignum ...\n"
"free(bignum);"
msgstr ""

#: ../../c-api/long.rst:513
msgid ""
"*flags* is either ``-1`` (``Py_ASNATIVEBYTES_DEFAULTS``) to select defaults "
"that behave most like a C cast, or a combination of the other flags in the "
"table below. Note that ``-1`` cannot be combined with other flags."
msgstr ""

#: ../../c-api/long.rst:518
msgid ""
"Currently, ``-1`` corresponds to ``Py_ASNATIVEBYTES_NATIVE_ENDIAN | "
"Py_ASNATIVEBYTES_UNSIGNED_BUFFER``."
msgstr ""

#: ../../c-api/long.rst:524
msgid "Flag"
msgstr "Penanda"

#: ../../c-api/long.rst:524
msgid "Value"
msgstr "Nilai"

#: ../../c-api/long.rst:526
msgid "``-1``"
msgstr ""

#: ../../c-api/long.rst:527
msgid "``0``"
msgstr "``0``"

#: ../../c-api/long.rst:528
msgid "``1``"
msgstr "``1``"

#: ../../c-api/long.rst:529
msgid "``3``"
msgstr "``3``"

#: ../../c-api/long.rst:530
msgid "``4``"
msgstr "``4``"

#: ../../c-api/long.rst:531
msgid "``8``"
msgstr "``8``"

#: ../../c-api/long.rst:532
msgid "``16``"
msgstr ""

#: ../../c-api/long.rst:535
msgid ""
"Specifying ``Py_ASNATIVEBYTES_NATIVE_ENDIAN`` will override any other endian"
" flags. Passing ``2`` is reserved."
msgstr ""

#: ../../c-api/long.rst:538
msgid ""
"By default, sufficient buffer will be requested to include a sign bit. For "
"example, when converting 128 with *n_bytes=1*, the function will return 2 "
"(or more) in order to store a zero sign bit."
msgstr ""

#: ../../c-api/long.rst:542
msgid ""
"If ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` is specified, a zero sign bit will "
"be omitted from size calculations. This allows, for example, 128 to fit in a"
" single-byte buffer. If the destination buffer is later treated as signed, a"
" positive input value may become negative. Note that the flag does not "
"affect handling of negative values: for those, space for a sign bit is "
"always requested."
msgstr ""

#: ../../c-api/long.rst:549
msgid ""
"Specifying ``Py_ASNATIVEBYTES_REJECT_NEGATIVE`` causes an exception to be "
"set if *pylong* is negative. Without this flag, negative values will be "
"copied provided there is enough space for at least one sign bit, regardless "
"of whether ``Py_ASNATIVEBYTES_UNSIGNED_BUFFER`` was specified."
msgstr ""

#: ../../c-api/long.rst:554
msgid ""
"If ``Py_ASNATIVEBYTES_ALLOW_INDEX`` is specified and a non-integer value is "
"passed, its :meth:`~object.__index__` method will be called first. This may "
"result in Python code executing and other threads being allowed to run, "
"which could cause changes to other objects or values in use. When *flags* is"
" ``-1``, this option is not set, and non-integer values will raise "
":exc:`TypeError`."
msgstr ""

#: ../../c-api/long.rst:563
msgid ""
"With the default *flags* (``-1``, or *UNSIGNED_BUFFER*  without "
"*REJECT_NEGATIVE*), multiple Python integers can map to a single value "
"without overflow. For example, both ``255`` and ``-1`` fit a single-byte "
"buffer and set all its bits. This matches typical C cast behavior."
msgstr ""

#: ../../c-api/long.rst:574
msgid "Get the sign of the integer object *obj*."
msgstr ""

#: ../../c-api/long.rst:576
msgid ""
"On success, set *\\*sign* to the integer sign  (0, -1 or +1 for zero, "
"negative or positive integer, respectively) and return 0."
msgstr ""

#: ../../c-api/long.rst:579
msgid ""
"On failure, return -1 with an exception set.  This function always succeeds "
"if *obj* is a :c:type:`PyLongObject` or its subtype."
msgstr ""

#: ../../c-api/long.rst:587
msgid "Check if the integer object *obj* is positive (``obj > 0``)."
msgstr ""

#: ../../c-api/long.rst:589
msgid ""
"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "
"``1`` when it's positive and ``0`` otherwise.  Else set an exception and "
"return ``-1``."
msgstr ""

#: ../../c-api/long.rst:598
msgid "Check if the integer object *obj* is negative (``obj < 0``)."
msgstr ""

#: ../../c-api/long.rst:600
msgid ""
"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "
"``1`` when it's negative and ``0`` otherwise.  Else set an exception and "
"return ``-1``."
msgstr ""

#: ../../c-api/long.rst:609
msgid "Check if the integer object *obj* is zero."
msgstr ""

#: ../../c-api/long.rst:611
msgid ""
"If *obj* is an instance of :c:type:`PyLongObject` or its subtype, return "
"``1`` when it's zero and ``0`` otherwise.  Else set an exception and return "
"``-1``."
msgstr ""

#: ../../c-api/long.rst:620
msgid ""
"On success, return a read only :term:`named tuple`, that holds information "
"about Python's internal representation of integers. See :data:`sys.int_info`"
" for description of individual fields."
msgstr ""

#: ../../c-api/long.rst:624
msgid "On failure, return ``NULL`` with an exception set."
msgstr ""

#: ../../c-api/long.rst:631
msgid "Return 1 if *op* is compact, 0 otherwise."
msgstr ""

#: ../../c-api/long.rst:633
msgid ""
"This function makes it possible for performance-critical code to implement a"
" “fast path” for small integers. For compact values use "
":c:func:`PyUnstable_Long_CompactValue`; for others fall back to a "
":c:func:`PyLong_As* <PyLong_AsSize_t>` function or "
":c:func:`PyLong_AsNativeBytes`."
msgstr ""

#: ../../c-api/long.rst:639
msgid "The speedup is expected to be negligible for most users."
msgstr ""

#: ../../c-api/long.rst:641
msgid ""
"Exactly what values are considered compact is an implementation detail and "
"is subject to change."
msgstr ""

#: ../../c-api/long.rst:649
msgid ""
"If *op* is compact, as determined by :c:func:`PyUnstable_Long_IsCompact`, "
"return its value."
msgstr ""

#: ../../c-api/long.rst:652
msgid "Otherwise, the return value is undefined."
msgstr ""

#: ../../c-api/long.rst:658
msgid "Export API"
msgstr ""

#: ../../c-api/long.rst:664
msgid ""
"Layout of an array of \"digits\" (\"limbs\" in the GMP terminology), used to"
" represent absolute value for arbitrary precision integers."
msgstr ""

#: ../../c-api/long.rst:667
msgid ""
"Use :c:func:`PyLong_GetNativeLayout` to get the native layout of Python "
":class:`int` objects, used internally for integers with \"big enough\" "
"absolute value."
msgstr ""

#: ../../c-api/long.rst:671
msgid ""
"See also :data:`sys.int_info` which exposes similar information in Python."
msgstr ""

#: ../../c-api/long.rst:675
msgid ""
"Bits per digit. For example, a 15 bit digit means that bits 0-14 contain "
"meaningful information."
msgstr ""

#: ../../c-api/long.rst:680
msgid ""
"Digit size in bytes. For example, a 15 bit digit will require at least 2 "
"bytes."
msgstr ""

#: ../../c-api/long.rst:685
msgid "Digits order:"
msgstr ""

#: ../../c-api/long.rst:687
msgid "``1`` for most significant digit first"
msgstr ""

#: ../../c-api/long.rst:688
msgid "``-1`` for least significant digit first"
msgstr ""

#: ../../c-api/long.rst:692
msgid "Digit endianness:"
msgstr ""

#: ../../c-api/long.rst:694
msgid "``1`` for most significant byte first (big endian)"
msgstr ""

#: ../../c-api/long.rst:695
msgid "``-1`` for least significant byte first (little endian)"
msgstr ""

#: ../../c-api/long.rst:700
msgid "Get the native layout of Python :class:`int` objects."
msgstr ""

#: ../../c-api/long.rst:702
msgid "See the :c:struct:`PyLongLayout` structure."
msgstr ""

#: ../../c-api/long.rst:704
msgid ""
"The function must not be called before Python initialization nor after "
"Python finalization. The returned layout is valid until Python is finalized."
" The layout is the same for all Python sub-interpreters in a process, and so"
" it can be cached."
msgstr ""

#: ../../c-api/long.rst:712
msgid "Export of a Python :class:`int` object."
msgstr ""

#: ../../c-api/long.rst:714
msgid "There are two cases:"
msgstr ""

#: ../../c-api/long.rst:716
msgid ""
"If :c:member:`digits` is ``NULL``, only use the :c:member:`value` member."
msgstr ""

#: ../../c-api/long.rst:717
msgid ""
"If :c:member:`digits` is not ``NULL``, use :c:member:`negative`, "
":c:member:`ndigits` and :c:member:`digits` members."
msgstr ""

#: ../../c-api/long.rst:722
msgid ""
"The native integer value of the exported :class:`int` object. Only valid if "
":c:member:`digits` is ``NULL``."
msgstr ""

#: ../../c-api/long.rst:727
msgid ""
"``1`` if the number is negative, ``0`` otherwise. Only valid if "
":c:member:`digits` is not ``NULL``."
msgstr ""

#: ../../c-api/long.rst:732
msgid ""
"Number of digits in :c:member:`digits` array. Only valid if "
":c:member:`digits` is not ``NULL``."
msgstr ""

#: ../../c-api/long.rst:737
msgid "Read-only array of unsigned digits. Can be ``NULL``."
msgstr ""

#: ../../c-api/long.rst:742
msgid "Export a Python :class:`int` object."
msgstr ""

#: ../../c-api/long.rst:744
msgid ""
"*export_long* must point to a :c:struct:`PyLongExport` structure allocated "
"by the caller. It must not be ``NULL``."
msgstr ""

#: ../../c-api/long.rst:747
msgid ""
"On success, fill in *\\*export_long* and return ``0``. On error, set an "
"exception and return ``-1``."
msgstr ""

#: ../../c-api/long.rst:750
msgid ""
":c:func:`PyLong_FreeExport` must be called when the export is no longer "
"needed."
msgstr ""

#: ../../c-api/long.rst:754
msgid ""
"This function always succeeds if *obj* is a Python :class:`int` object or a "
"subclass."
msgstr ""

#: ../../c-api/long.rst:760
msgid "Release the export *export_long* created by :c:func:`PyLong_Export`."
msgstr ""

#: ../../c-api/long.rst:763
msgid ""
"Calling :c:func:`PyLong_FreeExport` is optional if *export_long->digits* is "
"``NULL``."
msgstr ""

#: ../../c-api/long.rst:768
msgid "PyLongWriter API"
msgstr ""

#: ../../c-api/long.rst:770
msgid "The :c:type:`PyLongWriter` API can be used to import an integer."
msgstr ""

#: ../../c-api/long.rst:776
msgid "A Python :class:`int` writer instance."
msgstr ""

#: ../../c-api/long.rst:778
msgid ""
"The instance must be destroyed by :c:func:`PyLongWriter_Finish` or "
":c:func:`PyLongWriter_Discard`."
msgstr ""

#: ../../c-api/long.rst:784
msgid "Create a :c:type:`PyLongWriter`."
msgstr ""

#: ../../c-api/long.rst:786
msgid ""
"On success, allocate *\\*digits* and return a writer. On error, set an "
"exception and return ``NULL``."
msgstr ""

#: ../../c-api/long.rst:789
msgid "*negative* is ``1`` if the number is negative, or ``0`` otherwise."
msgstr ""

#: ../../c-api/long.rst:791
msgid ""
"*ndigits* is the number of digits in the *digits* array. It must be greater "
"than 0."
msgstr ""

#: ../../c-api/long.rst:794
msgid "*digits* must not be NULL."
msgstr ""

#: ../../c-api/long.rst:796
msgid ""
"After a successful call to this function, the caller should fill in the "
"array of digits *digits* and then call :c:func:`PyLongWriter_Finish` to get "
"a Python :class:`int`. The layout of *digits* is described by "
":c:func:`PyLong_GetNativeLayout`."
msgstr ""

#: ../../c-api/long.rst:801
msgid ""
"Digits must be in the range [``0``; ``(1 << bits_per_digit) - 1``] (where "
"the :c:struct:`~PyLongLayout.bits_per_digit` is the number of bits per "
"digit). Any unused most significant digits must be set to ``0``."
msgstr ""

#: ../../c-api/long.rst:806
msgid ""
"Alternately, call :c:func:`PyLongWriter_Discard` to destroy the writer "
"instance without creating an :class:`~int` object."
msgstr ""

#: ../../c-api/long.rst:812
msgid ""
"Finish a :c:type:`PyLongWriter` created by :c:func:`PyLongWriter_Create`."
msgstr ""

#: ../../c-api/long.rst:814
msgid ""
"On success, return a Python :class:`int` object. On error, set an exception "
"and return ``NULL``."
msgstr ""

#: ../../c-api/long.rst:817
msgid ""
"The function takes care of normalizing the digits and converts the object to"
" a compact integer if needed."
msgstr ""

#: ../../c-api/long.rst:820 ../../c-api/long.rst:829
msgid "The writer instance and the *digits* array are invalid after the call."
msgstr ""

#: ../../c-api/long.rst:825
msgid ""
"Discard a :c:type:`PyLongWriter` created by :c:func:`PyLongWriter_Create`."
msgstr ""

#: ../../c-api/long.rst:827
msgid "If *writer* is ``NULL``, no operation is performed."
msgstr ""

#: ../../c-api/long.rst:8
msgid "object"
msgstr "objek"

#: ../../c-api/long.rst:8
msgid "long integer"
msgstr ""

#: ../../c-api/long.rst:8
msgid "integer"
msgstr "bilangan bulat"

#: ../../c-api/long.rst:164
msgid "LONG_MAX (C macro)"
msgstr ""

#: ../../c-api/long.rst:164 ../../c-api/long.rst:224 ../../c-api/long.rst:267
#: ../../c-api/long.rst:282 ../../c-api/long.rst:298 ../../c-api/long.rst:314
msgid "OverflowError (built-in exception)"
msgstr ""

#: ../../c-api/long.rst:267
msgid "PY_SSIZE_T_MAX (C macro)"
msgstr ""

#: ../../c-api/long.rst:282
msgid "ULONG_MAX (C macro)"
msgstr ""

#: ../../c-api/long.rst:298
msgid "SIZE_MAX (C macro)"
msgstr ""