Commit90c06a4

authored

Add PyUnstable_Object_IsUniquelyReferenced (#149)

1 parent718e12e commit90c06a4Copy full SHA for 90c06a4

File tree

+42

-0

lines changed

+42

-0

lines changed

Lines changed: 3 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -208,6 +208,9 @@ Python 3.14`
`208`	`208`
`209`	`209`	See `PyConfig_GetInt() documentation <https://docs.python.org/dev/c-api/init_config.html#c.PyConfig_GetInt>`__.
`210`	`210`
	`211`	`+.. c:function:: int PyUnstable_Object_IsUniquelyReferenced(PyObject *op)`
	`212`	`+`
	`213`	+ See `PyUnstable_Object_IsUniquelyReferenced() documentation <https://docs.python.org/dev/c-api/object.html#c.PyUnstable_Object_IsUniquelyReferenced>`__.
`211`	`214`
`212`	`215`	`Not supported:`
`213`	`216`

Lines changed: 1 addition & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,7 @@`
`1`	`1`	`Changelog`
`2`	`2`	`=========`
`3`	`3`
	`4`	+* 2025-09-01: Add ``PyUnstable_Object_IsUniquelyReferenced()`` function.
`4`	`5`	* 2025-06-09: Add ``PyUnicodeWriter_WriteASCII()`` function.
`5`	`6`	`* 2025-06-03: Add functions:`
`6`	`7`

Lines changed: 18 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -2211,6 +2211,24 @@ PyConfig_GetInt(const char name, int value)`
`2211`	`2211`	`}`
`2212`	`2212`	`#endif// PY_VERSION_HEX > 0x03090000 && !defined(PYPY_VERSION)`
`2213`	`2213`
	`2214`	`+// gh-133144 added PyUnstable_Object_IsUniquelyReferenced() to Python 3.14.0b1.`
	`2215`	`+// Adapted from _PyObject_IsUniquelyReferenced() implementation.`
	`2216`	`+#if PY_VERSION_HEX < 0x030E00B0`
	`2217`	`+staticinlineintPyUnstable_Object_IsUniquelyReferenced(PyObject *obj)`
	`2218`	`+{`
	`2219`	`+#if !defined(Py_GIL_DISABLED)`
	`2220`	`+returnPy_REFCNT(obj) ==1;`
	`2221`	`+#else`
	`2222`	`+// NOTE: the entire ob_ref_shared field must be zero, including flags, to`
	`2223`	`+// ensure that other threads cannot concurrently create new references to`
	`2224`	`+// this object.`
	`2225`	`+return (_Py_IsOwnedByCurrentThread(obj) &&`
	`2226`	`+_Py_atomic_load_uint32_relaxed(&obj->ob_ref_local) ==1 &&`
	`2227`	`+_Py_atomic_load_ssize_relaxed(&obj->ob_ref_shared) ==0);`
	`2228`	`+#endif`
	`2229`	`+}`
	`2230`	`+#endif`
	`2231`	`+`
`2214`	`2232`
`2215`	`2233`	`#if PY_VERSION_HEX < 0x030F0000`
`2216`	`2234`	`staticinline PyObject*`

Lines changed: 20 additions & 0 deletions

Original file line number	Diff line number	Diff line change
`@@ -1972,6 +1972,25 @@ test_unicodewriter_format(PyObject Py_UNUSED(self), PyObject Py_UNUSED(args))`
`1972`	`1972`	`}`
`1973`	`1973`	`#endif`
`1974`	`1974`
	`1975`	`+staticPyObject*`
	`1976`	`+test_uniquely_referenced(PyObjectPy_UNUSED(self),PyObjectPy_UNUSED(args))`
	`1977`	`+{`
	`1978`	`+PyObject*obj=Py_BuildValue("(s, s)","hello","world");`
	`1979`	`+if (obj==NULL) {`
	`1980`	`+returnNULL;`
	`1981`	`+ }`
	`1982`	`+`
	`1983`	`+assert(PyUnstable_Object_IsUniquelyReferenced(obj));`
	`1984`	`+`
	`1985`	`+Py_INCREF(obj);`
	`1986`	`+`
	`1987`	`+assert(!PyUnstable_Object_IsUniquelyReferenced(obj));`
	`1988`	`+`
	`1989`	`+Py_DECREF(obj);`
	`1990`	`+Py_DECREF(obj);`
	`1991`	`+`
	`1992`	`+Py_RETURN_NONE;`
	`1993`	`+}`
`1975`	`1994`
`1976`	`1995`	`staticPyObject*`
`1977`	`1996`	`test_bytes(PyObjectPy_UNUSED(module),PyObjectPy_UNUSED(args))`
`@@ -2328,6 +2347,7 @@ static struct PyMethodDef methods[] = {`
`2328`	`2347`	`{"test_config",test_config,METH_NOARGS,_Py_NULL},`
`2329`	`2348`	`#endif`
`2330`	`2349`	`{"test_sys",test_sys,METH_NOARGS,_Py_NULL},`
	`2350`	`+ {"test_uniquely_referenced",test_uniquely_referenced,METH_NOARGS,_Py_NULL},`
`2331`	`2351`	`{_Py_NULL,_Py_NULL,0,_Py_NULL}`
`2332`	`2352`	`};`
`2333`	`2353`

Comments

(0)