Dec 13, 2024 · Jul 2, 2024 · Jul 23, 2024 · Sep 3, 2024 · Sep 3, 2024 · Sep 3, 2024
diff --git a/Doc/c-api/long.rst b/Doc/c-api/long.rst

      Digit size in bytes.

   .. c:member:: int8_tword_endian
   .. c:member:: int8_tdigits_order

      Word endian:

      - ``1`` for most significant word first (big endian)
      - ``-1`` for least significant first (little endian)

   .. c:member:: int8_tarray_endian
   .. c:member:: int8_tendian

      Array endian:

diff --git a/Include/cpython/longintrepr.h b/Include/cpython/longintrepr.h
    // Word endian:
    // * 1 for most significant word first (big endian)
    // * -1 for least significant first (little endian)
    int8_tword_endian;
    int8_tdigits_order;

    // Array endian:
    // * 1 for most significant byte first (big endian)
    // * -1 for least significant first (little endian)
    int8_tarray_endian;
    int8_tendian;
 } PyLongLayout;

 PyAPI_FUNC(const PyLongLayout*) PyLong_GetNativeLayout(void);
diff --git a/Lib/test/test_capi/test_long.py b/Lib/test/test_capi/test_long.py
        int_info = sys.int_info
        layout = _testcapi.get_pylong_layout()
        expected = {
            'array_endian': -1,
            'endian': -1,
            'bits_per_digit': int_info.bits_per_digit,
            'digit_size': int_info.sizeof_digit,
            'word_endian': -1 if sys.byteorder == 'little' else 1,
            'digits_order': -1 if sys.byteorder == 'little' else 1,
        }
        self.assertEqual(layout, expected)

            return (-endian if endian else 1)
        with self.assertRaises(ValueError):
            layout = _testcapi.get_pylong_layout()
            layout['word_endian'] = change_endian(layout['word_endian'])
            layout['digits_order'] = change_endian(layout['digits_order'])
            pylongwriter_create(0, [123], layout)
        with self.assertRaises(ValueError):
            layout = _testcapi.get_pylong_layout()
            layout['array_endian'] = change_endian(layout['array_endian'])
            layout['endian'] = change_endian(layout['endian'])
            pylongwriter_create(0, [123], layout)


diff --git a/Modules/_testcapi/long.c b/Modules/_testcapi/long.c
        goto error;
    }

    value = PyLong_FromLong(layout->word_endian);
    value = PyLong_FromLong(layout->digits_order);
    if (value == NULL) {
        goto error;
    }
    res = PyDict_SetItemString(dict, "word_endian", value);
    res = PyDict_SetItemString(dict, "digits_order", value);
    Py_DECREF(value);
    if (res < 0) {
        goto error;
    }

    value = PyLong_FromLong(layout->array_endian);
    value = PyLong_FromLong(layout->endian);
    if (value == NULL) {
        goto error;
    }
    res = PyDict_SetItemString(dict, "array_endian", value);
    res = PyDict_SetItemString(dict, "endian", value);
    Py_DECREF(value);
    if (res < 0) {
        goto error;
    }
    layout->digit_size = (uint8_t)value;

    if (layout_from_dict_get(dict, "word_endian", 1, &value) < 0) {
    if (layout_from_dict_get(dict, "digits_order", 1, &value) < 0) {
        goto error;
    }
    layout->word_endian = (int8_t)value;
    layout->digits_order = (int8_t)value;

    if (layout_from_dict_get(dict, "array_endian", 1, &value) < 0) {
    if (layout_from_dict_get(dict, "endian", 1, &value) < 0) {
        goto error;
    }
    layout->array_endian = (int8_t)value;
    layout->endian = (int8_t)value;

    return 0;

diff --git a/Objects/longobject.c b/Objects/longobject.c

 const PyLongLayout PyLong_LAYOUT = {
    .bits_per_digit = PyLong_SHIFT,
    .word_endian = PY_LITTLE_ENDIAN ? -1 : 1,
    .array_endian = -1,  // least significant first
    .digits_order = PY_LITTLE_ENDIAN ? -1 : 1,
    .endian = -1,  // least significant first
    .digit_size = sizeof(digit),
 };
Original file line number	Diff line number	Diff line change
Expand Up		@@ -647,14 +647,14 @@ Export API

		Digit size in bytes.

		.. c:member:: int8_tword_endian
		.. c:member:: int8_tdigits_order

		Word endian:
vstinner marked this conversation as resolved. OutdatedShow resolvedHide resolved

		- ``1`` for most significant word first (big endian)
vstinner marked this conversation as resolved. OutdatedShow resolvedHide resolved
		- ``-1`` for least significant first (little endian)

		.. c:member:: int8_tarray_endian
		.. c:member:: int8_tendian
vstinner marked this conversation as resolved. OutdatedShow resolvedHide resolved

		Array endian:
vstinner marked this conversation as resolved. OutdatedShow resolvedHide resolved

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -153,12 +153,12 @@ typedef struct PyLongLayout {
		// Word endian:
		// * 1 for most significant word first (big endian)
		// * -1 for least significant first (little endian)
		int8_tword_endian;
		int8_tdigits_order;

		// Array endian:
		// * 1 for most significant byte first (big endian)
		// * -1 for least significant first (little endian)
		int8_tarray_endian;
		int8_tendian;
		} PyLongLayout;

		PyAPI_FUNC(const PyLongLayout*) PyLong_GetNativeLayout(void);
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -674,10 +674,10 @@ def test_long_layout(self):
		int_info = sys.int_info
		layout = _testcapi.get_pylong_layout()
		expected = {
		'array_endian': -1,
		'endian': -1,
		'bits_per_digit': int_info.bits_per_digit,
		'digit_size': int_info.sizeof_digit,
		'word_endian': -1 if sys.byteorder == 'little' else 1,
		'digits_order': -1 if sys.byteorder == 'little' else 1,
		}
		self.assertEqual(layout, expected)

Expand DownExpand Up		@@ -749,11 +749,11 @@ def change_endian(endian):
		return (-endian if endian else 1)
		with self.assertRaises(ValueError):
		layout = _testcapi.get_pylong_layout()
		layout['word_endian'] = change_endian(layout['word_endian'])
		layout['digits_order'] = change_endian(layout['digits_order'])
		pylongwriter_create(0, [123], layout)
		with self.assertRaises(ValueError):
		layout = _testcapi.get_pylong_layout()
		layout['array_endian'] = change_endian(layout['array_endian'])
		layout['endian'] = change_endian(layout['endian'])
		pylongwriter_create(0, [123], layout)


Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -145,21 +145,21 @@ layout_to_dict(const PyLongLayout *layout)
		goto error;
		}

		value = PyLong_FromLong(layout->word_endian);
		value = PyLong_FromLong(layout->digits_order);
		if (value == NULL) {
		goto error;
		}
		res = PyDict_SetItemString(dict, "word_endian", value);
		res = PyDict_SetItemString(dict, "digits_order", value);
		Py_DECREF(value);
		if (res < 0) {
		goto error;
		}

		value = PyLong_FromLong(layout->array_endian);
		value = PyLong_FromLong(layout->endian);
		if (value == NULL) {
		goto error;
		}
		res = PyDict_SetItemString(dict, "array_endian", value);
		res = PyDict_SetItemString(dict, "endian", value);
		Py_DECREF(value);
		if (res < 0) {
		goto error;
Expand DownExpand Up		@@ -218,15 +218,15 @@ layout_from_dict(PyLongLayout layout, PyObject dict)
		}
		layout->digit_size = (uint8_t)value;

		if (layout_from_dict_get(dict, "word_endian", 1, &value) < 0) {
		if (layout_from_dict_get(dict, "digits_order", 1, &value) < 0) {
		goto error;
		}
		layout->word_endian = (int8_t)value;
		layout->digits_order = (int8_t)value;

		if (layout_from_dict_get(dict, "array_endian", 1, &value) < 0) {
		if (layout_from_dict_get(dict, "endian", 1, &value) < 0) {
		goto error;
		}
		layout->array_endian = (int8_t)value;
		layout->endian = (int8_t)value;

		return 0;

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -6778,8 +6778,8 @@ int PyLong_AsUInt64(PyObject obj, uint64_t value)

		const PyLongLayout PyLong_LAYOUT = {
		.bits_per_digit = PyLong_SHIFT,
		.word_endian = PY_LITTLE_ENDIAN ? -1 : 1,
		.array_endian = -1, // least significant first
		.digits_order = PY_LITTLE_ENDIAN ? -1 : 1,
		.endian = -1, // least significant first
vstinner marked this conversation as resolved. OutdatedShow resolvedHide resolved
		.digit_size = sizeof(digit),
		};

Expand Down