Sync C/python implementation of the decimal: logical_ops for contexts

Author: skirpichev

Modules/_decimal/docstrings.h

@@ -706,27 +706,91 @@ 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, which both have zero sign\n\
-and exponent, and digits either 0 or 1.\n\
-\n");
+Applies the logical operation \'and\' between each operand\'s digits.\n\n\
+Both operands should have zero sign and exponent, and\n\
+digits either 0 or 1.\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");
 
 PyDoc_STRVAR(doc_ctx_logical_invert,
 "logical_invert($self, x, /)\n--\n\n\
-Invert all digits of x, which has zero sign and exponent,\n\
-and digits either 0 or 1.\n\
-\n");
+Invert all the digits in the operand.\n\n\
+The operand should have zero sign and exponent, and digits\n\
+either 0 or 1.\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");
 
 PyDoc_STRVAR(doc_ctx_logical_or,
 "logical_or($self, x, y, /)\n--\n\n\
-Digit-wise or of x and y, which both have zero sign\n\
-and exponent, and digits either 0 or 1.\n\
-\n");
+Applies the logical operation \'or\' between each operand\'s digits.\n\n\
+Both operands should have zero sign and exponent, and digits\n\
+either 0 or 1.\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");
 
 PyDoc_STRVAR(doc_ctx_logical_xor,
 "logical_xor($self, x, y, /)\n--\n\n\
-Digit-wise xor of x and y, which both have zero sign\n\
-and exponent, and digits either 0 or 1.\n\
-\n");
+Applies the logical operation \'xor\' between each operand\'s digits.\n\n\
+Both operands should have zero sign and exponent, and digits\n\
+either 0 or 1.\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");
 
 PyDoc_STRVAR(doc_ctx_max,
 "max($self, x, y, /)\n--\n\n\