Stowage/cpython
2
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-12-08 06:10:17 +00:00
Code Issues Projects Releases Packages Wiki Activity

[3.14] gh-102431: Clarify constraints on operands of Decimal logical operations (GH-102836) (#140105)

Browse source 
* [3.14] gh-102431: Clarify constraints on operands of Decimal logical operations (GH-102836)

Sync C/Python implementation of the decimal: logical_ops for contexts.
(cherry picked from commit 6ecf77dbde)

Co-authored-by: Sergey B Kirpichev <skirpichev@gmail.com>
This commit is contained in:
Sergey B Kirpichev 2025-10-14 16:44:30 +03:00 • committed by GitHub
parent 2142f4efcf
commit 1c55b9163b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 98 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

88
Modules/_decimal/docstrings.h
View file

@ -292,22 +292,26 @@ an infinity then Decimal('Infinity') is returned.\n\
PyDoc_STRVAR(doc_logical_and,
"logical_and($self, /, other, context=None)\n--\n\n\
Return the digit-wise 'and' of the two (logical) operands.\n\
Applies an 'and' operation between self and other's digits.\n\n\
Both self and other must be logical numbers.\n\
\n");
PyDoc_STRVAR(doc_logical_invert,
"logical_invert($self, /, context=None)\n--\n\n\
Return the digit-wise inversion of the (logical) operand.\n\
Invert all its digits.\n\n\
The self must be logical number.\n\
\n");
PyDoc_STRVAR(doc_logical_or,
"logical_or($self, /, other, context=None)\n--\n\n\
Return the digit-wise 'or' of the two (logical) operands.\n\
Applies an 'or' operation between self and other's digits.\n\n\
Both self and other must be logical numbers. \n\
\n");
PyDoc_STRVAR(doc_logical_xor,
"logical_xor($self, /, other, context=None)\n--\n\n\
Return the digit-wise 'exclusive or' of the two (logical) operands.\n\
Applies an 'xor' operation between self and other's digits.\n\n\
Both self and other must be logical numbers.\n\
\n");
PyDoc_STRVAR(doc_max,
@ -712,22 +716,90 @@ Return the exponent of the magnitude of the operand's MSD.\n\
PyDoc_STRVAR(doc_ctx_logical_and,
"logical_and($self, x, y, /)\n--\n\n\
Digit-wise and of x and y.\n\
Applies the logical operation 'and' between each operand's digits.\n\n\
The operands must be both logical numbers.\n\n\
>>> ExtendedContext.logical_and(Decimal('0'), Decimal('0'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_and(Decimal('0'), Decimal('1'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_and(Decimal('1'), Decimal('0'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_and(Decimal('1'), Decimal('1'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_and(Decimal('1100'), Decimal('1010'))\n\
Decimal('1000')\n\
>>> ExtendedContext.logical_and(Decimal('1111'), Decimal('10'))\n\
Decimal('10')\n\
>>> ExtendedContext.logical_and(110, 1101)\n\
Decimal('100')\n\
>>> ExtendedContext.logical_and(Decimal(110), 1101)\n\
Decimal('100')\n\
>>> ExtendedContext.logical_and(110, Decimal(1101))\n\
Decimal('100')\n\
\n");
PyDoc_STRVAR(doc_ctx_logical_invert,
"logical_invert($self, x, /)\n--\n\n\
Invert all digits of x.\n\
Invert all the digits in the operand.\n\n\
The operand must be a logical number.\n\n\
>>> ExtendedContext.logical_invert(Decimal('0'))\n\
Decimal('111111111')\n\
>>> ExtendedContext.logical_invert(Decimal('1'))\n\
Decimal('111111110')\n\
>>> ExtendedContext.logical_invert(Decimal('111111111'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_invert(Decimal('101010101'))\n\
Decimal('10101010')\n\
>>> ExtendedContext.logical_invert(1101)\n\
Decimal('111110010')\n\
\n");
PyDoc_STRVAR(doc_ctx_logical_or,
"logical_or($self, x, y, /)\n--\n\n\
Digit-wise or of x and y.\n\
Applies the logical operation 'or' between each operand's digits.\n\n\
The operands must be both logical numbers.\n\n\
>>> ExtendedContext.logical_or(Decimal('0'), Decimal('0'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_or(Decimal('0'), Decimal('1'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_or(Decimal('1'), Decimal('0'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_or(Decimal('1'), Decimal('1'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_or(Decimal('1100'), Decimal('1010'))\n\
Decimal('1110')\n\
>>> ExtendedContext.logical_or(Decimal('1110'), Decimal('10'))\n\
Decimal('1110')\n\
>>> ExtendedContext.logical_or(110, 1101)\n\
Decimal('1111')\n\
>>> ExtendedContext.logical_or(Decimal(110), 1101)\n\
Decimal('1111')\n\
>>> ExtendedContext.logical_or(110, Decimal(1101))\n\
Decimal('1111')\n\
\n");
PyDoc_STRVAR(doc_ctx_logical_xor,
"logical_xor($self, x, y, /)\n--\n\n\
Digit-wise xor of x and y.\n\
Applies the logical operation 'xor' between each operand's digits.\n\n\
The operands must be both logical numbers.\n\n\
>>> ExtendedContext.logical_xor(Decimal('0'), Decimal('0'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_xor(Decimal('0'), Decimal('1'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_xor(Decimal('1'), Decimal('0'))\n\
Decimal('1')\n\
>>> ExtendedContext.logical_xor(Decimal('1'), Decimal('1'))\n\
Decimal('0')\n\
>>> ExtendedContext.logical_xor(Decimal('1100'), Decimal('1010'))\n\
Decimal('110')\n\
>>> ExtendedContext.logical_xor(Decimal('1111'), Decimal('10'))\n\
Decimal('1101')\n\
>>> ExtendedContext.logical_xor(110, 1101)\n\
Decimal('1011')\n\
>>> ExtendedContext.logical_xor(Decimal(110), 1101)\n\
Decimal('1011')\n\
>>> ExtendedContext.logical_xor(110, Decimal(1101))\n\
Decimal('1011')\n\
\n");
PyDoc_STRVAR(doc_ctx_max,