Exchange array and size parameters

Author: vstinner

Doc/c-api/tuple.rst

@@ -37,7 +37,7 @@ Tuple Objects
    or ``NULL`` with an exception set on failure.
 
 
-.. c:function:: PyObject* PyTuple_FromArray(PyObject *const *array, Py_ssize_t size)
+.. c:function:: PyObject* PyTuple_FromArray(Py_ssize_t size, PyObject *const *array)
 
    Create a tuple of *size* items and copy references from *array* to the new
    tuple.

Include/cpython/tupleobject.h

@@ -40,5 +40,5 @@ PyTuple_SET_ITEM(PyObject *op, Py_ssize_t index, PyObject *value) {
     PyTuple_SET_ITEM(_PyObject_CAST(op), (index), _PyObject_CAST(value))
 
 PyAPI_FUNC(PyObject*) PyTuple_FromArray(
-    PyObject *const *array,
-    Py_ssize_t size);
+    Py_ssize_t size,
+    PyObject *const *array);

Include/internal/pycore_tuple.h

@@ -23,8 +23,8 @@ extern PyStatus _PyTuple_InitGlobalObjects(PyInterpreterState *);
 
 #define _PyTuple_ITEMS(op) _Py_RVALUE(_PyTuple_CAST(op)->ob_item)
 
-// Alias for backward compatibility
-#define _PyTuple_FromArray PyTuple_FromArray
+// Macro for backward compatibility
+#define _PyTuple_FromArray(array, size) PyTuple_FromArray((size), (array))
 
 PyAPI_FUNC(PyObject *)_PyTuple_FromStackRefStealOnSuccess(const union _PyStackRef *, Py_ssize_t);
 PyAPI_FUNC(PyObject *)_PyTuple_FromArraySteal(PyObject *const *, Py_ssize_t);

Modules/_testcapi/tuple.c

@@ -127,7 +127,7 @@ tuple_fromarray(PyObject* Py_UNUSED(module), PyObject *args)
     else {
         items = NULL;
     }
-    return PyTuple_FromArray(items, size);
+    return PyTuple_FromArray(size, items);
 }
 
 

Objects/tupleobject.c

@@ -366,7 +366,7 @@ tuple_item(PyObject *op, Py_ssize_t i)
 }
 
 PyObject *
-PyTuple_FromArray(PyObject *const *src, Py_ssize_t n)
+PyTuple_FromArray(Py_ssize_t n, PyObject *const *src)
 {
     if (n == 0) {
         return tuple_get_empty();