mirror of
				https://github.com/python/cpython.git
				synced 2025-11-04 03:44:55 +00:00 
			
		
		
		
	As part of the PEP-652 implementation, I'll tighten the CI check for functions/data defined with `Py_LIMITED_API`. Discussion in https://discuss.python.org/t/pep-652-maintaining-the-stable-abi/6986 suggests that parsing C headers is OK (though personally I'd rather generate it...), but writing a full C parser is a monumental task and adding an existing one as a dependency brings too many vendoring/bootstraping issues. So, for the check I'll use a "simple" regex on preprocessor output, and adapt the few trivial places where the regex won't work. - Keep declarations in the limited API to one item per line - Make it possible to override `_Py_NO_RETURN`, so the annotation can be removed from preprocessor output. https://bugs.python.org/issue43795
		
			
				
	
	
		
			43 lines
		
	
	
	
		
			1.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			43 lines
		
	
	
	
		
			1.2 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/* Boolean object interface */
 | 
						|
 | 
						|
#ifndef Py_BOOLOBJECT_H
 | 
						|
#define Py_BOOLOBJECT_H
 | 
						|
#ifdef __cplusplus
 | 
						|
extern "C" {
 | 
						|
#endif
 | 
						|
 | 
						|
 | 
						|
PyAPI_DATA(PyTypeObject) PyBool_Type;
 | 
						|
 | 
						|
#define PyBool_Check(x) Py_IS_TYPE(x, &PyBool_Type)
 | 
						|
 | 
						|
/* Py_False and Py_True are the only two bools in existence.
 | 
						|
Don't forget to apply Py_INCREF() when returning either!!! */
 | 
						|
 | 
						|
/* Don't use these directly */
 | 
						|
PyAPI_DATA(struct _longobject) _Py_FalseStruct;
 | 
						|
PyAPI_DATA(struct _longobject) _Py_TrueStruct;
 | 
						|
 | 
						|
/* Use these macros */
 | 
						|
#define Py_False ((PyObject *) &_Py_FalseStruct)
 | 
						|
#define Py_True ((PyObject *) &_Py_TrueStruct)
 | 
						|
 | 
						|
// Test if an object is the True singleton, the same as "x is True" in Python.
 | 
						|
PyAPI_FUNC(int) Py_IsTrue(PyObject *x);
 | 
						|
#define Py_IsTrue(x) Py_Is((x), Py_True)
 | 
						|
 | 
						|
// Test if an object is the False singleton, the same as "x is False" in Python.
 | 
						|
PyAPI_FUNC(int) Py_IsFalse(PyObject *x);
 | 
						|
#define Py_IsFalse(x) Py_Is((x), Py_False)
 | 
						|
 | 
						|
/* Macros for returning Py_True or Py_False, respectively */
 | 
						|
#define Py_RETURN_TRUE return Py_NewRef(Py_True)
 | 
						|
#define Py_RETURN_FALSE return Py_NewRef(Py_False)
 | 
						|
 | 
						|
/* Function to return a bool from a C long */
 | 
						|
PyAPI_FUNC(PyObject *) PyBool_FromLong(long);
 | 
						|
 | 
						|
#ifdef __cplusplus
 | 
						|
}
 | 
						|
#endif
 | 
						|
#endif /* !Py_BOOLOBJECT_H */
 |