annotate Lib/decimal.py @ 78069:a8aa77458e12 3.2

Add c_size_t and c_ssize_t to the ctypes summary table.
author Antoine Pitrou <solipsis@pitrou.net>
date Thu, 12 Jul 2012 20:31:50 +0200
parents f5d5f3f4c081
children a931e44ffbe1 825b4278a055
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1 # Copyright (c) 2004 Python Software Foundation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2 # All rights reserved.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4 # Written by Eric Price <eprice at tjhsst.edu>
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5 # and Facundo Batista <facundo at taniquetil.com.ar>
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
6 # and Raymond Hettinger <python at rcn.com>
32456
50068b17f41e fix small consistency nit
Fred Drake <fdrake@acm.org>
parents: 32451
diff changeset
7 # and Aahz <aahz at pobox.com>
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
8 # and Tim Peters
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
9
51655
51db18084ecb Removed message about compatibility with 2.3.
Facundo Batista <facundobatista@gmail.com>
parents: 51297
diff changeset
10 # This module should be kept in sync with the latest updates of the
51db18084ecb Removed message about compatibility with 2.3.
Facundo Batista <facundobatista@gmail.com>
parents: 51297
diff changeset
11 # IBM specification as it evolves. Those updates will be treated
33198
017227e47c3d Establish policies with respect to 2.3 compatibilty and treated spec
Raymond Hettinger <python@rcn.com>
parents: 33157
diff changeset
12 # as bug fixes (deviation from the spec is a compatibility, usability
017227e47c3d Establish policies with respect to 2.3 compatibilty and treated spec
Raymond Hettinger <python@rcn.com>
parents: 33157
diff changeset
13 # bug) and will be backported. At this point the spec is stabilizing
017227e47c3d Establish policies with respect to 2.3 compatibilty and treated spec
Raymond Hettinger <python@rcn.com>
parents: 33157
diff changeset
14 # and the updates are becoming fewer, smaller, and less significant.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
15
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
16 """
51655
51db18084ecb Removed message about compatibility with 2.3.
Facundo Batista <facundobatista@gmail.com>
parents: 51297
diff changeset
17 This is an implementation of decimal floating point arithmetic based on
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
18 the General Decimal Arithmetic Specification:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
19
53299
696dd2281841 Update links and version info.
Raymond Hettinger <python@rcn.com>
parents: 52201
diff changeset
20 http://speleotrove.com/decimal/decarith.html
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
21
32489
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
22 and IEEE standard 854-1987:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
23
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
24 www.cs.berkeley.edu/~ejr/projects/754/private/drafts/854-1987/dir.html
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
25
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
26 Decimal floating point has finite precision with arbitrarily large bounds.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
27
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
28 The purpose of this module is to support arithmetic using familiar
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
29 "schoolhouse" rules and to avoid some of the tricky representation
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
30 issues associated with binary floating point. The package is especially
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
31 useful for financial applications or for contexts where users have
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
32 expectations that are at odds with binary floating point (for instance,
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
33 in binary floating point, 1.00 % 0.1 gives 0.09999999999999995 instead
62300
44cac5c565b7 Fix mild type confusion in decimal module docstring.
Mark Dickinson <dickinsm@gmail.com>
parents: 62244
diff changeset
34 of 0.0; Decimal('1.00') % Decimal('0.1') returns the expected
44cac5c565b7 Fix mild type confusion in decimal module docstring.
Mark Dickinson <dickinsm@gmail.com>
parents: 62244
diff changeset
35 Decimal('0.00')).
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
36
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
37 Here are some examples of using the decimal module:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
38
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
39 >>> from decimal import *
32529
2476a8334286 Tim gets his default traps.
Raymond Hettinger <python@rcn.com>
parents: 32528
diff changeset
40 >>> setcontext(ExtendedContext)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
41 >>> Decimal(0)
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
42 Decimal('0')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
43 >>> Decimal('1')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
44 Decimal('1')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
45 >>> Decimal('-.0123')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
46 Decimal('-0.0123')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
47 >>> Decimal(123456)
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
48 Decimal('123456')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
49 >>> Decimal('123.45e12345678901234567890')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
50 Decimal('1.2345E+12345678901234567892')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
51 >>> Decimal('1.33') + Decimal('1.27')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
52 Decimal('2.60')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
53 >>> Decimal('12.34') + Decimal('3.87') - Decimal('18.41')
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
54 Decimal('-2.20')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
55 >>> dig = Decimal(1)
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
56 >>> print(dig / Decimal(3))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
57 0.333333333
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
58 >>> getcontext().prec = 18
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
59 >>> print(dig / Decimal(3))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
60 0.333333333333333333
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
61 >>> print(dig.sqrt())
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
62 1
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
63 >>> print(Decimal(3).sqrt())
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
64 1.73205080756887729
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
65 >>> print(Decimal(3) ** 123)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
66 4.85192780976896427E+58
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
67 >>> inf = Decimal(1) / Decimal(0)
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
68 >>> print(inf)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
69 Infinity
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
70 >>> neginf = Decimal(-1) / Decimal(0)
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
71 >>> print(neginf)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
72 -Infinity
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
73 >>> print(neginf + inf)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
74 NaN
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
75 >>> print(neginf * inf)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
76 -Infinity
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
77 >>> print(dig / 0)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
78 Infinity
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
79 >>> getcontext().traps[DivisionByZero] = 1
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
80 >>> print(dig / 0)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
81 Traceback (most recent call last):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
82 ...
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
83 ...
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
84 ...
39690
0cb9e57ec406 Inspired by SF patch #860326, make the exception formatting by
Guido van Rossum <guido@python.org>
parents: 39644
diff changeset
85 decimal.DivisionByZero: x / 0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
86 >>> c = Context()
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
87 >>> c.traps[InvalidOperation] = 0
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
88 >>> print(c.flags[InvalidOperation])
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
89 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
90 >>> c.divide(Decimal(0), Decimal(0))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
91 Decimal('NaN')
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
92 >>> c.traps[InvalidOperation] = 1
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
93 >>> print(c.flags[InvalidOperation])
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
94 1
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
95 >>> c.flags[InvalidOperation] = 0
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
96 >>> print(c.flags[InvalidOperation])
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
97 0
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
98 >>> print(c.divide(Decimal(0), Decimal(0)))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
99 Traceback (most recent call last):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
100 ...
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
101 ...
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
102 ...
39690
0cb9e57ec406 Inspired by SF patch #860326, make the exception formatting by
Guido van Rossum <guido@python.org>
parents: 39644
diff changeset
103 decimal.InvalidOperation: 0 / 0
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
104 >>> print(c.flags[InvalidOperation])
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
105 1
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
106 >>> c.flags[InvalidOperation] = 0
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
107 >>> c.traps[InvalidOperation] = 0
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
108 >>> print(c.divide(Decimal(0), Decimal(0)))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
109 NaN
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
110 >>> print(c.flags[InvalidOperation])
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
111 1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
112 >>>
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
113 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
114
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
115 __all__ = [
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
116 # Two major classes
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
117 'Decimal', 'Context',
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
118
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
119 # Contexts
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
120 'DefaultContext', 'BasicContext', 'ExtendedContext',
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
121
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
122 # Exceptions
32561
6f351b1bcf53 * Update the test suite to reflect that ConversionSyntax was no longer
Raymond Hettinger <python@rcn.com>
parents: 32560
diff changeset
123 'DecimalException', 'Clamped', 'InvalidOperation', 'DivisionByZero',
6f351b1bcf53 * Update the test suite to reflect that ConversionSyntax was no longer
Raymond Hettinger <python@rcn.com>
parents: 32560
diff changeset
124 'Inexact', 'Rounded', 'Subnormal', 'Overflow', 'Underflow',
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
125
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
126 # Constants for use in setting up contexts
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
127 'ROUND_DOWN', 'ROUND_HALF_UP', 'ROUND_HALF_EVEN', 'ROUND_CEILING',
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
128 'ROUND_FLOOR', 'ROUND_UP', 'ROUND_HALF_DOWN', 'ROUND_05UP',
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
129
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
130 # Functions for manipulating contexts
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
131 'setcontext', 'getcontext', 'localcontext'
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
132 ]
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
133
53299
696dd2281841 Update links and version info.
Raymond Hettinger <python@rcn.com>
parents: 52201
diff changeset
134 __version__ = '1.70' # Highest version of the spec this complies with
66575
693f7430c3ca Add link to specification.
Raymond Hettinger <python@rcn.com>
parents: 66506
diff changeset
135 # See http://speleotrove.com/decimal/
53299
696dd2281841 Update links and version info.
Raymond Hettinger <python@rcn.com>
parents: 52201
diff changeset
136
35035
c55899863b9c Minor namespace clean-up.
Raymond Hettinger <python@rcn.com>
parents: 34812
diff changeset
137 import copy as _copy
50499
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
138 import math as _math
51297
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
139 import numbers as _numbers
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
140
44643
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
141 try:
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
142 from collections import namedtuple as _namedtuple
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
143 DecimalTuple = _namedtuple('DecimalTuple', 'sign digits exponent')
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
144 except ImportError:
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
145 DecimalTuple = lambda *args: args
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
146
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
147 # Rounding
32489
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
148 ROUND_DOWN = 'ROUND_DOWN'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
149 ROUND_HALF_UP = 'ROUND_HALF_UP'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
150 ROUND_HALF_EVEN = 'ROUND_HALF_EVEN'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
151 ROUND_CEILING = 'ROUND_CEILING'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
152 ROUND_FLOOR = 'ROUND_FLOOR'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
153 ROUND_UP = 'ROUND_UP'
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
154 ROUND_HALF_DOWN = 'ROUND_HALF_DOWN'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
155 ROUND_05UP = 'ROUND_05UP'
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
156
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
157 # Errors
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
158
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
159 class DecimalException(ArithmeticError):
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
160 """Base exception class.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
161
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
162 Used exceptions derive from this.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
163 If an exception derives from another exception besides this (such as
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
164 Underflow (Inexact, Rounded, Subnormal) that indicates that it is only
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
165 called if the others are present. This isn't actually used for
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
166 anything, though.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
167
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
168 handle -- Called when context._raise_error is called and the
61746
49d7de9d7b1a Merged revisions 81352 via svnmerge from
Stefan Krah <stefan@bytereef.org>
parents: 61214
diff changeset
169 trap_enabler is not set. First argument is self, second is the
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
170 context. More arguments can be given, those being after
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
171 the explanation in _raise_error (For example,
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
172 context._raise_error(NewError, '(-x)!', self._sign) would
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
173 call NewError().handle(context, self._sign).)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
174
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
175 To define a new exception, it should be sufficient to have it derive
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
176 from DecimalException.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
177 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
178 def handle(self, context, *args):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
179 pass
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
180
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
181
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
182 class Clamped(DecimalException):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
183 """Exponent of a 0 changed to fit bounds.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
184
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
185 This occurs and signals clamped if the exponent of a result has been
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
186 altered in order to fit the constraints of a specific concrete
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
187 representation. This may occur when the exponent of a zero result would
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
188 be outside the bounds of a representation, or when a large normal
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
189 number would have an encoded exponent that cannot be represented. In
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
190 this latter case, the exponent is reduced to fit and the corresponding
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
191 number of zero digits are appended to the coefficient ("fold-down").
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
192 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
193
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
194 class InvalidOperation(DecimalException):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
195 """An invalid operation was performed.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
196
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
197 Various bad things cause this:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
198
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
199 Something creates a signaling NaN
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
200 -INF + INF
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
201 0 * (+-)INF
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
202 (+-)INF / (+-)INF
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
203 x % 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
204 (+-)INF % x
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
205 x._rescale( non-integer )
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
206 sqrt(-x) , x > 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
207 0 ** 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
208 x ** (non-integer)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
209 x ** (+-)INF
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
210 An operand is invalid
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
211
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
212 The result of the operation after these is a quiet positive NaN,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
213 except when the cause is a signaling NaN, in which case the result is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
214 also a quiet NaN, but with the original sign, and an optional
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
215 diagnostic information.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
216 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
217 def handle(self, context, *args):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
218 if args:
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
219 ans = _dec_from_triple(args[0]._sign, args[0]._int, 'n', True)
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
220 return ans._fix_nan(context)
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
221 return _NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
222
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
223 class ConversionSyntax(InvalidOperation):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
224 """Trying to convert badly formed string.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
225
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
226 This occurs and signals invalid-operation if an string is being
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
227 converted to a number and it does not conform to the numeric string
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
228 syntax. The result is [0,qNaN].
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
229 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
230 def handle(self, context, *args):
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
231 return _NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
232
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
233 class DivisionByZero(DecimalException, ZeroDivisionError):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
234 """Division by 0.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
235
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
236 This occurs and signals division-by-zero if division of a finite number
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
237 by zero was attempted (during a divide-integer or divide operation, or a
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
238 power operation with negative right-hand operand), and the dividend was
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
239 not zero.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
240
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
241 The result of the operation is [sign,inf], where sign is the exclusive
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
242 or of the signs of the operands for divide, or is 1 for an odd power of
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
243 -0, for power.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
244 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
245
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
246 def handle(self, context, sign, *args):
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
247 return _SignedInfinity[sign]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
248
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
249 class DivisionImpossible(InvalidOperation):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
250 """Cannot perform the division adequately.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
251
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
252 This occurs and signals invalid-operation if the integer result of a
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
253 divide-integer or remainder operation had too many digits (would be
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
254 longer than precision). The result is [0,qNaN].
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
255 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
256
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
257 def handle(self, context, *args):
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
258 return _NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
259
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
260 class DivisionUndefined(InvalidOperation, ZeroDivisionError):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
261 """Undefined result of division.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
262
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
263 This occurs and signals invalid-operation if division by zero was
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
264 attempted (during a divide-integer, divide, or remainder operation), and
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
265 the dividend is also zero. The result is [0,qNaN].
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
266 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
267
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
268 def handle(self, context, *args):
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
269 return _NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
270
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
271 class Inexact(DecimalException):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
272 """Had to round, losing information.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
273
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
274 This occurs and signals inexact whenever the result of an operation is
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
275 not exact (that is, it needed to be rounded and any discarded digits
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
276 were non-zero), or if an overflow or underflow condition occurs. The
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
277 result in all cases is unchanged.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
278
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
279 The inexact signal may be tested (or trapped) to determine if a given
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
280 operation (or sequence of operations) was inexact.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
281 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
282
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
283 class InvalidContext(InvalidOperation):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
284 """Invalid context. Unknown rounding, for example.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
285
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
286 This occurs and signals invalid-operation if an invalid context was
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
287 detected during an operation. This can occur if contexts are not checked
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
288 on creation and either the precision exceeds the capability of the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
289 underlying concrete representation or an unknown or unsupported rounding
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
290 was specified. These aspects of the context need only be checked when
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
291 the values are required to be used. The result is [0,qNaN].
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
292 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
293
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
294 def handle(self, context, *args):
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
295 return _NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
296
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
297 class Rounded(DecimalException):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
298 """Number got rounded (not necessarily changed during rounding).
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
299
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
300 This occurs and signals rounded whenever the result of an operation is
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
301 rounded (that is, some zero or non-zero digits were discarded from the
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
302 coefficient), or if an overflow or underflow condition occurs. The
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
303 result in all cases is unchanged.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
304
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
305 The rounded signal may be tested (or trapped) to determine if a given
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
306 operation (or sequence of operations) caused a loss of precision.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
307 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
308
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
309 class Subnormal(DecimalException):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
310 """Exponent < Emin before rounding.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
311
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
312 This occurs and signals subnormal whenever the result of a conversion or
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
313 operation is subnormal (that is, its adjusted exponent is less than
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
314 Emin, before any rounding). The result in all cases is unchanged.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
315
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
316 The subnormal signal may be tested (or trapped) to determine if a given
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
317 or operation (or sequence of operations) yielded a subnormal result.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
318 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
319
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
320 class Overflow(Inexact, Rounded):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
321 """Numerical overflow.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
322
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
323 This occurs and signals overflow if the adjusted exponent of a result
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
324 (from a conversion or from an operation that is not an attempt to divide
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
325 by zero), after rounding, would be greater than the largest value that
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
326 can be handled by the implementation (the value Emax).
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
327
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
328 The result depends on the rounding mode:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
329
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
330 For round-half-up and round-half-even (and for round-half-down and
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
331 round-up, if implemented), the result of the operation is [sign,inf],
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
332 where sign is the sign of the intermediate result. For round-down, the
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
333 result is the largest finite number that can be represented in the
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
334 current precision, with the sign of the intermediate result. For
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
335 round-ceiling, the result is the same as for round-down if the sign of
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
336 the intermediate result is 1, or is [0,inf] otherwise. For round-floor,
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
337 the result is the same as for round-down if the sign of the intermediate
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
338 result is 0, or is [1,inf] otherwise. In all cases, Inexact and Rounded
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
339 will also be raised.
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
340 """
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
341
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
342 def handle(self, context, sign, *args):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
343 if context.rounding in (ROUND_HALF_UP, ROUND_HALF_EVEN,
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
344 ROUND_HALF_DOWN, ROUND_UP):
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
345 return _SignedInfinity[sign]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
346 if sign == 0:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
347 if context.rounding == ROUND_CEILING:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
348 return _SignedInfinity[sign]
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
349 return _dec_from_triple(sign, '9'*context.prec,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
350 context.Emax-context.prec+1)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
351 if sign == 1:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
352 if context.rounding == ROUND_FLOOR:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
353 return _SignedInfinity[sign]
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
354 return _dec_from_triple(sign, '9'*context.prec,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
355 context.Emax-context.prec+1)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
356
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
357
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
358 class Underflow(Inexact, Rounded, Subnormal):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
359 """Numerical underflow with result rounded to 0.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
360
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
361 This occurs and signals underflow if a result is inexact and the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
362 adjusted exponent of the result would be smaller (more negative) than
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
363 the smallest value that can be handled by the implementation (the value
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
364 Emin). That is, the result is both inexact and subnormal.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
365
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
366 The result after an underflow will be a subnormal number rounded, if
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
367 necessary, so that its exponent is not less than Etiny. This may result
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
368 in 0 with the sign of the intermediate result and an exponent of Etiny.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
369
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
370 In all cases, Inexact, Rounded, and Subnormal will also be raised.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
371 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
372
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
373 # List of public traps and flags
32666
c13d911ae05b * Rename "Signals" to "_signals" making it non-public.
Raymond Hettinger <python@rcn.com>
parents: 32576
diff changeset
374 _signals = [Clamped, DivisionByZero, Inexact, Overflow, Rounded,
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
375 Underflow, InvalidOperation, Subnormal]
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
376
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
377 # Map conditions (per the spec) to signals
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
378 _condition_map = {ConversionSyntax:InvalidOperation,
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
379 DivisionImpossible:InvalidOperation,
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
380 DivisionUndefined:InvalidOperation,
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
381 InvalidContext:InvalidOperation}
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
382
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
383 ##### Context Functions ##################################################
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
384
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
385 # The getcontext() and setcontext() function manage access to a thread-local
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
386 # current context. Py2.4 offers direct support for thread locals. If that
47674
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
387 # is not available, use threading.current_thread() which is slower but will
34184
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
388 # work for older Pythons. If threads are not part of the build, create a
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
389 # mock threading object with threading.local() returning the module namespace.
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
390
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
391 try:
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
392 import threading
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
393 except ImportError:
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
394 # Python was compiled without threads; create a mock object instead
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
395 import sys
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
396 class MockThreading(object):
34184
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
397 def local(self, sys=sys):
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
398 return sys.modules[__name__]
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
399 threading = MockThreading()
36cf94f57415 Bug #1083645
Raymond Hettinger <python@rcn.com>
parents: 34023
diff changeset
400 del sys, MockThreading
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
401
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
402 try:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
403 threading.local
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
404
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
405 except AttributeError:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
406
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
407 # To fix reloading, force it to create a new context
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
408 # Old contexts have different exceptions in their dicts, making problems.
47674
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
409 if hasattr(threading.current_thread(), '__decimal_context__'):
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
410 del threading.current_thread().__decimal_context__
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
411
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
412 def setcontext(context):
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
413 """Set this thread's context to context."""
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
414 if context in (DefaultContext, BasicContext, ExtendedContext):
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
415 context = context.copy()
32980
e89ef0bfa1ff SF bug #1002530: test_decimal fails if repeated
Raymond Hettinger <python@rcn.com>
parents: 32675
diff changeset
416 context.clear_flags()
47674
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
417 threading.current_thread().__decimal_context__ = context
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
418
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
419 def getcontext():
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
420 """Returns this thread's context.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
421
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
422 If this thread does not yet have a context, returns
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
423 a new context and sets this thread's context.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
424 New contexts are copies of DefaultContext.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
425 """
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
426 try:
47674
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
427 return threading.current_thread().__decimal_context__
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
428 except AttributeError:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
429 context = Context()
47674
8f61ae01130f Fix last traces of old threading API.
Georg Brandl <georg@python.org>
parents: 46789
diff changeset
430 threading.current_thread().__decimal_context__ = context
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
431 return context
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
432
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
433 else:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
434
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
435 local = threading.local()
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
436 if hasattr(local, '__decimal_context__'):
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
437 del local.__decimal_context__
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
438
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
439 def getcontext(_local=local):
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
440 """Returns this thread's context.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
441
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
442 If this thread does not yet have a context, returns
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
443 a new context and sets this thread's context.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
444 New contexts are copies of DefaultContext.
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
445 """
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
446 try:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
447 return _local.__decimal_context__
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
448 except AttributeError:
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
449 context = Context()
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
450 _local.__decimal_context__ = context
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
451 return context
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
452
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
453 def setcontext(context, _local=local):
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
454 """Set this thread's context to context."""
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
455 if context in (DefaultContext, BasicContext, ExtendedContext):
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
456 context = context.copy()
32980
e89ef0bfa1ff SF bug #1002530: test_decimal fails if repeated
Raymond Hettinger <python@rcn.com>
parents: 32675
diff changeset
457 context.clear_flags()
32675
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
458 _local.__decimal_context__ = context
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
459
949473fa4828 Use threading.local() instead of threading.currentThread().
Raymond Hettinger <python@rcn.com>
parents: 32674
diff changeset
460 del threading, local # Don't contaminate the namespace
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
461
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
462 def localcontext(ctx=None):
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
463 """Return a context manager for a copy of the supplied context
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
464
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
465 Uses a copy of the current context if no context is specified
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
466 The returned context manager creates a local decimal context
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
467 in a with statement:
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
468 def sin(x):
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
469 with localcontext() as ctx:
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
470 ctx.prec += 2
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
471 # Rest of sin calculation algorithm
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
472 # uses a precision 2 greater than normal
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
473 return +s # Convert result to normal precision
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
474
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
475 def sin(x):
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
476 with localcontext(ExtendedContext):
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
477 # Rest of sin calculation algorithm
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
478 # uses the Extended Context from the
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
479 # General Decimal Arithmetic Specification
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
480 return +s # Convert result to normal context
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
481
46664
031dfe455585 Merged revisions 62425-62429,62434-62436,62441,62444,62446-62448,62450-62455,62463,62465-62466,62469,62474,62476-62478,62480,62485,62492,62497-62498,62500,62507,62513-62514,62516,62521,62531,62535,62545-62546,62548-62551,62553-62559,62569,62574,62577,62593,62595,62604-62606,62608,62616,62626-62627,62636,62638,62644-62645,62647-62648,62651-62653,62656,62661,62663,62680,62686-62687,62696,62699-62703,62711 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 46650
diff changeset
482 >>> setcontext(DefaultContext)
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
483 >>> print(getcontext().prec)
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
484 28
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
485 >>> with localcontext():
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
486 ... ctx = getcontext()
40893
32c4897b5d46 Merged revisions 53623-53858 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 40785
diff changeset
487 ... ctx.prec += 2
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
488 ... print(ctx.prec)
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
489 ...
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
490 30
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
491 >>> with localcontext(ExtendedContext):
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
492 ... print(getcontext().prec)
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
493 ...
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
494 9
40785
22760d53d4da Fix a bunch of doctests with the -d option of refactor.py.
Guido van Rossum <guido@python.org>
parents: 40644
diff changeset
495 >>> print(getcontext().prec)
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
496 28
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
497 """
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
498 if ctx is None: ctx = getcontext()
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
499 return _ContextManager(ctx)
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
500
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
501
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
502 ##### Decimal class #######################################################
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
503
50930
5a041d9a51cd Issue 4998: Decimal should not subclass or register with numbers.Real.
Raymond Hettinger <python@rcn.com>
parents: 50602
diff changeset
504 # Do not subclass Decimal from numbers.Real and do not register it as such
5a041d9a51cd Issue 4998: Decimal should not subclass or register with numbers.Real.
Raymond Hettinger <python@rcn.com>
parents: 50602
diff changeset
505 # (because Decimals are not interoperable with floats). See the notes in
5a041d9a51cd Issue 4998: Decimal should not subclass or register with numbers.Real.
Raymond Hettinger <python@rcn.com>
parents: 50602
diff changeset
506 # numbers.py for more detail.
5a041d9a51cd Issue 4998: Decimal should not subclass or register with numbers.Real.
Raymond Hettinger <python@rcn.com>
parents: 50602
diff changeset
507
5a041d9a51cd Issue 4998: Decimal should not subclass or register with numbers.Real.
Raymond Hettinger <python@rcn.com>
parents: 50602
diff changeset
508 class Decimal(object):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
509 """Floating point class for decimal arithmetic."""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
510
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
511 __slots__ = ('_exp','_int','_sign', '_is_special')
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
512 # Generally, the value of the Decimal instance is given by
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
513 # (-1)**_sign * _int * 10**_exp
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
514 # Special values are signified by _is_special == True
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
515
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
516 # We're immutable, so use __new__ not __init__
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
517 def __new__(cls, value="0", context=None):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
518 """Create a decimal point instance.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
519
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
520 >>> Decimal('3.14') # string input
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
521 Decimal('3.14')
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
522 >>> Decimal((0, (3, 1, 4), -2)) # tuple (sign, digit_tuple, exponent)
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
523 Decimal('3.14')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
524 >>> Decimal(314) # int
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
525 Decimal('314')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
526 >>> Decimal(Decimal(314)) # another decimal instance
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
527 Decimal('314')
44654
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
528 >>> Decimal(' 3.14 \\n') # leading and trailing whitespace okay
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
529 Decimal('3.14')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
530 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
531
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
532 # Note that the coefficient, self._int, is actually stored as
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
533 # a string rather than as a tuple of digits. This speeds up
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
534 # the "digits to integer" and "integer to digits" conversions
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
535 # that are used in almost every arithmetic operation on
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
536 # Decimals. This is an internal detail: the as_tuple function
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
537 # and the Decimal constructor still deal with tuples of
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
538 # digits.
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
539
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
540 self = object.__new__(cls)
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
541
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
542 # From a string
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
543 # REs insist on real strings, so we can too.
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
544 if isinstance(value, str):
44654
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
545 m = _parser(value.strip())
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
546 if m is None:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
547 if context is None:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
548 context = getcontext()
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
549 return context._raise_error(ConversionSyntax,
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
550 "Invalid literal for Decimal: %r" % value)
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
551
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
552 if m.group('sign') == "-":
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
553 self._sign = 1
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
554 else:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
555 self._sign = 0
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
556 intpart = m.group('int')
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
557 if intpart is not None:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
558 # finite number
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
559 fracpart = m.group('frac') or ''
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
560 exp = int(m.group('exp') or '0')
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
561 self._int = str(int(intpart+fracpart))
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
562 self._exp = exp - len(fracpart)
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
563 self._is_special = False
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
564 else:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
565 diag = m.group('diag')
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
566 if diag is not None:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
567 # NaN
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
568 self._int = str(int(diag or '0')).lstrip('0')
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
569 if m.group('signal'):
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
570 self._exp = 'N'
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
571 else:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
572 self._exp = 'n'
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
573 else:
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
574 # infinity
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
575 self._int = '0'
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
576 self._exp = 'F'
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
577 self._is_special = True
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
578 return self
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
579
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
580 # From an integer
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
581 if isinstance(value, int):
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
582 if value >= 0:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
583 self._sign = 0
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
584 else:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
585 self._sign = 1
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
586 self._exp = 0
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
587 self._int = str(abs(value))
44070
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
588 self._is_special = False
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
589 return self
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
590
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
591 # From another decimal
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
592 if isinstance(value, Decimal):
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
593 self._exp = value._exp
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
594 self._sign = value._sign
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
595 self._int = value._int
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
596 self._is_special = value._is_special
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
597 return self
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
598
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
599 # From an internal working value
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
600 if isinstance(value, _WorkRep):
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
601 self._sign = value.sign
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
602 self._int = str(value.int)
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
603 self._exp = int(value.exp)
f564405c8104 Merged revisions 59234-59238 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44025
diff changeset
604 self._is_special = False
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
605 return self
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
606
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
607 # tuple/list conversion (possibly from as_tuple())
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
608 if isinstance(value, (list,tuple)):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
609 if len(value) != 3:
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
610 raise ValueError('Invalid tuple size in creation of Decimal '
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
611 'from list or tuple. The list or tuple '
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
612 'should have exactly three elements.')
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
613 # process sign. The isinstance test rejects floats
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
614 if not (isinstance(value[0], int) and value[0] in (0,1)):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
615 raise ValueError("Invalid sign. The first value in the tuple "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
616 "should be an integer; either 0 for a "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
617 "positive number or 1 for a negative number.")
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
618 self._sign = value[0]
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
619 if value[2] == 'F':
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
620 # infinity: value[1] is ignored
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
621 self._int = '0'
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
622 self._exp = value[2]
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
623 self._is_special = True
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
624 else:
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
625 # process and validate the digits in value[1]
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
626 digits = []
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
627 for digit in value[1]:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
628 if isinstance(digit, int) and 0 <= digit <= 9:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
629 # skip leading zeros
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
630 if digits or digit != 0:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
631 digits.append(digit)
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
632 else:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
633 raise ValueError("The second value in the tuple must "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
634 "be composed of integers in the range "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
635 "0 through 9.")
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
636 if value[2] in ('n', 'N'):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
637 # NaN: digits form the diagnostic
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
638 self._int = ''.join(map(str, digits))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
639 self._exp = value[2]
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
640 self._is_special = True
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
641 elif isinstance(value[2], int):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
642 # finite number: digits give the coefficient
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
643 self._int = ''.join(map(str, digits or [0]))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
644 self._exp = value[2]
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
645 self._is_special = False
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
646 else:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
647 raise ValueError("The third value in the tuple must "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
648 "be an integer, or one of the "
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
649 "strings 'F', 'n', 'N'.")
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
650 return self
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
651
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
652 if isinstance(value, float):
60166
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
653 value = Decimal.from_float(value)
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
654 self._exp = value._exp
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
655 self._sign = value._sign
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
656 self._int = value._int
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
657 self._is_special = value._is_special
d1101aa984c0 Issue 8257: Decimal constructor to accept float argument.
Raymond Hettinger <python@rcn.com>
parents: 58936
diff changeset
658 return self
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
659
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
660 raise TypeError("Cannot convert %r to Decimal" % value)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
661
50597
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
662 # @classmethod, but @decorator is not valid Python 2.3 syntax, so
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
663 # don't use it (see notes on Py2.3 compatibility at top of file)
50499
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
664 def from_float(cls, f):
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
665 """Converts a float to a decimal number, exactly.
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
666
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
667 Note that Decimal.from_float(0.1) is not the same as Decimal('0.1').
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
668 Since 0.1 is not exactly representable in binary floating point, the
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
669 value is stored as the nearest representable value which is
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
670 0x1.999999999999ap-4. The exact equivalent of the value in decimal
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
671 is 0.1000000000000000055511151231257827021181583404541015625.
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
672
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
673 >>> Decimal.from_float(0.1)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
674 Decimal('0.1000000000000000055511151231257827021181583404541015625')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
675 >>> Decimal.from_float(float('nan'))
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
676 Decimal('NaN')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
677 >>> Decimal.from_float(float('inf'))
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
678 Decimal('Infinity')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
679 >>> Decimal.from_float(-float('inf'))
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
680 Decimal('-Infinity')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
681 >>> Decimal.from_float(-0.0)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
682 Decimal('-0')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
683
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
684 """
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
685 if isinstance(f, int): # handle integer inputs
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
686 return cls(f)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
687 if _math.isinf(f) or _math.isnan(f): # raises TypeError if not a float
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
688 return cls(repr(f))
50597
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
689 if _math.copysign(1.0, f) == 1.0:
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
690 sign = 0
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
691 else:
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
692 sign = 1
50499
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
693 n, d = abs(f).as_integer_ratio()
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
694 k = d.bit_length() - 1
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
695 result = _dec_from_triple(sign, str(n*5**k), -k)
50597
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
696 if cls is Decimal:
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
697 return result
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
698 else:
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
699 return cls(result)
40ba2a1253fa Merged revisions 68314 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50499
diff changeset
700 from_float = classmethod(from_float)
50499
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
701
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
702 def _isnan(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
703 """Returns whether the number is not actually one.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
704
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
705 0 if a number
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
706 1 if NaN
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
707 2 if sNaN
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
708 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
709 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
710 exp = self._exp
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
711 if exp == 'n':
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
712 return 1
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
713 elif exp == 'N':
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
714 return 2
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
715 return 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
716
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
717 def _isinfinity(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
718 """Returns whether the number is infinite
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
719
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
720 0 if finite or not a number
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
721 1 if +INF
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
722 -1 if -INF
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
723 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
724 if self._exp == 'F':
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
725 if self._sign:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
726 return -1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
727 return 1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
728 return 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
729
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
730 def _check_nans(self, other=None, context=None):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
731 """Returns whether the number is not actually one.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
732
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
733 if self, other are sNaN, signal
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
734 if self, other are NaN return nan
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
735 return 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
736
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
737 Done before operations.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
738 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
739
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
740 self_is_nan = self._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
741 if other is None:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
742 other_is_nan = False
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
743 else:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
744 other_is_nan = other._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
745
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
746 if self_is_nan or other_is_nan:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
747 if context is None:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
748 context = getcontext()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
749
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
750 if self_is_nan == 2:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
751 return context._raise_error(InvalidOperation, 'sNaN',
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
752 self)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
753 if other_is_nan == 2:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
754 return context._raise_error(InvalidOperation, 'sNaN',
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
755 other)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
756 if self_is_nan:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
757 return self._fix_nan(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
758
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
759 return other._fix_nan(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
760 return 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
761
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
762 def _compare_check_nans(self, other, context):
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
763 """Version of _check_nans used for the signaling comparisons
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
764 compare_signal, __le__, __lt__, __ge__, __gt__.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
765
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
766 Signal InvalidOperation if either self or other is a (quiet
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
767 or signaling) NaN. Signaling NaNs take precedence over quiet
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
768 NaNs.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
769
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
770 Return 0 if neither operand is a NaN.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
771
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
772 """
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
773 if context is None:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
774 context = getcontext()
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
775
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
776 if self._is_special or other._is_special:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
777 if self.is_snan():
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
778 return context._raise_error(InvalidOperation,
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
779 'comparison involving sNaN',
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
780 self)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
781 elif other.is_snan():
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
782 return context._raise_error(InvalidOperation,
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
783 'comparison involving sNaN',
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
784 other)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
785 elif self.is_qnan():
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
786 return context._raise_error(InvalidOperation,
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
787 'comparison involving NaN',
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
788 self)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
789 elif other.is_qnan():
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
790 return context._raise_error(InvalidOperation,
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
791 'comparison involving NaN',
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
792 other)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
793 return 0
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
794
40401
88133417dfd0 - patch #1600346 submitted by Tomer Filiba
Jack Diederich <jackdied@gmail.com>
parents: 39690
diff changeset
795 def __bool__(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
796 """Return True if self is nonzero; otherwise return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
797
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
798 NaNs and infinities are considered nonzero.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
799 """
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
800 return self._is_special or self._int != '0'
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
801
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
802 def _cmp(self, other):
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
803 """Compare the two non-NaN decimal instances self and other.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
804
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
805 Returns -1 if self < other, 0 if self == other and 1
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
806 if self > other. This routine is for internal use only."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
807
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
808 if self._is_special or other._is_special:
51029
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
809 self_inf = self._isinfinity()
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
810 other_inf = other._isinfinity()
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
811 if self_inf == other_inf:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
812 return 0
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
813 elif self_inf < other_inf:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
814 return -1
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
815 else:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
816 return 1
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
817
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
818 # check for zeros; Decimal('0') == Decimal('-0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
819 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
820 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
821 return 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
822 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
823 return -((-1)**other._sign)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
824 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
825 return (-1)**self._sign
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
826
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
827 # If different signs, neg one is less
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
828 if other._sign < self._sign:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
829 return -1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
830 if self._sign < other._sign:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
831 return 1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
832
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
833 self_adjusted = self.adjusted()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
834 other_adjusted = other.adjusted()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
835 if self_adjusted == other_adjusted:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
836 self_padded = self._int + '0'*(self._exp - other._exp)
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
837 other_padded = other._int + '0'*(other._exp - self._exp)
51029
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
838 if self_padded == other_padded:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
839 return 0
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
840 elif self_padded < other_padded:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
841 return -(-1)**self._sign
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
842 else:
fd8af46d3615 Merged revisions 68920 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50930
diff changeset
843 return (-1)**self._sign
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
844 elif self_adjusted > other_adjusted:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
845 return (-1)**self._sign
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
846 else: # self_adjusted < other_adjusted
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
847 return -((-1)**self._sign)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
848
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
849 # Note: The Decimal standard doesn't cover rich comparisons for
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
850 # Decimals. In particular, the specification is silent on the
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
851 # subject of what should happen for a comparison involving a NaN.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
852 # We take the following approach:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
853 #
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
854 # == comparisons involving a quiet NaN always return False
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
855 # != comparisons involving a quiet NaN always return True
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
856 # == or != comparisons involving a signaling NaN signal
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
857 # InvalidOperation, and return False or True as above if the
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
858 # InvalidOperation is not trapped.
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
859 # <, >, <= and >= comparisons involving a (quiet or signaling)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
860 # NaN signal InvalidOperation, and return False if the
45278
e67050d62adf Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60706,60708-60712,60714-60724 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45244
diff changeset
861 # InvalidOperation is not trapped.
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
862 #
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
863 # This behavior is designed to conform as closely as possible to
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
864 # that specified by IEEE 754.
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
865
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
866 def __eq__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
867 self, other = _convert_for_comparison(self, other, equality_op=True)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
868 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
869 return other
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
870 if self._check_nans(other, context):
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
871 return False
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
872 return self._cmp(other) == 0
32505
191796b7a054 * Add __eq__ and __ne__ so that things like list.index() work properly
Raymond Hettinger <python@rcn.com>
parents: 32499
diff changeset
873
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
874 def __ne__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
875 self, other = _convert_for_comparison(self, other, equality_op=True)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
876 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
877 return other
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
878 if self._check_nans(other, context):
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
879 return True
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
880 return self._cmp(other) != 0
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
881
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
882
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
883 def __lt__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
884 self, other = _convert_for_comparison(self, other)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
885 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
886 return other
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
887 ans = self._compare_check_nans(other, context)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
888 if ans:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
889 return False
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
890 return self._cmp(other) < 0
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
891
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
892 def __le__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
893 self, other = _convert_for_comparison(self, other)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
894 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
895 return other
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
896 ans = self._compare_check_nans(other, context)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
897 if ans:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
898 return False
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
899 return self._cmp(other) <= 0
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
900
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
901 def __gt__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
902 self, other = _convert_for_comparison(self, other)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
903 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
904 return other
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
905 ans = self._compare_check_nans(other, context)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
906 if ans:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
907 return False
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
908 return self._cmp(other) > 0
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
909
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
910 def __ge__(self, other, context=None):
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
911 self, other = _convert_for_comparison(self, other)
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
912 if other is NotImplemented:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
913 return other
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
914 ans = self._compare_check_nans(other, context)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
915 if ans:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
916 return False
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
917 return self._cmp(other) >= 0
39644
13d5e5f0e993 Restructure comparison dramatically. There is no longer a default
Guido van Rossum <guido@python.org>
parents: 38453
diff changeset
918
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
919 def compare(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
920 """Compares one to another.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
921
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
922 -1 => a < b
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
923 0 => a = b
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
924 1 => a > b
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
925 NaN => one is NaN
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
926 Like __cmp__, but returns Decimal instances.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
927 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
928 other = _convert_other(other, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
929
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
930 # Compare(NaN, NaN) = NaN
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
931 if (self._is_special or other and other._is_special):
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
932 ans = self._check_nans(other, context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
933 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
934 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
935
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
936 return Decimal(self._cmp(other))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
937
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
938 def __hash__(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
939 """x.__hash__() <==> hash(x)"""
61873
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
940
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
941 # In order to make sure that the hash of a Decimal instance
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
942 # agrees with the hash of a numerically equal integer, float
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
943 # or Fraction, we follow the rules for numeric hashes outlined
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
944 # in the documentation. (See library docs, 'Built-in Types').
34758
50509ee96364 Bug #1163325: "special" decimals aren't hashable
Raymond Hettinger <python@rcn.com>
parents: 34638
diff changeset
945 if self._is_special:
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
946 if self.is_snan():
66346
9a0c2401c6a6 Revert r86517
Raymond Hettinger <python@rcn.com>
parents: 66236
diff changeset
947 raise TypeError('Cannot hash a signaling NaN value.')
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
948 elif self.is_nan():
61873
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
949 return _PyHASH_NAN
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
950 else:
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
951 if self._sign:
61873
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
952 return -_PyHASH_INF
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
953 else:
61873
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
954 return _PyHASH_INF
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
955
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
956 if self._exp >= 0:
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
957 exp_hash = pow(10, self._exp, _PyHASH_MODULUS)
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
958 else:
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
959 exp_hash = pow(_PyHASH_10INV, -self._exp, _PyHASH_MODULUS)
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
960 hash_ = int(self._int) * exp_hash % _PyHASH_MODULUS
66215
c9fb30fd1f0a Issue #10356: Decimal(-1).__hash__() should equal hash(Decimal(-1)).
Stefan Krah <stefan@bytereef.org>
parents: 62869
diff changeset
961 ans = hash_ if self >= 0 else -hash_
c9fb30fd1f0a Issue #10356: Decimal(-1).__hash__() should equal hash(Decimal(-1)).
Stefan Krah <stefan@bytereef.org>
parents: 62869
diff changeset
962 return -2 if ans == -1 else ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
963
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
964 def as_tuple(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
965 """Represents the number as a triple tuple.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
966
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
967 To show the internals exactly as they are.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
968 """
44643
d8e4342c145e Merged revisions 59883-59920 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44604
diff changeset
969 return DecimalTuple(self._sign, tuple(map(int, self._int)), self._exp)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
970
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
971 def __repr__(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
972 """Represents the number as an instance of Decimal."""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
973 # Invariant: eval(repr(d)) == d
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
974 return "Decimal('%s')" % str(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
975
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
976 def __str__(self, eng=False, context=None):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
977 """Return string representation of the number in scientific notation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
978
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
979 Captures all of the information in the underlying representation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
980 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
981
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
982 sign = ['', '-'][self._sign]
35113
adf189eb4f58 Apply the _is_special guard.
Raymond Hettinger <python@rcn.com>
parents: 35035
diff changeset
983 if self._is_special:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
984 if self._exp == 'F':
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
985 return sign + 'Infinity'
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
986 elif self._exp == 'n':
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
987 return sign + 'NaN' + self._int
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
988 else: # self._exp == 'N'
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
989 return sign + 'sNaN' + self._int
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
990
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
991 # number of digits of self._int to left of decimal point
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
992 leftdigits = self._exp + len(self._int)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
993
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
994 # dotplace is number of digits of self._int to the left of the
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
995 # decimal point in the mantissa of the output string (that is,
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
996 # after adjusting the exponent)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
997 if self._exp <= 0 and leftdigits > -6:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
998 # no exponent required
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
999 dotplace = leftdigits
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1000 elif not eng:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1001 # usual scientific notation: 1 digit on left of the point
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1002 dotplace = 1
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1003 elif self._int == '0':
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1004 # engineering notation, zero
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1005 dotplace = (leftdigits + 1) % 3 - 1
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1006 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1007 # engineering notation, nonzero
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1008 dotplace = (leftdigits - 1) % 3 + 1
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1009
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1010 if dotplace <= 0:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1011 intpart = '0'
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1012 fracpart = '.' + '0'*(-dotplace) + self._int
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1013 elif dotplace >= len(self._int):
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1014 intpart = self._int+'0'*(dotplace-len(self._int))
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1015 fracpart = ''
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1016 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1017 intpart = self._int[:dotplace]
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1018 fracpart = '.' + self._int[dotplace:]
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1019 if leftdigits == dotplace:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1020 exp = ''
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1021 else:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1022 if context is None:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1023 context = getcontext()
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1024 exp = ['e', 'E'][context.capitals] + "%+d" % (leftdigits-dotplace)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1025
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1026 return sign + intpart + fracpart + exp
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1027
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1028 def to_eng_string(self, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1029 """Convert to engineering-type string.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1030
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1031 Engineering notation has an exponent which is a multiple of 3, so there
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1032 are up to 3 digits left of the decimal place.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1033
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1034 Same rules for when in exponential and when as a value as in __str__.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1035 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1036 return self.__str__(eng=True, context=context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1037
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1038 def __neg__(self, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1039 """Returns a copy with the sign switched.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1040
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1041 Rounds, if it has reason.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1042 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1043 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1044 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1045 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1046 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1047
68395
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1048 if context is None:
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1049 context = getcontext()
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1050
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1051 if not self and context.rounding != ROUND_FLOOR:
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1052 # -Decimal('0') is Decimal('0'), not Decimal('-0'), except
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1053 # in ROUND_FLOOR rounding mode.
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1054 ans = self.copy_abs()
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1055 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1056 ans = self.copy_negate()
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1057
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1058 return ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1059
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1060 def __pos__(self, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1061 """Returns a copy, unless it is a sNaN.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1062
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1063 Rounds the number (if more then precision digits)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1064 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1065 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1066 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1067 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1068 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1069
68395
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1070 if context is None:
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1071 context = getcontext()
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1072
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1073 if not self and context.rounding != ROUND_FLOOR:
1c4be28cda5b Issue 11131: Fix sign of zero result on decimal.Decimal plus and minus operations in ROUND_FLOOR rounding mode.
Mark Dickinson <mdickinson@enthought.com>
parents: 62870
diff changeset
1074 # + (-0) = 0, except in ROUND_FLOOR rounding mode.
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1075 ans = self.copy_abs()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1076 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1077 ans = Decimal(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1078
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1079 return ans._fix(context)
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1080
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1081 def __abs__(self, round=True, context=None):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1082 """Returns the absolute value of self.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1083
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1084 If the keyword argument 'round' is false, do not round. The
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1085 expression self.__abs__(round=False) is equivalent to
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1086 self.copy_abs().
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1087 """
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1088 if not round:
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1089 return self.copy_abs()
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1090
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1091 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1092 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1093 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1094 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1095
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1096 if self._sign:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1097 ans = self.__neg__(context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1098 else:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1099 ans = self.__pos__(context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1100
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1101 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1102
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1103 def __add__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1104 """Returns self + other.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1105
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1106 -INF + INF (or the reverse) cause InvalidOperation errors.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1107 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1108 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1109 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1110 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1111
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1112 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1113 context = getcontext()
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1114
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1115 if self._is_special or other._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1116 ans = self._check_nans(other, context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1117 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1118 return ans
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1119
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1120 if self._isinfinity():
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1121 # If both INF, same sign => same as both, opposite => error.
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1122 if self._sign != other._sign and other._isinfinity():
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1123 return context._raise_error(InvalidOperation, '-INF + INF')
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1124 return Decimal(self)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1125 if other._isinfinity():
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1126 return Decimal(other) # Can't both be infinity here
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1127
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1128 exp = min(self._exp, other._exp)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1129 negativezero = 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1130 if context.rounding == ROUND_FLOOR and self._sign != other._sign:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1131 # If the answer is 0, the sign should be negative, in this case.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1132 negativezero = 1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1133
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1134 if not self and not other:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1135 sign = min(self._sign, other._sign)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1136 if negativezero:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1137 sign = 1
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1138 ans = _dec_from_triple(sign, '0', exp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1139 ans = ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1140 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1141 if not self:
33845
032f342efcd2 Very few little improvements.
Facundo Batista <facundobatista@gmail.com>
parents: 33803
diff changeset
1142 exp = max(exp, other._exp - context.prec-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1143 ans = other._rescale(exp, context.rounding)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1144 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1145 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1146 if not other:
33845
032f342efcd2 Very few little improvements.
Facundo Batista <facundobatista@gmail.com>
parents: 33803
diff changeset
1147 exp = max(exp, self._exp - context.prec-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1148 ans = self._rescale(exp, context.rounding)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1149 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1150 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1151
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1152 op1 = _WorkRep(self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1153 op2 = _WorkRep(other)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1154 op1, op2 = _normalize(op1, op2, context.prec)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1155
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1156 result = _WorkRep()
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1157 if op1.sign != op2.sign:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1158 # Equal and opposite
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1159 if op1.int == op2.int:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1160 ans = _dec_from_triple(negativezero, '0', exp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1161 ans = ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1162 return ans
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1163 if op1.int < op2.int:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1164 op1, op2 = op2, op1
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1165 # OK, now abs(op1) > abs(op2)
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1166 if op1.sign == 1:
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1167 result.sign = 1
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1168 op1.sign, op2.sign = op2.sign, op1.sign
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1169 else:
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1170 result.sign = 0
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1171 # So we know the sign, and op1 > 0.
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1172 elif op1.sign == 1:
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1173 result.sign = 1
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1174 op1.sign, op2.sign = (0, 0)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1175 else:
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1176 result.sign = 0
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
1177 # Now, op1 > abs(op2) > 0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1178
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
1179 if op2.sign == 0:
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1180 result.int = op1.int + op2.int
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1181 else:
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1182 result.int = op1.int - op2.int
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1183
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1184 result.exp = op1.exp
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1185 ans = Decimal(result)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1186 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1187 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1188
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1189 __radd__ = __add__
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1190
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1191 def __sub__(self, other, context=None):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1192 """Return self - other"""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1193 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1194 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1195 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1196
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1197 if self._is_special or other._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1198 ans = self._check_nans(other, context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1199 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1200 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1201
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1202 # self - other is computed as self + other.copy_negate()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1203 return self.__add__(other.copy_negate(), context=context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1204
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1205 def __rsub__(self, other, context=None):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1206 """Return other - self"""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1207 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1208 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1209 return other
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1210
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1211 return other.__sub__(self, context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1212
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1213 def __mul__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1214 """Return self * other.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1215
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1216 (+-) INF * 0 (or its reverse) raise InvalidOperation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1217 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1218 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1219 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1220 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1221
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1222 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1223 context = getcontext()
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1224
32561
6f351b1bcf53 * Update the test suite to reflect that ConversionSyntax was no longer
Raymond Hettinger <python@rcn.com>
parents: 32560
diff changeset
1225 resultsign = self._sign ^ other._sign
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1226
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1227 if self._is_special or other._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1228 ans = self._check_nans(other, context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1229 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1230 return ans
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1231
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1232 if self._isinfinity():
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1233 if not other:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1234 return context._raise_error(InvalidOperation, '(+-)INF * 0')
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1235 return _SignedInfinity[resultsign]
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1236
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1237 if other._isinfinity():
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1238 if not self:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1239 return context._raise_error(InvalidOperation, '0 * (+-)INF')
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1240 return _SignedInfinity[resultsign]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1241
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1242 resultexp = self._exp + other._exp
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1243
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1244 # Special case for multiplying by zero
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1245 if not self or not other:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1246 ans = _dec_from_triple(resultsign, '0', resultexp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1247 # Fixing in case the exponent is out of bounds
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1248 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1249 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1250
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1251 # Special case for multiplying by power of 10
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1252 if self._int == '1':
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1253 ans = _dec_from_triple(resultsign, other._int, resultexp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1254 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1255 return ans
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1256 if other._int == '1':
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1257 ans = _dec_from_triple(resultsign, self._int, resultexp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1258 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1259 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1260
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1261 op1 = _WorkRep(self)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1262 op2 = _WorkRep(other)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1263
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1264 ans = _dec_from_triple(resultsign, str(op1.int * op2.int), resultexp)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1265 ans = ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1266
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1267 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1268 __rmul__ = __mul__
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1269
37191
4bfe8afe8f65 Get rid of remnants of integer division
Neal Norwitz <nnorwitz@gmail.com>
parents: 36926
diff changeset
1270 def __truediv__(self, other, context=None):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1271 """Return self / other."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1272 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1273 if other is NotImplemented:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1274 return NotImplemented
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1275
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1276 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1277 context = getcontext()
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1278
32561
6f351b1bcf53 * Update the test suite to reflect that ConversionSyntax was no longer
Raymond Hettinger <python@rcn.com>
parents: 32560
diff changeset
1279 sign = self._sign ^ other._sign
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1280
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1281 if self._is_special or other._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1282 ans = self._check_nans(other, context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1283 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1284 return ans
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1285
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1286 if self._isinfinity() and other._isinfinity():
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1287 return context._raise_error(InvalidOperation, '(+-)INF/(+-)INF')
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1288
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1289 if self._isinfinity():
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1290 return _SignedInfinity[sign]
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1291
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1292 if other._isinfinity():
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1293 context._raise_error(Clamped, 'Division by infinity')
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1294 return _dec_from_triple(sign, '0', context.Etiny())
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1295
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1296 # Special cases for zeroes
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1297 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1298 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1299 return context._raise_error(DivisionUndefined, '0 / 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1300 return context._raise_error(DivisionByZero, 'x / 0', sign)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1301
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1302 if not self:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1303 exp = self._exp - other._exp
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1304 coeff = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1305 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1306 # OK, so neither = 0, INF or NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1307 shift = len(other._int) - len(self._int) + context.prec + 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1308 exp = self._exp - other._exp - shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1309 op1 = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1310 op2 = _WorkRep(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1311 if shift >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1312 coeff, remainder = divmod(op1.int * 10**shift, op2.int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1313 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1314 coeff, remainder = divmod(op1.int, op2.int * 10**-shift)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1315 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1316 # result is not exact; adjust to ensure correct rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1317 if coeff % 5 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1318 coeff += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1319 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1320 # result is exact; get as close to ideal exponent as possible
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1321 ideal_exp = self._exp - other._exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1322 while exp < ideal_exp and coeff % 10 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1323 coeff //= 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1324 exp += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1325
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1326 ans = _dec_from_triple(sign, str(coeff), exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1327 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1328
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1329 def _divide(self, other, context):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1330 """Return (self // other, self % other), to context.prec precision.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1331
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1332 Assumes that neither self nor other is a NaN, that self is not
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1333 infinite and that other is nonzero.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1334 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1335 sign = self._sign ^ other._sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1336 if other._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1337 ideal_exp = self._exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1338 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1339 ideal_exp = min(self._exp, other._exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1340
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1341 expdiff = self.adjusted() - other.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1342 if not self or other._isinfinity() or expdiff <= -2:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1343 return (_dec_from_triple(sign, '0', 0),
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1344 self._rescale(ideal_exp, context.rounding))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1345 if expdiff <= context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1346 op1 = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1347 op2 = _WorkRep(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1348 if op1.exp >= op2.exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1349 op1.int *= 10**(op1.exp - op2.exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1350 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1351 op2.int *= 10**(op2.exp - op1.exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1352 q, r = divmod(op1.int, op2.int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1353 if q < 10**context.prec:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1354 return (_dec_from_triple(sign, str(q), 0),
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1355 _dec_from_triple(self._sign, str(r), ideal_exp))
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1356
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1357 # Here the quotient is too large to be representable
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1358 ans = context._raise_error(DivisionImpossible,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1359 'quotient too large in //, % or divmod')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1360 return ans, ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1361
37191
4bfe8afe8f65 Get rid of remnants of integer division
Neal Norwitz <nnorwitz@gmail.com>
parents: 36926
diff changeset
1362 def __rtruediv__(self, other, context=None):
4bfe8afe8f65 Get rid of remnants of integer division
Neal Norwitz <nnorwitz@gmail.com>
parents: 36926
diff changeset
1363 """Swaps self/other and returns __truediv__."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1364 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1365 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1366 return other
37191
4bfe8afe8f65 Get rid of remnants of integer division
Neal Norwitz <nnorwitz@gmail.com>
parents: 36926
diff changeset
1367 return other.__truediv__(self, context=context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1368
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1369 def __divmod__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1370 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1371 Return (self // other, self % other)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1372 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1373 other = _convert_other(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1374 if other is NotImplemented:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1375 return other
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1376
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1377 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1378 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1379
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1380 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1381 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1382 return (ans, ans)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1383
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1384 sign = self._sign ^ other._sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1385 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1386 if other._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1387 ans = context._raise_error(InvalidOperation, 'divmod(INF, INF)')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1388 return ans, ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1389 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1390 return (_SignedInfinity[sign],
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1391 context._raise_error(InvalidOperation, 'INF % x'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1392
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1393 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1394 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1395 ans = context._raise_error(DivisionUndefined, 'divmod(0, 0)')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1396 return ans, ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1397 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1398 return (context._raise_error(DivisionByZero, 'x // 0', sign),
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1399 context._raise_error(InvalidOperation, 'x % 0'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1401 quotient, remainder = self._divide(other, context)
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1402 remainder = remainder._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1403 return quotient, remainder
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1404
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1405 def __rdivmod__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1406 """Swaps self/other and returns __divmod__."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1407 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1408 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1409 return other
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1410 return other.__divmod__(self, context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1411
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1412 def __mod__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1413 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1414 self % other
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1415 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1416 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1417 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1418 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1419
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1420 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1421 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1422
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1423 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1424 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1425 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1426
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1427 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1428 return context._raise_error(InvalidOperation, 'INF % x')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1429 elif not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1430 if self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1431 return context._raise_error(InvalidOperation, 'x % 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1432 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1433 return context._raise_error(DivisionUndefined, '0 % 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1434
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1435 remainder = self._divide(other, context)[1]
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
1436 remainder = remainder._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1437 return remainder
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1438
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1439 def __rmod__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1440 """Swaps self/other and returns __mod__."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1441 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1442 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1443 return other
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1444 return other.__mod__(self, context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1445
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1446 def remainder_near(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1447 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1448 Remainder nearest to 0- abs(remainder-near) <= other/2
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1449 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1450 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1451 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1452
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1453 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1454
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1455 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1456 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1457 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1458
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1459 # self == +/-infinity -> InvalidOperation
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1460 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1461 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1462 'remainder_near(infinity, x)')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1463
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1464 # other == 0 -> either InvalidOperation or DivisionUndefined
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1465 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1466 if self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1467 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1468 'remainder_near(x, 0)')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1469 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1470 return context._raise_error(DivisionUndefined,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1471 'remainder_near(0, 0)')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1472
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1473 # other = +/-infinity -> remainder = self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1474 if other._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1475 ans = Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1476 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1477
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1478 # self = 0 -> remainder = self, with ideal exponent
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1479 ideal_exponent = min(self._exp, other._exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1480 if not self:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1481 ans = _dec_from_triple(self._sign, '0', ideal_exponent)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1482 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1483
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1484 # catch most cases of large or small quotient
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1485 expdiff = self.adjusted() - other.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1486 if expdiff >= context.prec + 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1487 # expdiff >= prec+1 => abs(self/other) > 10**prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1488 return context._raise_error(DivisionImpossible)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1489 if expdiff <= -2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1490 # expdiff <= -2 => abs(self/other) < 0.1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1491 ans = self._rescale(ideal_exponent, context.rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1492 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1493
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1494 # adjust both arguments to have the same exponent, then divide
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1495 op1 = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1496 op2 = _WorkRep(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1497 if op1.exp >= op2.exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1498 op1.int *= 10**(op1.exp - op2.exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1499 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1500 op2.int *= 10**(op2.exp - op1.exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1501 q, r = divmod(op1.int, op2.int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1502 # remainder is r*10**ideal_exponent; other is +/-op2.int *
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1503 # 10**ideal_exponent. Apply correction to ensure that
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1504 # abs(remainder) <= abs(other)/2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1505 if 2*r + (q&1) > op2.int:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1506 r -= op2.int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1507 q += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1508
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1509 if q >= 10**context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1510 return context._raise_error(DivisionImpossible)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1511
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1512 # result has same sign as self unless r is negative
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1513 sign = self._sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1514 if r < 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1515 sign = 1-sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1516 r = -r
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1517
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1518 ans = _dec_from_triple(sign, str(r), ideal_exponent)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1519 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1520
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1521 def __floordiv__(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1522 """self // other"""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1523 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1524 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1525 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1526
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1527 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1528 context = getcontext()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1529
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1530 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1531 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1532 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1533
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1534 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1535 if other._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1536 return context._raise_error(InvalidOperation, 'INF // INF')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1537 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1538 return _SignedInfinity[self._sign ^ other._sign]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1539
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1540 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1541 if self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1542 return context._raise_error(DivisionByZero, 'x // 0',
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1543 self._sign ^ other._sign)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1544 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1545 return context._raise_error(DivisionUndefined, '0 // 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1546
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1547 return self._divide(other, context)[0]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1548
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1549 def __rfloordiv__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1550 """Swaps self/other and returns __floordiv__."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1551 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1552 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
1553 return other
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1554 return other.__floordiv__(self, context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1555
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1556 def __float__(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1557 """Float representation."""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1558 return float(str(self))
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1559
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1560 def __int__(self):
34638
4a0c202ee789 Fix small grammatical error in a docstring.
Brett Cannon <bcannon@gmail.com>
parents: 34545
diff changeset
1561 """Converts self to an int, truncating if necessary."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1562 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1563 if self._isnan():
55888
dd6a9bc39946 Merged revisions 74709 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55876
diff changeset
1564 raise ValueError("Cannot convert NaN to integer")
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1565 elif self._isinfinity():
55888
dd6a9bc39946 Merged revisions 74709 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55876
diff changeset
1566 raise OverflowError("Cannot convert infinity to integer")
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1567 s = (-1)**self._sign
34023
a8ff6ed856e8 SF bug #1071588 coercing decimal to int doesn't work between -1 and 1
Raymond Hettinger <python@rcn.com>
parents: 33851
diff changeset
1568 if self._exp >= 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1569 return s*int(self._int)*10**self._exp
34023
a8ff6ed856e8 SF bug #1071588 coercing decimal to int doesn't work between -1 and 1
Raymond Hettinger <python@rcn.com>
parents: 33851
diff changeset
1570 else:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1571 return s*int(self._int[:self._exp] or '0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1572
44943
6547be11f443 Merged revisions 60245-60277 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44742
diff changeset
1573 __trunc__ = __int__
6547be11f443 Merged revisions 60245-60277 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44742
diff changeset
1574
45307
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1575 def real(self):
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1576 return self
50602
5436e534da6e Merged revisions 68317-68318 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50597
diff changeset
1577 real = property(real)
5436e534da6e Merged revisions 68317-68318 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50597
diff changeset
1578
45307
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1579 def imag(self):
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1580 return Decimal(0)
50602
5436e534da6e Merged revisions 68317-68318 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50597
diff changeset
1581 imag = property(imag)
45307
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1582
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1583 def conjugate(self):
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1584 return self
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1585
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1586 def __complex__(self):
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1587 return complex(float(self))
f1205121e848 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60735-60751 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45278
diff changeset
1588
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1589 def _fix_nan(self, context):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1590 """Decapitate the payload of a NaN to fit the context"""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1591 payload = self._int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1592
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1593 # maximum length of payload is precision if clamp=0,
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1594 # precision-1 if clamp=1.
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1595 max_payload_len = context.prec - context.clamp
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1596 if len(payload) > max_payload_len:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1597 payload = payload[len(payload)-max_payload_len:].lstrip('0')
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1598 return _dec_from_triple(self._sign, payload, self._exp, True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1599 return Decimal(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1600
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
1601 def _fix(self, context):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1602 """Round if it is necessary to keep self within prec precision.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1603
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1604 Rounds and fixes the exponent. Does not raise on a sNaN.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1605
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1606 Arguments:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1607 self - Decimal instance
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1608 context - context used.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1609 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1610
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1611 if self._is_special:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1612 if self._isnan():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1613 # decapitate payload if necessary
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1614 return self._fix_nan(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1615 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1616 # self is +/-Infinity; return unaltered
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1617 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1618
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1619 # if self is zero then exponent should be between Etiny and
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1620 # Emax if clamp==0, and between Etiny and Etop if clamp==1.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1621 Etiny = context.Etiny()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1622 Etop = context.Etop()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1623 if not self:
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1624 exp_max = [context.Emax, Etop][context.clamp]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1625 new_exp = min(max(self._exp, Etiny), exp_max)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1626 if new_exp != self._exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1627 context._raise_error(Clamped)
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1628 return _dec_from_triple(self._sign, '0', new_exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1629 else:
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1630 return Decimal(self)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
1631
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1632 # exp_min is the smallest allowable exponent of the result,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1633 # equal to max(self.adjusted()-context.prec+1, Etiny)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1634 exp_min = len(self._int) + self._exp - context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1635 if exp_min > Etop:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1636 # overflow: exp_min > Etop iff self.adjusted() > Emax
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1637 ans = context._raise_error(Overflow, 'above Emax', self._sign)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1638 context._raise_error(Inexact)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1639 context._raise_error(Rounded)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1640 return ans
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1641
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1642 self_is_subnormal = exp_min < Etiny
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1643 if self_is_subnormal:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1644 exp_min = Etiny
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1645
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1646 # round if self has too many digits
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1647 if self._exp < exp_min:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1648 digits = len(self._int) + self._exp - exp_min
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1649 if digits < 0:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1650 self = _dec_from_triple(self._sign, '1', exp_min-1)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1651 digits = 0
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1652 rounding_method = self._pick_rounding_function[context.rounding]
69314
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1653 changed = rounding_method(self, digits)
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1654 coeff = self._int[:digits] or '0'
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1655 if changed > 0:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1656 coeff = str(int(coeff)+1)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1657 if len(coeff) > context.prec:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1658 coeff = coeff[:-1]
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1659 exp_min += 1
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1660
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1661 # check whether the rounding pushed the exponent out of range
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1662 if exp_min > Etop:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1663 ans = context._raise_error(Overflow, 'above Emax', self._sign)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1664 else:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1665 ans = _dec_from_triple(self._sign, coeff, exp_min)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1666
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1667 # raise the appropriate signals, taking care to respect
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1668 # the precedence described in the specification
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1669 if changed and self_is_subnormal:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1670 context._raise_error(Underflow)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1671 if self_is_subnormal:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1672 context._raise_error(Subnormal)
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1673 if changed:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1674 context._raise_error(Inexact)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1675 context._raise_error(Rounded)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1676 if not ans:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1677 # raise Clamped on underflow to 0
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1678 context._raise_error(Clamped)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1679 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1680
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1681 if self_is_subnormal:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1682 context._raise_error(Subnormal)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
1683
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1684 # fold down if clamp == 1 and self has too few digits
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
1685 if context.clamp == 1 and self._exp > Etop:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1686 context._raise_error(Clamped)
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1687 self_padded = self._int + '0'*(self._exp - Etop)
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1688 return _dec_from_triple(self._sign, self_padded, Etop)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1689
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1690 # here self was representable to begin with; return unchanged
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1691 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1692
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1693 # for each of the rounding functions below:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1694 # self is a finite, nonzero Decimal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1695 # prec is an integer satisfying 0 <= prec < len(self._int)
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1696 #
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1697 # each function returns either -1, 0, or 1, as follows:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1698 # 1 indicates that self should be rounded up (away from zero)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1699 # 0 indicates that self should be truncated, and that all the
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1700 # digits to be truncated are zeros (so the value is unchanged)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1701 # -1 indicates that there are nonzero digits to be truncated
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1702
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1703 def _round_down(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1704 """Also known as round-towards-0, truncate."""
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1705 if _all_zeros(self._int, prec):
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1706 return 0
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1707 else:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1708 return -1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1709
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1710 def _round_up(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1711 """Rounds away from 0."""
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1712 return -self._round_down(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1713
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1714 def _round_half_up(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1715 """Rounds 5 up (away from 0)"""
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1716 if self._int[prec] in '56789':
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1717 return 1
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1718 elif _all_zeros(self._int, prec):
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1719 return 0
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1720 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1721 return -1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1722
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1723 def _round_half_down(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1724 """Round 5 down"""
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1725 if _exact_half(self._int, prec):
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1726 return -1
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1727 else:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1728 return self._round_half_up(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1729
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1730 def _round_half_even(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1731 """Round 5 to even, rest to nearest."""
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1732 if _exact_half(self._int, prec) and \
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1733 (prec == 0 or self._int[prec-1] in '02468'):
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1734 return -1
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1735 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1736 return self._round_half_up(prec)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1737
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1738 def _round_ceiling(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1739 """Rounds up (not away from 0 if negative.)"""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1740 if self._sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1741 return self._round_down(prec)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1742 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1743 return -self._round_down(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1744
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1745 def _round_floor(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1746 """Rounds down (not towards 0 if negative)"""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1747 if not self._sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1748 return self._round_down(prec)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1749 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1750 return -self._round_down(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1751
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1752 def _round_05up(self, prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1753 """Round down unless digit prec-1 is 0 or 5."""
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1754 if prec and self._int[prec-1] not in '05':
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1755 return self._round_down(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1756 else:
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
1757 return -self._round_down(prec)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1758
69314
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1759 _pick_rounding_function = dict(
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1760 ROUND_DOWN = _round_down,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1761 ROUND_UP = _round_up,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1762 ROUND_HALF_UP = _round_half_up,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1763 ROUND_HALF_DOWN = _round_half_down,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1764 ROUND_HALF_EVEN = _round_half_even,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1765 ROUND_CEILING = _round_ceiling,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1766 ROUND_FLOOR = _round_floor,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1767 ROUND_05UP = _round_05up,
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1768 )
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
1769
46789
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1770 def __round__(self, n=None):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1771 """Round self to the nearest integer, or to a given precision.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1772
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1773 If only one argument is supplied, round a finite Decimal
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1774 instance self to the nearest integer. If self is infinite or
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1775 a NaN then a Python exception is raised. If self is finite
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1776 and lies exactly halfway between two integers then it is
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1777 rounded to the integer with even last digit.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1778
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1779 >>> round(Decimal('123.456'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1780 123
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1781 >>> round(Decimal('-456.789'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1782 -457
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1783 >>> round(Decimal('-3.0'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1784 -3
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1785 >>> round(Decimal('2.5'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1786 2
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1787 >>> round(Decimal('3.5'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1788 4
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1789 >>> round(Decimal('Inf'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1790 Traceback (most recent call last):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1791 ...
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1792 OverflowError: cannot round an infinity
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1793 >>> round(Decimal('NaN'))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1794 Traceback (most recent call last):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1795 ...
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1796 ValueError: cannot round a NaN
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1797
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1798 If a second argument n is supplied, self is rounded to n
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1799 decimal places using the rounding mode for the current
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1800 context.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1801
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1802 For an integer n, round(self, -n) is exactly equivalent to
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1803 self.quantize(Decimal('1En')).
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1804
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1805 >>> round(Decimal('123.456'), 0)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1806 Decimal('123')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1807 >>> round(Decimal('123.456'), 2)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1808 Decimal('123.46')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1809 >>> round(Decimal('123.456'), -2)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1810 Decimal('1E+2')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1811 >>> round(Decimal('-Infinity'), 37)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1812 Decimal('NaN')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1813 >>> round(Decimal('sNaN123'), 0)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1814 Decimal('NaN123')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1815
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1816 """
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1817 if n is not None:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1818 # two-argument form: use the equivalent quantize call
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1819 if not isinstance(n, int):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1820 raise TypeError('Second argument to round should be integral')
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1821 exp = _dec_from_triple(0, '1', -n)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1822 return self.quantize(exp)
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1823
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1824 # one-argument form
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1825 if self._is_special:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1826 if self.is_nan():
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1827 raise ValueError("cannot round a NaN")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1828 else:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1829 raise OverflowError("cannot round an infinity")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1830 return int(self._rescale(0, ROUND_HALF_EVEN))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1831
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1832 def __floor__(self):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1833 """Return the floor of self, as an integer.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1834
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1835 For a finite Decimal instance self, return the greatest
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1836 integer n such that n <= self. If self is infinite or a NaN
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1837 then a Python exception is raised.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1838
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1839 """
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1840 if self._is_special:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1841 if self.is_nan():
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1842 raise ValueError("cannot round a NaN")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1843 else:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1844 raise OverflowError("cannot round an infinity")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1845 return int(self._rescale(0, ROUND_FLOOR))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1846
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1847 def __ceil__(self):
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1848 """Return the ceiling of self, as an integer.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1849
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1850 For a finite Decimal instance self, return the least integer n
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1851 such that n >= self. If self is infinite or a NaN then a
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1852 Python exception is raised.
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1853
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1854 """
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1855 if self._is_special:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1856 if self.is_nan():
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1857 raise ValueError("cannot round a NaN")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1858 else:
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1859 raise OverflowError("cannot round an infinity")
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1860 return int(self._rescale(0, ROUND_CEILING))
3955c502cfa3 Issue 2748: fix __ceil__, __floor__ and __round__ magic methods in
Mark Dickinson <dickinsm@gmail.com>
parents: 46664
diff changeset
1861
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1862 def fma(self, other, third, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1863 """Fused multiply-add.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1864
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1865 Returns self*other+third with no rounding of the intermediate
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1866 product self*other.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1867
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1868 self and other are multiplied together, with no rounding of
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1869 the result. The third operand is then added to the result,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1870 and a single final rounding is performed.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1871 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1872
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1873 other = _convert_other(other, raiseit=True)
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1874
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1875 # compute product; raise InvalidOperation if either operand is
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1876 # a signaling NaN or if the product is zero times infinity.
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1877 if self._is_special or other._is_special:
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1878 if context is None:
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1879 context = getcontext()
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1880 if self._exp == 'N':
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1881 return context._raise_error(InvalidOperation, 'sNaN', self)
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1882 if other._exp == 'N':
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1883 return context._raise_error(InvalidOperation, 'sNaN', other)
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1884 if self._exp == 'n':
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1885 product = self
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1886 elif other._exp == 'n':
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1887 product = other
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1888 elif self._exp == 'F':
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1889 if not other:
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1890 return context._raise_error(InvalidOperation,
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1891 'INF * 0 in fma')
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1892 product = _SignedInfinity[self._sign ^ other._sign]
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1893 elif other._exp == 'F':
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1894 if not self:
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1895 return context._raise_error(InvalidOperation,
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1896 '0 * INF in fma')
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
1897 product = _SignedInfinity[self._sign ^ other._sign]
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1898 else:
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1899 product = _dec_from_triple(self._sign ^ other._sign,
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1900 str(int(self._int) * int(other._int)),
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1901 self._exp + other._exp)
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1902
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1903 third = _convert_other(third, raiseit=True)
44155
1a2a6df0fbe0 Merged revisions 59323-59332 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44129
diff changeset
1904 return product.__add__(third, context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1905
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1906 def _power_modulo(self, other, modulo, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1907 """Three argument version of __pow__"""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1908
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1909 # if can't convert other and modulo to Decimal, raise
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1910 # TypeError; there's no point returning NotImplemented (no
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1911 # equivalent of __rpow__ for three argument pow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1912 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1913 modulo = _convert_other(modulo, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1914
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1915 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1916 context = getcontext()
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1917
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1918 # deal with NaNs: if there are any sNaNs then first one wins,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1919 # (i.e. behaviour for NaNs is identical to that of fma)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1920 self_is_nan = self._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1921 other_is_nan = other._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1922 modulo_is_nan = modulo._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1923 if self_is_nan or other_is_nan or modulo_is_nan:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1924 if self_is_nan == 2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1925 return context._raise_error(InvalidOperation, 'sNaN',
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1926 self)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1927 if other_is_nan == 2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1928 return context._raise_error(InvalidOperation, 'sNaN',
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1929 other)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1930 if modulo_is_nan == 2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1931 return context._raise_error(InvalidOperation, 'sNaN',
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
1932 modulo)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1933 if self_is_nan:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1934 return self._fix_nan(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1935 if other_is_nan:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1936 return other._fix_nan(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1937 return modulo._fix_nan(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1938
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1939 # check inputs: we apply same restrictions as Python's pow()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1940 if not (self._isinteger() and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1941 other._isinteger() and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1942 modulo._isinteger()):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1943 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1944 'pow() 3rd argument not allowed '
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1945 'unless all arguments are integers')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1946 if other < 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1947 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1948 'pow() 2nd argument cannot be '
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1949 'negative when 3rd argument specified')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1950 if not modulo:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1951 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1952 'pow() 3rd argument cannot be 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1953
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1954 # additional restriction for decimal: the modulus must be less
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1955 # than 10**prec in absolute value
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1956 if modulo.adjusted() >= context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1957 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1958 'insufficient precision: pow() 3rd '
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1959 'argument must not have more than '
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1960 'precision digits')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1961
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1962 # define 0**0 == NaN, for consistency with two-argument pow
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1963 # (even though it hurts!)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1964 if not other and not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1965 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1966 'at least one of pow() 1st argument '
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1967 'and 2nd argument must be nonzero ;'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1968 '0**0 is not defined')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1969
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1970 # compute sign of result
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1971 if other._iseven():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1972 sign = 0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
1973 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1974 sign = self._sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1975
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1976 # convert modulo to a Python integer, and self and other to
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1977 # Decimal integers (i.e. force their exponents to be >= 0)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1978 modulo = abs(int(modulo))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1979 base = _WorkRep(self.to_integral_value())
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1980 exponent = _WorkRep(other.to_integral_value())
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1981
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1982 # compute result using integer pow()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1983 base = (base.int % modulo * pow(10, base.exp, modulo)) % modulo
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1984 for i in range(exponent.exp):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1985 base = pow(base, 10, modulo)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1986 base = pow(base, exponent.int, modulo)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1987
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
1988 return _dec_from_triple(sign, str(base), 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1989
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1990 def _power_exact(self, other, p):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1991 """Attempt to compute self**other exactly.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1992
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1993 Given Decimals self and other and an integer p, attempt to
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1994 compute an exact result for the power self**other, with p
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1995 digits of precision. Return None if self**other is not
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1996 exactly representable in p digits.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1997
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1998 Assumes that elimination of special cases has already been
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
1999 performed: self and other must both be nonspecial; self must
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2000 be positive and not numerically equal to 1; other must be
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2001 nonzero. For efficiency, other._exp should not be too large,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2002 so that 10**abs(other._exp) is a feasible calculation."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2003
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2004 # In the comments below, we write x for the value of self and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2005 # y for the value of other. Write x = xc*10**xe and y =
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2006 # yc*10**ye.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2007
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2008 # The main purpose of this method is to identify the *failure*
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2009 # of x**y to be exactly representable with as little effort as
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2010 # possible. So we look for cheap and easy tests that
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2011 # eliminate the possibility of x**y being exact. Only if all
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2012 # these tests are passed do we go on to actually compute x**y.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2013
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2014 # Here's the main idea. First normalize both x and y. We
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2015 # express y as a rational m/n, with m and n relatively prime
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2016 # and n>0. Then for x**y to be exactly representable (at
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2017 # *any* precision), xc must be the nth power of a positive
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2018 # integer and xe must be divisible by n. If m is negative
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2019 # then additionally xc must be a power of either 2 or 5, hence
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2020 # a power of 2**n or 5**n.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2021 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2022 # There's a limit to how small |y| can be: if y=m/n as above
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2023 # then:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2024 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2025 # (1) if xc != 1 then for the result to be representable we
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2026 # need xc**(1/n) >= 2, and hence also xc**|y| >= 2. So
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2027 # if |y| <= 1/nbits(xc) then xc < 2**nbits(xc) <=
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2028 # 2**(1/|y|), hence xc**|y| < 2 and the result is not
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2029 # representable.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2030 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2031 # (2) if xe != 0, |xe|*(1/n) >= 1, so |xe|*|y| >= 1. Hence if
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2032 # |y| < 1/|xe| then the result is not representable.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2033 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2034 # Note that since x is not equal to 1, at least one of (1) and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2035 # (2) must apply. Now |y| < 1/nbits(xc) iff |yc|*nbits(xc) <
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2036 # 10**-ye iff len(str(|yc|*nbits(xc)) <= -ye.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2037 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2038 # There's also a limit to how large y can be, at least if it's
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2039 # positive: the normalized result will have coefficient xc**y,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2040 # so if it's representable then xc**y < 10**p, and y <
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2041 # p/log10(xc). Hence if y*log10(xc) >= p then the result is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2042 # not exactly representable.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2043
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2044 # if len(str(abs(yc*xe)) <= -ye then abs(yc*xe) < 10**-ye,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2045 # so |y| < 1/xe and the result is not representable.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2046 # Similarly, len(str(abs(yc)*xc_bits)) <= -ye implies |y|
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2047 # < 1/nbits(xc).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2048
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2049 x = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2050 xc, xe = x.int, x.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2051 while xc % 10 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2052 xc //= 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2053 xe += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2054
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2055 y = _WorkRep(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2056 yc, ye = y.int, y.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2057 while yc % 10 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2058 yc //= 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2059 ye += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2060
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2061 # case where xc == 1: result is 10**(xe*y), with xe*y
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2062 # required to be an integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2063 if xc == 1:
62866
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2064 xe *= yc
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2065 # result is now 10**(xe * 10**ye); xe * 10**ye must be integral
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2066 while xe % 10 == 0:
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2067 xe //= 10
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2068 ye += 1
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2069 if ye < 0:
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2070 return None
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2071 exponent = xe * 10**ye
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2072 if y.sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2073 exponent = -exponent
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2074 # if other is a nonnegative integer, use ideal exponent
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2075 if other._isinteger() and other._sign == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2076 ideal_exponent = self._exp*int(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2077 zeros = min(exponent-ideal_exponent, p-1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2078 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2079 zeros = 0
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2080 return _dec_from_triple(0, '1' + '0'*zeros, exponent-zeros)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2081
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2082 # case where y is negative: xc must be either a power
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2083 # of 2 or a power of 5.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2084 if y.sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2085 last_digit = xc % 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2086 if last_digit in (2,4,6,8):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2087 # quick test for power of 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2088 if xc & -xc != xc:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2089 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2090 # now xc is a power of 2; e is its exponent
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2091 e = _nbits(xc)-1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2092 # find e*y and xe*y; both must be integers
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2093 if ye >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2094 y_as_int = yc*10**ye
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2095 e = e*y_as_int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2096 xe = xe*y_as_int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2097 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2098 ten_pow = 10**-ye
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2099 e, remainder = divmod(e*yc, ten_pow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2100 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2101 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2102 xe, remainder = divmod(xe*yc, ten_pow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2103 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2104 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2105
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2106 if e*65 >= p*93: # 93/65 > log(10)/log(5)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2107 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2108 xc = 5**e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2109
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2110 elif last_digit == 5:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2111 # e >= log_5(xc) if xc is a power of 5; we have
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2112 # equality all the way up to xc=5**2658
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2113 e = _nbits(xc)*28//65
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2114 xc, remainder = divmod(5**e, xc)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2115 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2116 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2117 while xc % 5 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2118 xc //= 5
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2119 e -= 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2120 if ye >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2121 y_as_integer = yc*10**ye
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2122 e = e*y_as_integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2123 xe = xe*y_as_integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2124 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2125 ten_pow = 10**-ye
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2126 e, remainder = divmod(e*yc, ten_pow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2127 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2128 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2129 xe, remainder = divmod(xe*yc, ten_pow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2130 if remainder:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2131 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2132 if e*3 >= p*10: # 10/3 > log(10)/log(2)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2133 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2134 xc = 2**e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2135 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2136 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2137
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2138 if xc >= 10**p:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2139 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2140 xe = -e-xe
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2141 return _dec_from_triple(0, str(xc), xe)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2142
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2143 # now y is positive; find m and n such that y = m/n
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2144 if ye >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2145 m, n = yc*10**ye, 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2146 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2147 if xe != 0 and len(str(abs(yc*xe))) <= -ye:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2148 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2149 xc_bits = _nbits(xc)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2150 if xc != 1 and len(str(abs(yc)*xc_bits)) <= -ye:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2151 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2152 m, n = yc, 10**(-ye)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2153 while m % 2 == n % 2 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2154 m //= 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2155 n //= 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2156 while m % 5 == n % 5 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2157 m //= 5
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2158 n //= 5
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2159
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2160 # compute nth root of xc*10**xe
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2161 if n > 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2162 # if 1 < xc < 2**n then xc isn't an nth power
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2163 if xc != 1 and xc_bits <= n:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2164 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2165
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2166 xe, rem = divmod(xe, n)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2167 if rem != 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2168 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2169
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2170 # compute nth root of xc using Newton's method
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2171 a = 1 << -(-_nbits(xc)//n) # initial estimate
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2172 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2173 q, r = divmod(xc, a**(n-1))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2174 if a <= q:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2175 break
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2176 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2177 a = (a*(n-1) + q)//n
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2178 if not (a == q and r == 0):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2179 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2180 xc = a
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2181
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2182 # now xc*10**xe is the nth root of the original xc*10**xe
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2183 # compute mth power of xc*10**xe
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2184
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2185 # if m > p*100//_log10_lb(xc) then m > p/log10(xc), hence xc**m >
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2186 # 10**p and the result is not representable.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2187 if xc > 1 and m > p*100//_log10_lb(xc):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2188 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2189 xc = xc**m
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2190 xe *= m
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2191 if xc > 10**p:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2192 return None
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2193
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2194 # by this point the result *is* exactly representable
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2195 # adjust the exponent to get as close as possible to the ideal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2196 # exponent, if necessary
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2197 str_xc = str(xc)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2198 if other._isinteger() and other._sign == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2199 ideal_exponent = self._exp*int(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2200 zeros = min(xe-ideal_exponent, p-len(str_xc))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2201 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2202 zeros = 0
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2203 return _dec_from_triple(0, str_xc+'0'*zeros, xe-zeros)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2204
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2205 def __pow__(self, other, modulo=None, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2206 """Return self ** other [ % modulo].
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2207
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2208 With two arguments, compute self**other.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2209
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2210 With three arguments, compute (self**other) % modulo. For the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2211 three argument form, the following restrictions on the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2212 arguments hold:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2213
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2214 - all three arguments must be integral
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2215 - other must be nonnegative
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2216 - either self or other (or both) must be nonzero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2217 - modulo must be nonzero and must have at most p digits,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2218 where p is the context precision.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2219
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2220 If any of these restrictions is violated the InvalidOperation
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2221 flag is raised.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2222
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2223 The result of pow(self, other, modulo) is identical to the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2224 result that would be obtained by computing (self**other) %
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2225 modulo with unbounded precision, but is computed more
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2226 efficiently. It is always exact.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2227 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2228
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2229 if modulo is not None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2230 return self._power_modulo(other, modulo, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2231
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2232 other = _convert_other(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2233 if other is NotImplemented:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2234 return other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2235
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2236 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2237 context = getcontext()
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2238
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2239 # either argument is a NaN => result is NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2240 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2241 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2242 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2243
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2244 # 0**0 = NaN (!), x**0 = 1 for nonzero x (including +/-Infinity)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2245 if not other:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2246 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2247 return context._raise_error(InvalidOperation, '0 ** 0')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2248 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2249 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2250
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2251 # result has sign 1 iff self._sign is 1 and other is an odd integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2252 result_sign = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2253 if self._sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2254 if other._isinteger():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2255 if not other._iseven():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2256 result_sign = 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2257 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2258 # -ve**noninteger = NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2259 # (-0)**noninteger = 0**noninteger
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2260 if self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2261 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2262 'x ** y with x negative and y not an integer')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2263 # negate self, without doing any unwanted rounding
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2264 self = self.copy_negate()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2265
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2266 # 0**(+ve or Inf)= 0; 0**(-ve or -Inf) = Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2267 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2268 if other._sign == 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2269 return _dec_from_triple(result_sign, '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2270 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2271 return _SignedInfinity[result_sign]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2272
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2273 # Inf**(+ve or Inf) = Inf; Inf**(-ve or -Inf) = 0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2274 if self._isinfinity():
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2275 if other._sign == 0:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2276 return _SignedInfinity[result_sign]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2277 else:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2278 return _dec_from_triple(result_sign, '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2279
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2280 # 1**other = 1, but the choice of exponent and the flags
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2281 # depend on the exponent of self, and on whether other is a
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2282 # positive integer, a negative integer, or neither
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2283 if self == _One:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2284 if other._isinteger():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2285 # exp = max(self._exp*max(int(other), 0),
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2286 # 1-context.prec) but evaluating int(other) directly
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2287 # is dangerous until we know other is small (other
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2288 # could be 1e999999999)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2289 if other._sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2290 multiplier = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2291 elif other > context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2292 multiplier = context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2293 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2294 multiplier = int(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2295
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2296 exp = self._exp * multiplier
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2297 if exp < 1-context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2298 exp = 1-context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2299 context._raise_error(Rounded)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2300 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2301 context._raise_error(Inexact)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2302 context._raise_error(Rounded)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2303 exp = 1-context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2304
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2305 return _dec_from_triple(result_sign, '1'+'0'*-exp, exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2306
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2307 # compute adjusted exponent of self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2308 self_adj = self.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2309
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2310 # self ** infinity is infinity if self > 1, 0 if self < 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2311 # self ** -infinity is infinity if self < 1, 0 if self > 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2312 if other._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2313 if (other._sign == 0) == (self_adj < 0):
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2314 return _dec_from_triple(result_sign, '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2315 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2316 return _SignedInfinity[result_sign]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2317
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2318 # from here on, the result always goes through the call
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2319 # to _fix at the end of this function.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2320 ans = None
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2321 exact = False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2322
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2323 # crude test to catch cases of extreme overflow/underflow. If
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2324 # log10(self)*other >= 10**bound and bound >= len(str(Emax))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2325 # then 10**bound >= 10**len(str(Emax)) >= Emax+1 and hence
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2326 # self**other >= 10**(Emax+1), so overflow occurs. The test
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2327 # for underflow is similar.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2328 bound = self._log10_exp_bound() + other.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2329 if (self_adj >= 0) == (other._sign == 0):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2330 # self > 1 and other +ve, or self < 1 and other -ve
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2331 # possibility of overflow
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2332 if bound >= len(str(context.Emax)):
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2333 ans = _dec_from_triple(result_sign, '1', context.Emax+1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2334 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2335 # self > 1 and other -ve, or self < 1 and other +ve
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2336 # possibility of underflow to 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2337 Etiny = context.Etiny()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2338 if bound >= len(str(-Etiny)):
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2339 ans = _dec_from_triple(result_sign, '1', Etiny-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2340
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2341 # try for an exact result with precision +1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2342 if ans is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2343 ans = self._power_exact(other, context.prec + 1)
62866
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2344 if ans is not None:
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2345 if result_sign == 1:
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2346 ans = _dec_from_triple(1, ans._int, ans._exp)
b044625322e3 Merged revisions 82646,82649-82650 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 61746
diff changeset
2347 exact = True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2348
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2349 # usual case: inexact result, x**y computed directly as exp(y*log(x))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2350 if ans is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2351 p = context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2352 x = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2353 xc, xe = x.int, x.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2354 y = _WorkRep(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2355 yc, ye = y.int, y.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2356 if y.sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2357 yc = -yc
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2358
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2359 # compute correctly rounded result: start with precision +3,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2360 # then increase precision until result is unambiguously roundable
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2361 extra = 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2362 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2363 coeff, exp = _dpower(xc, xe, yc, ye, p+extra)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2364 if coeff % (5*10**(len(str(coeff))-p-1)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2365 break
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2366 extra += 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2367
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2368 ans = _dec_from_triple(result_sign, str(coeff), exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2369
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2370 # unlike exp, ln and log10, the power function respects the
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2371 # rounding mode; no need to switch to ROUND_HALF_EVEN here
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2372
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2373 # There's a difficulty here when 'other' is not an integer and
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2374 # the result is exact. In this case, the specification
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2375 # requires that the Inexact flag be raised (in spite of
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2376 # exactness), but since the result is exact _fix won't do this
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2377 # for us. (Correspondingly, the Underflow signal should also
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2378 # be raised for subnormal results.) We can't directly raise
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2379 # these signals either before or after calling _fix, since
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2380 # that would violate the precedence for signals. So we wrap
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2381 # the ._fix call in a temporary context, and reraise
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2382 # afterwards.
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2383 if exact and not other._isinteger():
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2384 # pad with zeros up to length context.prec+1 if necessary; this
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2385 # ensures that the Rounded signal will be raised.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2386 if len(ans._int) <= context.prec:
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2387 expdiff = context.prec + 1 - len(ans._int)
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2388 ans = _dec_from_triple(ans._sign, ans._int+'0'*expdiff,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2389 ans._exp-expdiff)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2390
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2391 # create a copy of the current context, with cleared flags/traps
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2392 newcontext = context.copy()
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2393 newcontext.clear_flags()
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2394 for exception in _signals:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2395 newcontext.traps[exception] = 0
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2396
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2397 # round in the new context
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2398 ans = ans._fix(newcontext)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2399
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2400 # raise Inexact, and if necessary, Underflow
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2401 newcontext._raise_error(Inexact)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2402 if newcontext.flags[Subnormal]:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2403 newcontext._raise_error(Underflow)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2404
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2405 # propagate signals to the original context; _fix could
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2406 # have raised any of Overflow, Underflow, Subnormal,
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2407 # Inexact, Rounded, Clamped. Overflow needs the correct
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2408 # arguments. Note that the order of the exceptions is
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2409 # important here.
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2410 if newcontext.flags[Overflow]:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2411 context._raise_error(Overflow, 'above Emax', ans._sign)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2412 for exception in Underflow, Subnormal, Inexact, Rounded, Clamped:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2413 if newcontext.flags[exception]:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2414 context._raise_error(exception)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2415
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2416 else:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2417 ans = ans._fix(context)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2418
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2419 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2420
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2421 def __rpow__(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2422 """Swaps self/other and returns __pow__."""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2423 other = _convert_other(other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
2424 if other is NotImplemented:
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
2425 return other
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2426 return other.__pow__(self, context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2427
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2428 def normalize(self, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2429 """Normalize- strip trailing 0s, change anything equal to 0 to 0e0"""
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2430
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2431 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2432 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2433
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2434 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2435 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2436 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2437 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2438
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
2439 dup = self._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2440 if dup._isinfinity():
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2441 return dup
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2442
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2443 if not dup:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2444 return _dec_from_triple(dup._sign, '0', 0)
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
2445 exp_max = [context.Emax, context.Etop()][context.clamp]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2446 end = len(dup._int)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2447 exp = dup._exp
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2448 while dup._int[end-1] == '0' and exp < exp_max:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2449 exp += 1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2450 end -= 1
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2451 return _dec_from_triple(dup._sign, dup._int[:end], exp)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2452
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2453 def quantize(self, exp, rounding=None, context=None, watchexp=True):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2454 """Quantize self so its exponent is the same as that of exp.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2455
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2456 Similar to self._rescale(exp._exp) but with error checking.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2457 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2458 exp = _convert_other(exp, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2459
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2460 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2461 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2462 if rounding is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2463 rounding = context.rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2464
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2465 if self._is_special or exp._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2466 ans = self._check_nans(exp, context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2467 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2468 return ans
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2469
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2470 if exp._isinfinity() or self._isinfinity():
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2471 if exp._isinfinity() and self._isinfinity():
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2472 return Decimal(self) # if both are inf, it is OK
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2473 return context._raise_error(InvalidOperation,
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2474 'quantize with one INF')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2475
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2476 # if we're not watching exponents, do a simple rescale
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2477 if not watchexp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2478 ans = self._rescale(exp._exp, rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2479 # raise Inexact and Rounded where appropriate
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2480 if ans._exp > self._exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2481 context._raise_error(Rounded)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2482 if ans != self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2483 context._raise_error(Inexact)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2484 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2485
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2486 # exp._exp should be between Etiny and Emax
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2487 if not (context.Etiny() <= exp._exp <= context.Emax):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2488 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2489 'target exponent out of bounds in quantize')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2490
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2491 if not self:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2492 ans = _dec_from_triple(self._sign, '0', exp._exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2493 return ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2494
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2495 self_adjusted = self.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2496 if self_adjusted > context.Emax:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2497 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2498 'exponent of quantize result too large for current context')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2499 if self_adjusted - exp._exp + 1 > context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2500 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2501 'quantize result has too many digits for current context')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2502
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2503 ans = self._rescale(exp._exp, rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2504 if ans.adjusted() > context.Emax:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2505 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2506 'exponent of quantize result too large for current context')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2507 if len(ans._int) > context.prec:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2508 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2509 'quantize result has too many digits for current context')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2510
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2511 # raise appropriate flags
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2512 if ans and ans.adjusted() < context.Emin:
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2513 context._raise_error(Subnormal)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2514 if ans._exp > self._exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2515 if ans != self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2516 context._raise_error(Inexact)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2517 context._raise_error(Rounded)
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2518
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2519 # call to fix takes care of any necessary folddown, and
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2520 # signals Clamped if necessary
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2521 ans = ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2522 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2523
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2524 def same_quantum(self, other):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2525 """Return True if self and other have the same exponent; otherwise
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2526 return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2527
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2528 If either operand is a special value, the following rules are used:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2529 * return True if both operands are infinities
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2530 * return True if both operands are NaNs
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2531 * otherwise, return False.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2532 """
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2533 other = _convert_other(other, raiseit=True)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2534 if self._is_special or other._is_special:
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2535 return (self.is_nan() and other.is_nan() or
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
2536 self.is_infinite() and other.is_infinite())
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2537 return self._exp == other._exp
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2538
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2539 def _rescale(self, exp, rounding):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2540 """Rescale self so that the exponent is exp, either by padding with zeros
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2541 or by truncating digits, using the given rounding mode.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2542
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2543 Specials are returned without change. This operation is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2544 quiet: it raises no flags, and uses no information from the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2545 context.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2546
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2547 exp = exp to scale to (an integer)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2548 rounding = rounding mode
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2549 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2550 if self._is_special:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2551 return Decimal(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2552 if not self:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2553 return _dec_from_triple(self._sign, '0', exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2554
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2555 if self._exp >= exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2556 # pad answer with zeros if necessary
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2557 return _dec_from_triple(self._sign,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2558 self._int + '0'*(self._exp - exp), exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2559
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2560 # too many digits; round and lose data. If self.adjusted() <
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2561 # exp-1, replace self by 10**(exp-1) before rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2562 digits = len(self._int) + self._exp - exp
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2563 if digits < 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2564 self = _dec_from_triple(self._sign, '1', exp-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2565 digits = 0
69314
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
2566 this_function = self._pick_rounding_function[rounding]
f5d5f3f4c081 Issue #11830: Remove unnecessary introspection code in the decimal module.
Alexander Belopolsky <alexander.belopolsky@gmail.com>
parents: 68489
diff changeset
2567 changed = this_function(self, digits)
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
2568 coeff = self._int[:digits] or '0'
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
2569 if changed == 1:
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
2570 coeff = str(int(coeff)+1)
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
2571 return _dec_from_triple(self._sign, coeff, exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2572
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2573 def _round(self, places, rounding):
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2574 """Round a nonzero, nonspecial Decimal to a fixed number of
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2575 significant figures, using the given rounding mode.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2576
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2577 Infinities, NaNs and zeros are returned unaltered.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2578
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2579 This operation is quiet: it raises no flags, and uses no
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2580 information from the context.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2581
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2582 """
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2583 if places <= 0:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2584 raise ValueError("argument should be at least 1 in _round")
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2585 if self._is_special or not self:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2586 return Decimal(self)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2587 ans = self._rescale(self.adjusted()+1-places, rounding)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2588 # it can happen that the rescale alters the adjusted exponent;
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2589 # for example when rounding 99.97 to 3 significant figures.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2590 # When this happens we end up with an extra 0 at the end of
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2591 # the number; a second rescale fixes this.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2592 if ans.adjusted() != self.adjusted():
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2593 ans = ans._rescale(ans.adjusted()+1-places, rounding)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2594 return ans
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
2595
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2596 def to_integral_exact(self, rounding=None, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2597 """Rounds to a nearby integer.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2598
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2599 If no rounding mode is specified, take the rounding mode from
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2600 the context. This method raises the Rounded and Inexact flags
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2601 when appropriate.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2602
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2603 See also: to_integral_value, which does exactly the same as
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2604 this method except that it doesn't raise Inexact or Rounded.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2605 """
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2606 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2607 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2608 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2609 return ans
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2610 return Decimal(self)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2611 if self._exp >= 0:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2612 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2613 if not self:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2614 return _dec_from_triple(self._sign, '0', 0)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2615 if context is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2616 context = getcontext()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2617 if rounding is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2618 rounding = context.rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2619 ans = self._rescale(0, rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2620 if ans != self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2621 context._raise_error(Inexact)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
2622 context._raise_error(Rounded)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2623 return ans
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2624
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2625 def to_integral_value(self, rounding=None, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2626 """Rounds to the nearest integer, without raising inexact, rounded."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2627 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2628 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2629 if rounding is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2630 rounding = context.rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2631 if self._is_special:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2632 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2633 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2634 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2635 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2636 if self._exp >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2637 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2638 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2639 return self._rescale(0, rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2640
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2641 # the method name changed, but we provide also the old one, for compatibility
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2642 to_integral = to_integral_value
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2643
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2644 def sqrt(self, context=None):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2645 """Return the square root of self."""
46111
2bcbd3882eee Merged revisions 61892,61900 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45774
diff changeset
2646 if context is None:
2bcbd3882eee Merged revisions 61892,61900 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45774
diff changeset
2647 context = getcontext()
2bcbd3882eee Merged revisions 61892,61900 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45774
diff changeset
2648
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2649 if self._is_special:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2650 ans = self._check_nans(context=context)
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2651 if ans:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2652 return ans
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2653
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2654 if self._isinfinity() and self._sign == 0:
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2655 return Decimal(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2656
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2657 if not self:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2658 # exponent = self._exp // 2. sqrt(-0) = -0
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2659 ans = _dec_from_triple(self._sign, '0', self._exp // 2)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2660 return ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2661
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2662 if self._sign == 1:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2663 return context._raise_error(InvalidOperation, 'sqrt(-x), x > 0')
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2664
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2665 # At this point self represents a positive number. Let p be
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2666 # the desired precision and express self in the form c*100**e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2667 # with c a positive real number and e an integer, c and e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2668 # being chosen so that 100**(p-1) <= c < 100**p. Then the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2669 # (exact) square root of self is sqrt(c)*10**e, and 10**(p-1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2670 # <= sqrt(c) < 10**p, so the closest representable Decimal at
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2671 # precision p is n*10**e where n = round_half_even(sqrt(c)),
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2672 # the closest integer to sqrt(c) with the even integer chosen
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2673 # in the case of a tie.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2674 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2675 # To ensure correct rounding in all cases, we use the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2676 # following trick: we compute the square root to an extra
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2677 # place (precision p+1 instead of precision p), rounding down.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2678 # Then, if the result is inexact and its last digit is 0 or 5,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2679 # we increase the last digit to 1 or 6 respectively; if it's
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2680 # exact we leave the last digit alone. Now the final round to
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2681 # p places (or fewer in the case of underflow) will round
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2682 # correctly and raise the appropriate flags.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2683
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2684 # use an extra digit of precision
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2685 prec = context.prec+1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2686
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2687 # write argument in the form c*100**e where e = self._exp//2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2688 # is the 'ideal' exponent, to be used if the square root is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2689 # exactly representable. l is the number of 'digits' of c in
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2690 # base 100, so that 100**(l-1) <= c < 100**l.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2691 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2692 e = op.exp >> 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2693 if op.exp & 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2694 c = op.int * 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2695 l = (len(self._int) >> 1) + 1
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2696 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2697 c = op.int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2698 l = len(self._int)+1 >> 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2699
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2700 # rescale so that c has exactly prec base 100 'digits'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2701 shift = prec-l
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2702 if shift >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2703 c *= 100**shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2704 exact = True
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2705 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2706 c, remainder = divmod(c, 100**-shift)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2707 exact = not remainder
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2708 e -= shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2709
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2710 # find n = floor(sqrt(c)) using Newton's method
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2711 n = 10**prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2712 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2713 q = c//n
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2714 if n <= q:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2715 break
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2716 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2717 n = n + q >> 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2718 exact = exact and n*n == c
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2719
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2720 if exact:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2721 # result is exact; rescale to use ideal exponent e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2722 if shift >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2723 # assert n % 10**shift == 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2724 n //= 10**shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2725 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2726 n *= 10**-shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2727 e += shift
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2728 else:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2729 # result is not exact; fix last digit as described above
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2730 if n % 5 == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2731 n += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2732
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2733 ans = _dec_from_triple(0, str(n), e)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2734
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2735 # round, and fit to current context
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2736 context = context._shallow_copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2737 rounding = context._set_rounding(ROUND_HALF_EVEN)
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
2738 ans = ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2739 context.rounding = rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2740
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2741 return ans
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2742
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2743 def max(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2744 """Returns the larger value.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2745
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2746 Like max(self, other) except if one is not a number, returns
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2747 NaN (and signals if one is sNaN). Also rounds.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2748 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2749 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2750
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2751 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2752 context = getcontext()
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2753
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2754 if self._is_special or other._is_special:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2755 # If one operand is a quiet NaN and the other is number, then the
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2756 # number is always returned
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2757 sn = self._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2758 on = other._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2759 if sn or on:
50115
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2760 if on == 1 and sn == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2761 return self._fix(context)
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2762 if sn == 1 and on == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2763 return other._fix(context)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2764 return self._check_nans(other, context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2765
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2766 c = self._cmp(other)
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2767 if c == 0:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2768 # If both operands are finite and equal in numerical value
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2769 # then an ordering is applied:
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2770 #
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2771 # If the signs differ then max returns the operand with the
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2772 # positive sign and min returns the operand with the negative sign
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2773 #
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2774 # If the signs are the same then the exponent is used to select
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2775 # the result. This is exactly the ordering used in compare_total.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2776 c = self.compare_total(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2777
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2778 if c == -1:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2779 ans = other
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2780 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2781 ans = self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2782
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
2783 return ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2784
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2785 def min(self, other, context=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2786 """Returns the smaller value.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2787
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2788 Like min(self, other) except if one is not a number, returns
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2789 NaN (and signals if one is sNaN). Also rounds.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2790 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2791 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2792
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2793 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2794 context = getcontext()
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2795
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2796 if self._is_special or other._is_special:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2797 # If one operand is a quiet NaN and the other is number, then the
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2798 # number is always returned
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2799 sn = self._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2800 on = other._isnan()
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2801 if sn or on:
50115
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2802 if on == 1 and sn == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2803 return self._fix(context)
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2804 if sn == 1 and on == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
2805 return other._fix(context)
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2806 return self._check_nans(other, context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2807
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2808 c = self._cmp(other)
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
2809 if c == 0:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2810 c = self.compare_total(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2811
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2812 if c == -1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2813 ans = self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2814 else:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2815 ans = other
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
2816
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
2817 return ans._fix(context)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2818
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2819 def _isinteger(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2820 """Returns whether self is an integer"""
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2821 if self._is_special:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2822 return False
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2823 if self._exp >= 0:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2824 return True
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2825 rest = self._int[self._exp:]
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2826 return rest == '0'*len(rest)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2827
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2828 def _iseven(self):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2829 """Returns True if self is even. Assumes self is an integer."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2830 if not self or self._exp > 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2831 return True
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2832 return self._int[-1+self._exp] in '02468'
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2833
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2834 def adjusted(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2835 """Return the adjusted exponent of self"""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2836 try:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2837 return self._exp + len(self._int) - 1
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
2838 # If NaN or Infinity, self._exp is string
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2839 except TypeError:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2840 return 0
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
2841
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2842 def canonical(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2843 """Returns the same Decimal object.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2844
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2845 As we do not have different encodings for the same number, the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2846 received object already is in its canonical form.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2847 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2848 return self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2849
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2850 def compare_signal(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2851 """Compares self to the other operand numerically.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2852
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2853 It's pretty much like compare(), but all NaNs signal, with signaling
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2854 NaNs taking precedence over quiet NaNs.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2855 """
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2856 other = _convert_other(other, raiseit = True)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2857 ans = self._compare_check_nans(other, context)
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2858 if ans:
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
2859 return ans
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2860 return self.compare(other, context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2861
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2862 def compare_total(self, other):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2863 """Compares self to other using the abstract representations.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2864
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2865 This is not like the standard compare, which use their numerical
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2866 value. Note that a total ordering is defined for all possible abstract
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2867 representations.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2868 """
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
2869 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
2870
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2871 # if one is negative and the other is positive, it's easy
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2872 if self._sign and not other._sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2873 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2874 if not self._sign and other._sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2875 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2876 sign = self._sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2877
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2878 # let's handle both NaN types
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2879 self_nan = self._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2880 other_nan = other._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2881 if self_nan or other_nan:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2882 if self_nan == other_nan:
55743
094a6f158641 Merged revisions 74566 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55517
diff changeset
2883 # compare payloads as though they're integers
094a6f158641 Merged revisions 74566 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55517
diff changeset
2884 self_key = len(self._int), self._int
094a6f158641 Merged revisions 74566 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55517
diff changeset
2885 other_key = len(other._int), other._int
094a6f158641 Merged revisions 74566 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55517
diff changeset
2886 if self_key < other_key:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2887 if sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2888 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2889 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2890 return _NegativeOne
55743
094a6f158641 Merged revisions 74566 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55517
diff changeset
2891 if self_key > other_key:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2892 if sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2893 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2894 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2895 return _One
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2896 return _Zero
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2897
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2898 if sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2899 if self_nan == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2900 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2901 if other_nan == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2902 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2903 if self_nan == 2:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2904 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2905 if other_nan == 2:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2906 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2907 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2908 if self_nan == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2909 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2910 if other_nan == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2911 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2912 if self_nan == 2:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2913 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2914 if other_nan == 2:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2915 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2916
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2917 if self < other:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2918 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2919 if self > other:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2920 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2921
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2922 if self._exp < other._exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2923 if sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2924 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2925 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2926 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2927 if self._exp > other._exp:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2928 if sign:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2929 return _NegativeOne
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2930 else:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2931 return _One
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2932 return _Zero
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2933
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2934
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2935 def compare_total_mag(self, other):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2936 """Compares self to other using abstract repr., ignoring sign.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2937
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2938 Like compare_total, but with operand's sign ignored and assumed to be 0.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2939 """
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
2940 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
2941
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2942 s = self.copy_abs()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2943 o = other.copy_abs()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2944 return s.compare_total(o)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2945
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2946 def copy_abs(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2947 """Returns a copy with the sign set to 0. """
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2948 return _dec_from_triple(0, self._int, self._exp, self._is_special)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2949
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2950 def copy_negate(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2951 """Returns a copy with the sign inverted."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2952 if self._sign:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2953 return _dec_from_triple(0, self._int, self._exp, self._is_special)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2954 else:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2955 return _dec_from_triple(1, self._int, self._exp, self._is_special)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2956
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2957 def copy_sign(self, other):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2958 """Returns self with the sign of other."""
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
2959 other = _convert_other(other, raiseit=True)
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2960 return _dec_from_triple(other._sign, self._int,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
2961 self._exp, self._is_special)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2962
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2963 def exp(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2964 """Returns e ** self."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2965
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2966 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2967 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2968
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2969 # exp(NaN) = NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2970 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2971 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2972 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2973
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2974 # exp(-Infinity) = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2975 if self._isinfinity() == -1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2976 return _Zero
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2977
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2978 # exp(0) = 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2979 if not self:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
2980 return _One
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2981
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2982 # exp(Infinity) = Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2983 if self._isinfinity() == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2984 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2985
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2986 # the result is now guaranteed to be inexact (the true
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2987 # mathematical result is transcendental). There's no need to
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2988 # raise Rounded and Inexact here---they'll always be raised as
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2989 # a result of the call to _fix.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2990 p = context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2991 adj = self.adjusted()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2992
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2993 # we only need to do any computation for quite a small range
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2994 # of adjusted exponents---for example, -29 <= adj <= 10 for
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2995 # the default context. For smaller exponent the result is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2996 # indistinguishable from 1 at the given precision, while for
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2997 # larger exponent the result either overflows or underflows.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2998 if self._sign == 0 and adj > len(str((context.Emax+1)*3)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
2999 # overflow
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3000 ans = _dec_from_triple(0, '1', context.Emax+1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3001 elif self._sign == 1 and adj > len(str((-context.Etiny()+1)*3)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3002 # underflow to 0
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3003 ans = _dec_from_triple(0, '1', context.Etiny()-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3004 elif self._sign == 0 and adj < -p:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3005 # p+1 digits; final round will raise correct flags
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3006 ans = _dec_from_triple(0, '1' + '0'*(p-1) + '1', -p)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3007 elif self._sign == 1 and adj < -p-1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3008 # p+1 digits; final round will raise correct flags
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3009 ans = _dec_from_triple(0, '9'*(p+1), -p-1)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3010 # general case
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3011 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3012 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3013 c, e = op.int, op.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3014 if op.sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3015 c = -c
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3016
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3017 # compute correctly rounded result: increase precision by
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3018 # 3 digits at a time until we get an unambiguously
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3019 # roundable result
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3020 extra = 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3021 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3022 coeff, exp = _dexp(c, e, p+extra)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3023 if coeff % (5*10**(len(str(coeff))-p-1)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3024 break
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3025 extra += 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3026
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3027 ans = _dec_from_triple(0, str(coeff), exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3028
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3029 # at this stage, ans should round correctly with *any*
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3030 # rounding mode, not just with ROUND_HALF_EVEN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3031 context = context._shallow_copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3032 rounding = context._set_rounding(ROUND_HALF_EVEN)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3033 ans = ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3034 context.rounding = rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3035
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3036 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3037
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3038 def is_canonical(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3039 """Return True if self is canonical; otherwise return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3040
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3041 Currently, the encoding of a Decimal instance is always
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3042 canonical, so this method returns True for any Decimal.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3043 """
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3044 return True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3045
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3046 def is_finite(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3047 """Return True if self is finite; otherwise return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3048
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3049 A Decimal instance is considered finite if it is neither
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3050 infinite nor a NaN.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3051 """
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3052 return not self._is_special
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3053
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3054 def is_infinite(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3055 """Return True if self is infinite; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3056 return self._exp == 'F'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3057
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3058 def is_nan(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3059 """Return True if self is a qNaN or sNaN; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3060 return self._exp in ('n', 'N')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3061
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3062 def is_normal(self, context=None):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3063 """Return True if self is a normal number; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3064 if self._is_special or not self:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3065 return False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3066 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3067 context = getcontext()
56644
26007395607e Merged revisions 75562 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56411
diff changeset
3068 return context.Emin <= self.adjusted()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3069
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3070 def is_qnan(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3071 """Return True if self is a quiet NaN; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3072 return self._exp == 'n'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3073
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3074 def is_signed(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3075 """Return True if self is negative; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3076 return self._sign == 1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3077
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3078 def is_snan(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3079 """Return True if self is a signaling NaN; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3080 return self._exp == 'N'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3081
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3082 def is_subnormal(self, context=None):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3083 """Return True if self is subnormal; otherwise return False."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3084 if self._is_special or not self:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3085 return False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3086 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3087 context = getcontext()
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3088 return self.adjusted() < context.Emin
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3089
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3090 def is_zero(self):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
3091 """Return True if self is a zero; otherwise return False."""
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3092 return not self._is_special and self._int == '0'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3093
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3094 def _ln_exp_bound(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3095 """Compute a lower bound for the adjusted exponent of self.ln().
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3096 In other words, compute r such that self.ln() >= 10**r. Assumes
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3097 that self is finite and positive and that self != 1.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3098 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3099
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3100 # for 0.1 <= x <= 10 we use the inequalities 1-1/x <= ln(x) <= x-1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3101 adj = self._exp + len(self._int) - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3102 if adj >= 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3103 # argument >= 10; we use 23/10 = 2.3 as a lower bound for ln(10)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3104 return len(str(adj*23//10)) - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3105 if adj <= -2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3106 # argument <= 0.1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3107 return len(str((-1-adj)*23//10)) - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3108 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3109 c, e = op.int, op.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3110 if adj == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3111 # 1 < self < 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3112 num = str(c-10**-e)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3113 den = str(c)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3114 return len(num) - len(den) - (num < den)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3115 # adj == -1, 0.1 <= self < 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3116 return e + len(str(10**-e - c)) - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3117
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3118
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3119 def ln(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3120 """Returns the natural (base e) logarithm of self."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3121
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3122 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3123 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3124
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3125 # ln(NaN) = NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3126 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3127 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3128 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3129
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3130 # ln(0.0) == -Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3131 if not self:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3132 return _NegativeInfinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3133
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3134 # ln(Infinity) = Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3135 if self._isinfinity() == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3136 return _Infinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3137
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3138 # ln(1.0) == 0.0
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3139 if self == _One:
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3140 return _Zero
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3141
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3142 # ln(negative) raises InvalidOperation
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3143 if self._sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3144 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3145 'ln of a negative value')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3146
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3147 # result is irrational, so necessarily inexact
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3148 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3149 c, e = op.int, op.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3150 p = context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3151
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3152 # correctly rounded result: repeatedly increase precision by 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3153 # until we get an unambiguously roundable result
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3154 places = p - self._ln_exp_bound() + 2 # at least p+3 places
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3155 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3156 coeff = _dlog(c, e, places)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3157 # assert len(str(abs(coeff)))-p >= 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3158 if coeff % (5*10**(len(str(abs(coeff)))-p-1)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3159 break
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3160 places += 3
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3161 ans = _dec_from_triple(int(coeff<0), str(abs(coeff)), -places)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3162
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3163 context = context._shallow_copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3164 rounding = context._set_rounding(ROUND_HALF_EVEN)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3165 ans = ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3166 context.rounding = rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3167 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3168
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3169 def _log10_exp_bound(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3170 """Compute a lower bound for the adjusted exponent of self.log10().
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3171 In other words, find r such that self.log10() >= 10**r.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3172 Assumes that self is finite and positive and that self != 1.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3173 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3174
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3175 # For x >= 10 or x < 0.1 we only need a bound on the integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3176 # part of log10(self), and this comes directly from the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3177 # exponent of x. For 0.1 <= x <= 10 we use the inequalities
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3178 # 1-1/x <= log(x) <= x-1. If x > 1 we have |log10(x)| >
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3179 # (1-1/x)/2.31 > 0. If x < 1 then |log10(x)| > (1-x)/2.31 > 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3180
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3181 adj = self._exp + len(self._int) - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3182 if adj >= 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3183 # self >= 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3184 return len(str(adj))-1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3185 if adj <= -2:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3186 # self < 0.1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3187 return len(str(-1-adj))-1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3188 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3189 c, e = op.int, op.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3190 if adj == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3191 # 1 < self < 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3192 num = str(c-10**-e)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3193 den = str(231*c)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3194 return len(num) - len(den) - (num < den) + 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3195 # adj == -1, 0.1 <= self < 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3196 num = str(10**-e-c)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3197 return len(num) + e - (num < "231") - 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3198
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3199 def log10(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3200 """Returns the base 10 logarithm of self."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3201
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3202 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3203 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3204
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3205 # log10(NaN) = NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3206 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3207 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3208 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3209
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3210 # log10(0.0) == -Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3211 if not self:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3212 return _NegativeInfinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3213
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3214 # log10(Infinity) = Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3215 if self._isinfinity() == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3216 return _Infinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3217
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3218 # log10(negative or -Infinity) raises InvalidOperation
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3219 if self._sign == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3220 return context._raise_error(InvalidOperation,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3221 'log10 of a negative value')
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3222
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3223 # log10(10**n) = n
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3224 if self._int[0] == '1' and self._int[1:] == '0'*(len(self._int) - 1):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3225 # answer may need rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3226 ans = Decimal(self._exp + len(self._int) - 1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3227 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3228 # result is irrational, so necessarily inexact
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3229 op = _WorkRep(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3230 c, e = op.int, op.exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3231 p = context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3232
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3233 # correctly rounded result: repeatedly increase precision
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3234 # until result is unambiguously roundable
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3235 places = p-self._log10_exp_bound()+2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3236 while True:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3237 coeff = _dlog10(c, e, places)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3238 # assert len(str(abs(coeff)))-p >= 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3239 if coeff % (5*10**(len(str(abs(coeff)))-p-1)):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3240 break
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3241 places += 3
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3242 ans = _dec_from_triple(int(coeff<0), str(abs(coeff)), -places)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3243
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3244 context = context._shallow_copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3245 rounding = context._set_rounding(ROUND_HALF_EVEN)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3246 ans = ans._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3247 context.rounding = rounding
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3248 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3249
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3250 def logb(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3251 """ Returns the exponent of the magnitude of self's MSD.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3252
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3253 The result is the integer which is the exponent of the magnitude
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3254 of the most significant digit of self (as though it were truncated
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3255 to a single digit while maintaining the value of that digit and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3256 without limiting the resulting exponent).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3257 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3258 # logb(NaN) = NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3259 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3260 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3261 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3262
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3263 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3264 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3265
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3266 # logb(+/-Inf) = +Inf
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3267 if self._isinfinity():
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3268 return _Infinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3269
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3270 # logb(0) = -Inf, DivisionByZero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3271 if not self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3272 return context._raise_error(DivisionByZero, 'logb(0)', 1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3273
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3274 # otherwise, simply return the adjusted exponent of self, as a
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3275 # Decimal. Note that no attempt is made to fit the result
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3276 # into the current context.
56411
dc047d9abf7b Merged revisions 75276 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
3277 ans = Decimal(self.adjusted())
dc047d9abf7b Merged revisions 75276 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
3278 return ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3279
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3280 def _islogical(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3281 """Return True if self is a logical operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3282
44742
14d4104976fc Merged revisions 59985-60000,60002,60005-60007,60009-60042 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44654
diff changeset
3283 For being logical, it must be a finite number with a sign of 0,
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3284 an exponent of 0, and a coefficient whose digits must all be
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3285 either 0 or 1.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3286 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3287 if self._sign != 0 or self._exp != 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3288 return False
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3289 for dig in self._int:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3290 if dig not in '01':
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3291 return False
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3292 return True
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3293
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3294 def _fill_logical(self, context, opa, opb):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3295 dif = context.prec - len(opa)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3296 if dif > 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3297 opa = '0'*dif + opa
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3298 elif dif < 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3299 opa = opa[-context.prec:]
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3300 dif = context.prec - len(opb)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3301 if dif > 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3302 opb = '0'*dif + opb
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3303 elif dif < 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3304 opb = opb[-context.prec:]
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3305 return opa, opb
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3306
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3307 def logical_and(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3308 """Applies an 'and' operation between self and other's digits."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3309 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3310 context = getcontext()
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3311
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3312 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3313
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3314 if not self._islogical() or not other._islogical():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3315 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3316
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3317 # fill to context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3318 (opa, opb) = self._fill_logical(context, self._int, other._int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3319
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3320 # make the operation, and clean starting zeroes
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3321 result = "".join([str(int(a)&int(b)) for a,b in zip(opa,opb)])
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3322 return _dec_from_triple(0, result.lstrip('0') or '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3323
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3324 def logical_invert(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3325 """Invert all its digits."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3326 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3327 context = getcontext()
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3328 return self.logical_xor(_dec_from_triple(0,'1'*context.prec,0),
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3329 context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3330
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3331 def logical_or(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3332 """Applies an 'or' operation between self and other's digits."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3333 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3334 context = getcontext()
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3335
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3336 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3337
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3338 if not self._islogical() or not other._islogical():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3339 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3340
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3341 # fill to context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3342 (opa, opb) = self._fill_logical(context, self._int, other._int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3343
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3344 # make the operation, and clean starting zeroes
50602
5436e534da6e Merged revisions 68317-68318 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50597
diff changeset
3345 result = "".join([str(int(a)|int(b)) for a,b in zip(opa,opb)])
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3346 return _dec_from_triple(0, result.lstrip('0') or '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3347
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3348 def logical_xor(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3349 """Applies an 'xor' operation between self and other's digits."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3350 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3351 context = getcontext()
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3352
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3353 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3354
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3355 if not self._islogical() or not other._islogical():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3356 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3357
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3358 # fill to context.prec
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3359 (opa, opb) = self._fill_logical(context, self._int, other._int)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3360
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3361 # make the operation, and clean starting zeroes
50602
5436e534da6e Merged revisions 68317-68318 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50597
diff changeset
3362 result = "".join([str(int(a)^int(b)) for a,b in zip(opa,opb)])
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3363 return _dec_from_triple(0, result.lstrip('0') or '0', 0)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3364
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3365 def max_mag(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3366 """Compares the values numerically with their sign ignored."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3367 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3368
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3369 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3370 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3371
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3372 if self._is_special or other._is_special:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3373 # If one operand is a quiet NaN and the other is number, then the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3374 # number is always returned
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3375 sn = self._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3376 on = other._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3377 if sn or on:
50115
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3378 if on == 1 and sn == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3379 return self._fix(context)
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3380 if sn == 1 and on == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3381 return other._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3382 return self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3383
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
3384 c = self.copy_abs()._cmp(other.copy_abs())
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3385 if c == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3386 c = self.compare_total(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3387
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3388 if c == -1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3389 ans = other
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3390 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3391 ans = self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3392
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
3393 return ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3394
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3395 def min_mag(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3396 """Compares the values numerically with their sign ignored."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3397 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3398
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3399 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3400 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3401
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3402 if self._is_special or other._is_special:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3403 # If one operand is a quiet NaN and the other is number, then the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3404 # number is always returned
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3405 sn = self._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3406 on = other._isnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3407 if sn or on:
50115
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3408 if on == 1 and sn == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3409 return self._fix(context)
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3410 if sn == 1 and on == 0:
21de7a9146f7 Merged revisions 67695 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 48848
diff changeset
3411 return other._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3412 return self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3413
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
3414 c = self.copy_abs()._cmp(other.copy_abs())
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3415 if c == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3416 c = self.compare_total(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3417
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3418 if c == -1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3419 ans = self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3420 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3421 ans = other
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3422
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
3423 return ans._fix(context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3424
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3425 def next_minus(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3426 """Returns the largest representable number smaller than itself."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3427 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3428 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3429
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3430 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3431 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3432 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3433
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3434 if self._isinfinity() == -1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3435 return _NegativeInfinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3436 if self._isinfinity() == 1:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3437 return _dec_from_triple(0, '9'*context.prec, context.Etop())
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3438
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3439 context = context.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3440 context._set_rounding(ROUND_FLOOR)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3441 context._ignore_all_flags()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3442 new_self = self._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3443 if new_self != self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3444 return new_self
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3445 return self.__sub__(_dec_from_triple(0, '1', context.Etiny()-1),
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3446 context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3447
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3448 def next_plus(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3449 """Returns the smallest representable number larger than itself."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3450 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3451 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3452
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3453 ans = self._check_nans(context=context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3454 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3455 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3456
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3457 if self._isinfinity() == 1:
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
3458 return _Infinity
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3459 if self._isinfinity() == -1:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3460 return _dec_from_triple(1, '9'*context.prec, context.Etop())
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3461
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3462 context = context.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3463 context._set_rounding(ROUND_CEILING)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3464 context._ignore_all_flags()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3465 new_self = self._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3466 if new_self != self:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3467 return new_self
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3468 return self.__add__(_dec_from_triple(0, '1', context.Etiny()-1),
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3469 context)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3470
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3471 def next_toward(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3472 """Returns the number closest to self, in the direction towards other.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3473
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3474 The result is the closest representable number to self
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3475 (excluding self) that is in the direction towards other,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3476 unless both have the same value. If the two operands are
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3477 numerically equal, then the result is a copy of self with the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3478 sign set to be the same as the sign of other.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3479 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3480 other = _convert_other(other, raiseit=True)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3481
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3482 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3483 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3484
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3485 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3486 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3487 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3488
45244
2a821e001a2b Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617-60678 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45092
diff changeset
3489 comparison = self._cmp(other)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3490 if comparison == 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3491 return self.copy_sign(other)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3492
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3493 if comparison == -1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3494 ans = self.next_plus(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3495 else: # comparison == 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3496 ans = self.next_minus(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3497
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3498 # decide which flags to raise using value of ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3499 if ans._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3500 context._raise_error(Overflow,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3501 'Infinite result from next_toward',
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3502 ans._sign)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
3503 context._raise_error(Inexact)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3504 context._raise_error(Rounded)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3505 elif ans.adjusted() < context.Emin:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3506 context._raise_error(Underflow)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3507 context._raise_error(Subnormal)
61214
1143972f04bb Merged revisions 80755 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58665
diff changeset
3508 context._raise_error(Inexact)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3509 context._raise_error(Rounded)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3510 # if precision == 1 then we don't raise Clamped for a
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3511 # result 0E-Etiny.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3512 if not ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3513 context._raise_error(Clamped)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3514
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3515 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3516
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3517 def number_class(self, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3518 """Returns an indication of the class of self.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3519
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3520 The class is one of the following strings:
44373
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
3521 sNaN
2750d531fdc0 Merged revisions 59565-59594 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44329
diff changeset
3522 NaN
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3523 -Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3524 -Normal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3525 -Subnormal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3526 -Zero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3527 +Zero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3528 +Subnormal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3529 +Normal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3530 +Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3531 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3532 if self.is_snan():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3533 return "sNaN"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3534 if self.is_qnan():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3535 return "NaN"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3536 inf = self._isinfinity()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3537 if inf == 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3538 return "+Infinity"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3539 if inf == -1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3540 return "-Infinity"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3541 if self.is_zero():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3542 if self._sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3543 return "-Zero"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3544 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3545 return "+Zero"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3546 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3547 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3548 if self.is_subnormal(context=context):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3549 if self._sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3550 return "-Subnormal"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3551 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3552 return "+Subnormal"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3553 # just a normal, regular, boring number, :)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3554 if self._sign:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3555 return "-Normal"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3556 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3557 return "+Normal"
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3558
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3559 def radix(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3560 """Just returns 10, as this is Decimal, :)"""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3561 return Decimal(10)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3562
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3563 def rotate(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3564 """Returns a rotated copy of self, value-of-other times."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3565 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3566 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3567
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3568 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3569
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3570 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3571 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3572 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3573
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3574 if other._exp != 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3575 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3576 if not (-context.prec <= int(other) <= context.prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3577 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3578
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3579 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3580 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3581
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3582 # get values, pad if necessary
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3583 torot = int(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3584 rotdig = self._int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3585 topad = context.prec - len(rotdig)
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3586 if topad > 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3587 rotdig = '0'*topad + rotdig
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3588 elif topad < 0:
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3589 rotdig = rotdig[-topad:]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3590
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3591 # let's rotate!
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3592 rotated = rotdig[torot:] + rotdig[:torot]
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3593 return _dec_from_triple(self._sign,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3594 rotated.lstrip('0') or '0', self._exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3595
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3596 def scaleb(self, other, context=None):
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3597 """Returns self operand after adding the second value to its exp."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3598 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3599 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3600
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3601 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3602
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3603 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3604 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3605 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3606
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3607 if other._exp != 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3608 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3609 liminf = -2 * (context.Emax + context.prec)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3610 limsup = 2 * (context.Emax + context.prec)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3611 if not (liminf <= int(other) <= limsup):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3612 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3613
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3614 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3615 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3616
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3617 d = _dec_from_triple(self._sign, self._int, self._exp + int(other))
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3618 d = d._fix(context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3619 return d
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3620
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3621 def shift(self, other, context=None):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3622 """Returns a shifted copy of self, value-of-other times."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3623 if context is None:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3624 context = getcontext()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3625
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3626 other = _convert_other(other, raiseit=True)
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3627
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3628 ans = self._check_nans(other, context)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3629 if ans:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3630 return ans
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3631
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3632 if other._exp != 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3633 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3634 if not (-context.prec <= int(other) <= context.prec):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3635 return context._raise_error(InvalidOperation)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3636
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3637 if self._isinfinity():
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3638 return Decimal(self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3639
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3640 # get values, pad if necessary
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3641 torot = int(other)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3642 rotdig = self._int
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3643 topad = context.prec - len(rotdig)
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3644 if topad > 0:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3645 rotdig = '0'*topad + rotdig
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3646 elif topad < 0:
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3647 rotdig = rotdig[-topad:]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3648
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3649 # let's shift!
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3650 if torot < 0:
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3651 shifted = rotdig[:torot]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3652 else:
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3653 shifted = rotdig + '0'*torot
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3654 shifted = shifted[-context.prec:]
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3655
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3656 return _dec_from_triple(self._sign,
56973
0ed4bf430d4e Merged revisions 75947 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56644
diff changeset
3657 shifted.lstrip('0') or '0', self._exp)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3658
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3659 # Support for pickling, copy, and deepcopy
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3660 def __reduce__(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3661 return (self.__class__, (str(self),))
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3662
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3663 def __copy__(self):
58668
72ecfffe9f02 Merged revisions 77712,77740-77741,77756,77886,77902,77936 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 58664
diff changeset
3664 if type(self) is Decimal:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3665 return self # I'm immutable; therefore I am my own clone
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3666 return self.__class__(str(self))
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3667
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3668 def __deepcopy__(self, memo):
58668
72ecfffe9f02 Merged revisions 77712,77740-77741,77756,77886,77902,77936 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 58664
diff changeset
3669 if type(self) is Decimal:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3670 return self # My components are also immutable
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3671 return self.__class__(str(self))
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3672
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3673 # PEP 3101 support. the _localeconv keyword argument should be
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3674 # considered private: it's provided for ease of testing only.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3675 def __format__(self, specifier, context=None, _localeconv=None):
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3676 """Format a Decimal instance according to the given specifier.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3677
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3678 The specifier should be a standard format specifier, with the
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3679 form described in PEP 3101. Formatting types 'e', 'E', 'f',
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3680 'F', 'g', 'G', 'n' and '%' are supported. If the formatting
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3681 type is omitted it defaults to 'g' or 'G', depending on the
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3682 value of context.capitals.
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3683 """
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3684
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3685 # Note: PEP 3101 says that if the type is not present then
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3686 # there should be at least one digit after the decimal point.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3687 # We take the liberty of ignoring this requirement for
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3688 # Decimal---it's presumably there to make sure that
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3689 # format(float, '') behaves similarly to str(float).
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3690 if context is None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3691 context = getcontext()
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3692
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3693 spec = _parse_format_specifier(specifier, _localeconv=_localeconv)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3694
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3695 # special values don't care about the type or precision
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3696 if self._is_special:
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3697 sign = _format_sign(self._sign, spec)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3698 body = str(self.copy_abs())
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3699 return _format_align(sign, body, spec)
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3700
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3701 # a type of None defaults to 'g' or 'G', depending on context
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3702 if spec['type'] is None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3703 spec['type'] = ['g', 'G'][context.capitals]
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3704
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3705 # if type is '%', adjust exponent of self accordingly
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3706 if spec['type'] == '%':
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3707 self = _dec_from_triple(self._sign, self._int, self._exp+2)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3708
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3709 # round if necessary, taking rounding mode from the context
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3710 rounding = context.rounding
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3711 precision = spec['precision']
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3712 if precision is not None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3713 if spec['type'] in 'eE':
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3714 self = self._round(precision+1, rounding)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3715 elif spec['type'] in 'fF%':
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3716 self = self._rescale(-precision, rounding)
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3717 elif spec['type'] in 'gG' and len(self._int) > precision:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3718 self = self._round(precision, rounding)
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3719 # special case: zeros with a positive exponent can't be
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3720 # represented in fixed point; rescale them to 0e0.
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3721 if not self and self._exp > 0 and spec['type'] in 'fF%':
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3722 self = self._rescale(0, rounding)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3723
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3724 # figure out placement of the decimal point
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3725 leftdigits = self._exp + len(self._int)
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3726 if spec['type'] in 'eE':
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3727 if not self and precision is not None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3728 dotplace = 1 - precision
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3729 else:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3730 dotplace = 1
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3731 elif spec['type'] in 'fF%':
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3732 dotplace = leftdigits
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3733 elif spec['type'] in 'gG':
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3734 if self._exp <= 0 and leftdigits > -6:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3735 dotplace = leftdigits
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3736 else:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3737 dotplace = 1
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3738
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3739 # find digits before and after decimal point, and get exponent
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3740 if dotplace < 0:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3741 intpart = '0'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3742 fracpart = '0'*(-dotplace) + self._int
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3743 elif dotplace > len(self._int):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3744 intpart = self._int + '0'*(dotplace-len(self._int))
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3745 fracpart = ''
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3746 else:
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3747 intpart = self._int[:dotplace] or '0'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3748 fracpart = self._int[dotplace:]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3749 exp = leftdigits-dotplace
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3750
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3751 # done with the decimal-specific stuff; hand over the rest
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3752 # of the formatting to the _format_number function
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
3753 return _format_number(self._sign, intpart, fracpart, exp, spec)
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
3754
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3755 def _dec_from_triple(sign, coefficient, exponent, special=False):
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3756 """Create a decimal instance directly, without any validation,
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3757 normalization (e.g. removal of leading zeros) or argument
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3758 conversion.
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3759
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3760 This function is for *internal use only*.
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3761 """
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3762
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3763 self = object.__new__(Decimal)
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3764 self._sign = sign
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3765 self._int = coefficient
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3766 self._exp = exponent
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3767 self._is_special = special
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3768
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3769 return self
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
3770
51297
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3771 # Register Decimal as a kind of Number (an abstract base class).
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3772 # However, do not register it as Real (because Decimals are not
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3773 # interoperable with floats).
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3774 _numbers.Number.register(Decimal)
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3775
5b713045ea90 Register decimals as numbers.Number
Raymond Hettinger <python@rcn.com>
parents: 51029
diff changeset
3776
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3777 ##### Context class #######################################################
32477
bc586db9945a Work through several open todos:
Raymond Hettinger <python@rcn.com>
parents: 32456
diff changeset
3778
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3779 class _ContextManager(object):
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3780 """Context manager class to support localcontext().
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3781
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3782 Sets a copy of the supplied context in __enter__() and restores
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3783 the previous decimal context in __exit__()
36737
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3784 """
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3785 def __init__(self, new_context):
40450
cc992d75d5b3 Four months of trunk changes (including a few releases...)
Thomas Wouters <thomas@python.org>
parents: 40404
diff changeset
3786 self.new_context = new_context.copy()
36737
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3787 def __enter__(self):
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3788 self.saved_context = getcontext()
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3789 setcontext(self.new_context)
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3790 return self.new_context
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3791 def __exit__(self, t, v, tb):
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3792 setcontext(self.saved_context)
fa92fe15251a Updates to the with-statement:
Guido van Rossum <guido@python.org>
parents: 35379
diff changeset
3793
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3794 class Context(object):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3795 """Contains the context for a Decimal instance.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3796
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3797 Contains:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3798 prec - precision (for use in rounding, division, square roots..)
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3799 rounding - rounding type (how you round)
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
3800 traps - If traps[exception] = 1, then the exception is
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3801 raised when it is caused. Otherwise, a value is
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3802 substituted in.
45092
faa88ff4cce4 Context flags get set, not incremented.
Raymond Hettinger <python@rcn.com>
parents: 44943
diff changeset
3803 flags - When an exception is caused, flags[exception] is set.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3804 (Whether or not the trap_enabler is set)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3805 Should be reset by user of Decimal instance.
32489
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
3806 Emin - Minimum exponent
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
3807 Emax - Maximum exponent
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3808 capitals - If 1, 1*10^1 is printed as 1E+1.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3809 If 0, printed as 1e1
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3810 clamp - If 1, change exponents if too high (Default 0)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3811 """
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
3812
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3813 def __init__(self, prec=None, rounding=None,
33722
74a57e6684f3 Don't use mutable values for method defaults.
Raymond Hettinger <python@rcn.com>
parents: 33695
diff changeset
3814 traps=None, flags=None,
32489
ab0a2b74ddfd Changed the rounding constant values to match their variable names.
Raymond Hettinger <python@rcn.com>
parents: 32487
diff changeset
3815 Emin=None, Emax=None,
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3816 capitals=None, clamp=None,
33722
74a57e6684f3 Don't use mutable values for method defaults.
Raymond Hettinger <python@rcn.com>
parents: 33695
diff changeset
3817 _ignored_flags=None):
62870
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3818 # Set defaults; for everything except flags and _ignored_flags,
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3819 # inherit from DefaultContext.
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3820 try:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3821 dc = DefaultContext
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3822 except NameError:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3823 pass
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3824
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3825 self.prec = prec if prec is not None else dc.prec
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3826 self.rounding = rounding if rounding is not None else dc.rounding
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3827 self.Emin = Emin if Emin is not None else dc.Emin
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3828 self.Emax = Emax if Emax is not None else dc.Emax
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3829 self.capitals = capitals if capitals is not None else dc.capitals
62869
09f5fd013c0b Issue #9136: Profiling Decimal gave 'dictionary changed size during iteration'.
Mark Dickinson <dickinsm@gmail.com>
parents: 62865
diff changeset
3830 self.clamp = clamp if clamp is not None else dc.clamp
62870
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3831
33722
74a57e6684f3 Don't use mutable values for method defaults.
Raymond Hettinger <python@rcn.com>
parents: 33695
diff changeset
3832 if _ignored_flags is None:
62870
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3833 self._ignored_flags = []
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3834 else:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3835 self._ignored_flags = _ignored_flags
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3836
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3837 if traps is None:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3838 self.traps = dc.traps.copy()
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3839 elif not isinstance(traps, dict):
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3840 self.traps = dict((s, int(s in traps)) for s in _signals)
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3841 else:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3842 self.traps = traps
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3843
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3844 if flags is None:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3845 self.flags = dict.fromkeys(_signals, 0)
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3846 elif not isinstance(flags, dict):
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3847 self.flags = dict((s, int(s in flags)) for s in _signals)
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3848 else:
9752b85c0119 Merged revisions 82654 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 62866
diff changeset
3849 self.flags = flags
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3850
32487
fa23a9b18967 Fix clear_flags(). Make a readable (not evalable) Context repr.
Raymond Hettinger <python@rcn.com>
parents: 32482
diff changeset
3851 def __repr__(self):
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
3852 """Show the current context."""
32487
fa23a9b18967 Fix clear_flags(). Make a readable (not evalable) Context repr.
Raymond Hettinger <python@rcn.com>
parents: 32482
diff changeset
3853 s = []
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3854 s.append('Context(prec=%(prec)d, rounding=%(rounding)s, '
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3855 'Emin=%(Emin)d, Emax=%(Emax)d, capitals=%(capitals)d, '
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3856 'clamp=%(clamp)d'
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3857 % vars(self))
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3858 names = [f.__name__ for f, v in self.flags.items() if v]
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3859 s.append('flags=[' + ', '.join(names) + ']')
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3860 names = [t.__name__ for t, v in self.traps.items() if v]
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3861 s.append('traps=[' + ', '.join(names) + ']')
32487
fa23a9b18967 Fix clear_flags(). Make a readable (not evalable) Context repr.
Raymond Hettinger <python@rcn.com>
parents: 32482
diff changeset
3862 return ', '.join(s) + ')'
fa23a9b18967 Fix clear_flags(). Make a readable (not evalable) Context repr.
Raymond Hettinger <python@rcn.com>
parents: 32482
diff changeset
3863
32477
bc586db9945a Work through several open todos:
Raymond Hettinger <python@rcn.com>
parents: 32456
diff changeset
3864 def clear_flags(self):
bc586db9945a Work through several open todos:
Raymond Hettinger <python@rcn.com>
parents: 32456
diff changeset
3865 """Reset all flags to zero"""
bc586db9945a Work through several open todos:
Raymond Hettinger <python@rcn.com>
parents: 32456
diff changeset
3866 for flag in self.flags:
32487
fa23a9b18967 Fix clear_flags(). Make a readable (not evalable) Context repr.
Raymond Hettinger <python@rcn.com>
parents: 32482
diff changeset
3867 self.flags[flag] = 0
32477
bc586db9945a Work through several open todos:
Raymond Hettinger <python@rcn.com>
parents: 32456
diff changeset
3868
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
3869 def _shallow_copy(self):
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
3870 """Returns a shallow copy from self."""
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
3871 nc = Context(self.prec, self.rounding, self.traps,
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
3872 self.flags, self.Emin, self.Emax,
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3873 self.capitals, self.clamp, self._ignored_flags)
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
3874 return nc
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
3875
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3876 def copy(self):
33044
2749334d71a4 * Context.copy() now makes a deepcopy.
Raymond Hettinger <python@rcn.com>
parents: 32980
diff changeset
3877 """Returns a deep copy from self."""
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3878 nc = Context(self.prec, self.rounding, self.traps.copy(),
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
3879 self.flags.copy(), self.Emin, self.Emax,
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3880 self.capitals, self.clamp, self._ignored_flags)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3881 return nc
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
3882 __copy__ = copy
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3883
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3884 # _clamp is provided for backwards compatibility with third-party
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3885 # code. May be removed in Python >= 3.3.
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3886 def _get_clamp(self):
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3887 "_clamp mirrors the clamp attribute. Its use is deprecated."
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3888 import warnings
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3889 warnings.warn('Use of the _clamp attribute is deprecated. '
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3890 'Please use clamp instead.',
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3891 DeprecationWarning)
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3892 return self.clamp
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3893
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3894 def _set_clamp(self, clamp):
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3895 "_clamp mirrors the clamp attribute. Its use is deprecated."
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3896 import warnings
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3897 warnings.warn('Use of the _clamp attribute is deprecated. '
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3898 'Please use clamp instead.',
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3899 DeprecationWarning)
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3900 self.clamp = clamp
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3901
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3902 # don't bother with _del_clamp; no sane 3rd party code should
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3903 # be deleting the _clamp attribute
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3904 _clamp = property(_get_clamp, _set_clamp)
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3905
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
3906 def _raise_error(self, condition, explanation = None, *args):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3907 """Handles an error
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3908
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3909 If the flag is in _ignored_flags, returns the default response.
45092
faa88ff4cce4 Context flags get set, not incremented.
Raymond Hettinger <python@rcn.com>
parents: 44943
diff changeset
3910 Otherwise, it sets the flag, then, if the corresponding
61746
49d7de9d7b1a Merged revisions 81352 via svnmerge from
Stefan Krah <stefan@bytereef.org>
parents: 61214
diff changeset
3911 trap_enabler is set, it reraises the exception. Otherwise, it returns
45092
faa88ff4cce4 Context flags get set, not incremented.
Raymond Hettinger <python@rcn.com>
parents: 44943
diff changeset
3912 the default value after setting the flag.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3913 """
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
3914 error = _condition_map.get(condition, condition)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3915 if error in self._ignored_flags:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3916 # Don't touch the flag
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3917 return error().handle(self, *args)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3918
45092
faa88ff4cce4 Context flags get set, not incremented.
Raymond Hettinger <python@rcn.com>
parents: 44943
diff changeset
3919 self.flags[error] = 1
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
3920 if not self.traps[error]:
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3921 # The errors define how to handle themselves.
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
3922 return condition().handle(self, *args)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3923
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3924 # Errors should only be risked on copies of the context
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
3925 # self._ignored_flags = []
43020
907a45df1295 Raise statement normalization in Lib/.
Collin Winter <collinw@gmail.com>
parents: 42629
diff changeset
3926 raise error(explanation)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3927
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3928 def _ignore_all_flags(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3929 """Ignore all flags, if they are raised"""
32666
c13d911ae05b * Rename "Signals" to "_signals" making it non-public.
Raymond Hettinger <python@rcn.com>
parents: 32576
diff changeset
3930 return self._ignore_flags(*_signals)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3931
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3932 def _ignore_flags(self, *flags):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3933 """Ignore the flags, if they are raised"""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3934 # Do not mutate-- This way, copies of a context leave the original
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3935 # alone.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3936 self._ignored_flags = (self._ignored_flags + list(flags))
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3937 return list(flags)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3938
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3939 def _regard_flags(self, *flags):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3940 """Stop ignoring the flags, if they are raised"""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3941 if flags and isinstance(flags[0], (tuple,list)):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3942 flags = flags[0]
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3943 for flag in flags:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3944 self._ignored_flags.remove(flag)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3945
48475
f4e7ef4329a9 Manual forward port of 64962 - use PyObject_HashNotImplemented as a tp_hash level indicator that the default hash implementation has not been inherited
Nick Coghlan <ncoghlan@gmail.com>
parents: 48412
diff changeset
3946 # We inherit object.__hash__, so we must deny this explicitly
f4e7ef4329a9 Manual forward port of 64962 - use PyObject_HashNotImplemented as a tp_hash level indicator that the default hash implementation has not been inherited
Nick Coghlan <ncoghlan@gmail.com>
parents: 48412
diff changeset
3947 __hash__ = None
32560
e4b96c3a3e12 Module and tests:
Raymond Hettinger <python@rcn.com>
parents: 32529
diff changeset
3948
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3949 def Etiny(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3950 """Returns Etiny (= Emin - prec + 1)"""
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3951 return int(self.Emin - self.prec + 1)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3952
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3953 def Etop(self):
32496
9c87518faf6b * Fixup docstrings
Raymond Hettinger <python@rcn.com>
parents: 32489
diff changeset
3954 """Returns maximum exponent (= Emax - prec + 1)"""
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3955 return int(self.Emax - self.prec + 1)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3956
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3957 def _set_rounding(self, type):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3958 """Sets the rounding type.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3959
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3960 Sets the rounding type, and returns the current (previous)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3961 rounding type. Often used like:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3962
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3963 context = context.copy()
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3964 # so you don't change the calling context
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3965 # if an error occurs in the middle.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3966 rounding = context._set_rounding(ROUND_UP)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3967 val = self.__sub__(other, context=context)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3968 context._set_rounding(rounding)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3969
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3970 This will make it round up for that operation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3971 """
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3972 rounding = self.rounding
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3973 self.rounding= type
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3974 return rounding
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3975
32666
c13d911ae05b * Rename "Signals" to "_signals" making it non-public.
Raymond Hettinger <python@rcn.com>
parents: 32576
diff changeset
3976 def create_decimal(self, num='0'):
44654
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3977 """Creates a new Decimal instance but using self as context.
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3978
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3979 This method implements the to-number operation of the
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3980 IBM Decimal specification."""
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3981
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3982 if isinstance(num, str) and num != num.strip():
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3983 return self._raise_error(ConversionSyntax,
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3984 "no trailing or leading whitespace is "
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3985 "permitted.")
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
3986
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3987 d = Decimal(num, context=self)
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
3988 if d._isnan() and len(d._int) > self.prec - self.clamp:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3989 return self._raise_error(ConversionSyntax,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
3990 "diagnostic info too long in NaN")
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
3991 return d._fix(self)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
3992
50499
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3993 def create_decimal_from_float(self, f):
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3994 """Creates a new Decimal instance from a float but rounding using self
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3995 as the context.
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3996
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3997 >>> context = Context(prec=5, rounding=ROUND_DOWN)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3998 >>> context.create_decimal_from_float(3.1415926535897932)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
3999 Decimal('3.1415')
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4000 >>> context = Context(prec=5, traps=[Inexact])
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4001 >>> context.create_decimal_from_float(3.1415926535897932)
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4002 Traceback (most recent call last):
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4003 ...
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4004 decimal.Inexact: None
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4005
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4006 """
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4007 d = Decimal.from_float(f) # An exact conversion
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4008 return d._fix(self) # Apply the context rounding
104005d07ea5 Issue 4796: Add from_float methods to the decimal module.
Raymond Hettinger <python@rcn.com>
parents: 50482
diff changeset
4009
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4010 # Methods
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4011 def abs(self, a):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4012 """Returns the absolute value of the operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4013
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4014 If the operand is negative, the result is the same as using the minus
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4015 operation on the operand. Otherwise, the result is the same as using
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4016 the plus operation on the operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4017
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4018 >>> ExtendedContext.abs(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4019 Decimal('2.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4020 >>> ExtendedContext.abs(Decimal('-100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4021 Decimal('100')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4022 >>> ExtendedContext.abs(Decimal('101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4023 Decimal('101.5')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4024 >>> ExtendedContext.abs(Decimal('-101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4025 Decimal('101.5')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4026 >>> ExtendedContext.abs(-1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4027 Decimal('1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4028 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4029 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4030 return a.__abs__(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4031
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4032 def add(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4033 """Return the sum of the two operands.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4034
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4035 >>> ExtendedContext.add(Decimal('12'), Decimal('7.00'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4036 Decimal('19.00')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4037 >>> ExtendedContext.add(Decimal('1E+2'), Decimal('1.01E+4'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4038 Decimal('1.02E+4')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4039 >>> ExtendedContext.add(1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4040 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4041 >>> ExtendedContext.add(Decimal(8), 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4042 Decimal('13')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4043 >>> ExtendedContext.add(5, 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4044 Decimal('10')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4045 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4046 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4047 r = a.__add__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4048 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4049 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4050 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4051 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4052
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4053 def _apply(self, a):
33695
924bb2aad4f4 SF patch #1043218
Raymond Hettinger <python@rcn.com>
parents: 33596
diff changeset
4054 return str(a._fix(self))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4055
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4056 def canonical(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4057 """Returns the same Decimal object.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4058
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4059 As we do not have different encodings for the same number, the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4060 received object already is in its canonical form.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4061
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4062 >>> ExtendedContext.canonical(Decimal('2.50'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4063 Decimal('2.50')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4064 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4065 return a.canonical(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4066
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4067 def compare(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4068 """Compares values numerically.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4069
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4070 If the signs of the operands differ, a value representing each operand
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4071 ('-1' if the operand is less than zero, '0' if the operand is zero or
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4072 negative zero, or '1' if the operand is greater than zero) is used in
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4073 place of that operand for the comparison instead of the actual
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4074 operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4075
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4076 The comparison is then effected by subtracting the second operand from
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4077 the first and then returning a value according to the result of the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4078 subtraction: '-1' if the result is less than zero, '0' if the result is
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4079 zero or negative zero, or '1' if the result is greater than zero.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4080
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4081 >>> ExtendedContext.compare(Decimal('2.1'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4082 Decimal('-1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4083 >>> ExtendedContext.compare(Decimal('2.1'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4084 Decimal('0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4085 >>> ExtendedContext.compare(Decimal('2.1'), Decimal('2.10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4086 Decimal('0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4087 >>> ExtendedContext.compare(Decimal('3'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4088 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4089 >>> ExtendedContext.compare(Decimal('2.1'), Decimal('-3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4090 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4091 >>> ExtendedContext.compare(Decimal('-3'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4092 Decimal('-1')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4093 >>> ExtendedContext.compare(1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4094 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4095 >>> ExtendedContext.compare(Decimal(1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4096 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4097 >>> ExtendedContext.compare(1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4098 Decimal('-1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4099 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4100 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4101 return a.compare(b, context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4102
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4103 def compare_signal(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4104 """Compares the values of the two operands numerically.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4105
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4106 It's pretty much like compare(), but all NaNs signal, with signaling
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4107 NaNs taking precedence over quiet NaNs.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4108
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4109 >>> c = ExtendedContext
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4110 >>> c.compare_signal(Decimal('2.1'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4111 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4112 >>> c.compare_signal(Decimal('2.1'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4113 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4114 >>> c.flags[InvalidOperation] = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4115 >>> print(c.flags[InvalidOperation])
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4116 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4117 >>> c.compare_signal(Decimal('NaN'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4118 Decimal('NaN')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4119 >>> print(c.flags[InvalidOperation])
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4120 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4121 >>> c.flags[InvalidOperation] = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4122 >>> print(c.flags[InvalidOperation])
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4123 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4124 >>> c.compare_signal(Decimal('sNaN'), Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4125 Decimal('NaN')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4126 >>> print(c.flags[InvalidOperation])
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4127 1
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4128 >>> c.compare_signal(-1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4129 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4130 >>> c.compare_signal(Decimal(-1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4131 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4132 >>> c.compare_signal(-1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4133 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4134 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4135 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4136 return a.compare_signal(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4137
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4138 def compare_total(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4139 """Compares two operands using their abstract representation.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4140
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4141 This is not like the standard compare, which use their numerical
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4142 value. Note that a total ordering is defined for all possible abstract
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4143 representations.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4144
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4145 >>> ExtendedContext.compare_total(Decimal('12.73'), Decimal('127.9'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4146 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4147 >>> ExtendedContext.compare_total(Decimal('-127'), Decimal('12'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4148 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4149 >>> ExtendedContext.compare_total(Decimal('12.30'), Decimal('12.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4150 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4151 >>> ExtendedContext.compare_total(Decimal('12.30'), Decimal('12.30'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4152 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4153 >>> ExtendedContext.compare_total(Decimal('12.3'), Decimal('12.300'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4154 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4155 >>> ExtendedContext.compare_total(Decimal('12.3'), Decimal('NaN'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4156 Decimal('-1')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4157 >>> ExtendedContext.compare_total(1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4158 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4159 >>> ExtendedContext.compare_total(Decimal(1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4160 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4161 >>> ExtendedContext.compare_total(1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4162 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4163 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4164 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4165 return a.compare_total(b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4166
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4167 def compare_total_mag(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4168 """Compares two operands using their abstract representation ignoring sign.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4169
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4170 Like compare_total, but with operand's sign ignored and assumed to be 0.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4171 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4172 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4173 return a.compare_total_mag(b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4174
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4175 def copy_abs(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4176 """Returns a copy of the operand with the sign set to 0.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4177
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4178 >>> ExtendedContext.copy_abs(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4179 Decimal('2.1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4180 >>> ExtendedContext.copy_abs(Decimal('-100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4181 Decimal('100')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4182 >>> ExtendedContext.copy_abs(-1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4183 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4184 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4185 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4186 return a.copy_abs()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4187
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4188 def copy_decimal(self, a):
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4189 """Returns a copy of the decimal object.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4190
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4191 >>> ExtendedContext.copy_decimal(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4192 Decimal('2.1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4193 >>> ExtendedContext.copy_decimal(Decimal('-1.00'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4194 Decimal('-1.00')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4195 >>> ExtendedContext.copy_decimal(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4196 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4197 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4198 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4199 return Decimal(a)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4200
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4201 def copy_negate(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4202 """Returns a copy of the operand with the sign inverted.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4203
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4204 >>> ExtendedContext.copy_negate(Decimal('101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4205 Decimal('-101.5')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4206 >>> ExtendedContext.copy_negate(Decimal('-101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4207 Decimal('101.5')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4208 >>> ExtendedContext.copy_negate(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4209 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4210 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4211 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4212 return a.copy_negate()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4213
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4214 def copy_sign(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4215 """Copies the second operand's sign to the first one.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4216
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4217 In detail, it returns a copy of the first operand with the sign
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4218 equal to the sign of the second operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4219
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4220 >>> ExtendedContext.copy_sign(Decimal( '1.50'), Decimal('7.33'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4221 Decimal('1.50')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4222 >>> ExtendedContext.copy_sign(Decimal('-1.50'), Decimal('7.33'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4223 Decimal('1.50')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4224 >>> ExtendedContext.copy_sign(Decimal( '1.50'), Decimal('-7.33'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4225 Decimal('-1.50')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4226 >>> ExtendedContext.copy_sign(Decimal('-1.50'), Decimal('-7.33'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4227 Decimal('-1.50')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4228 >>> ExtendedContext.copy_sign(1, -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4229 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4230 >>> ExtendedContext.copy_sign(Decimal(1), -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4231 Decimal('-1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4232 >>> ExtendedContext.copy_sign(1, Decimal(-2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4233 Decimal('-1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4234 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4235 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4236 return a.copy_sign(b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4237
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4238 def divide(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4239 """Decimal division in a specified context.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4240
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4241 >>> ExtendedContext.divide(Decimal('1'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4242 Decimal('0.333333333')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4243 >>> ExtendedContext.divide(Decimal('2'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4244 Decimal('0.666666667')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4245 >>> ExtendedContext.divide(Decimal('5'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4246 Decimal('2.5')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4247 >>> ExtendedContext.divide(Decimal('1'), Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4248 Decimal('0.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4249 >>> ExtendedContext.divide(Decimal('12'), Decimal('12'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4250 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4251 >>> ExtendedContext.divide(Decimal('8.00'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4252 Decimal('4.00')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4253 >>> ExtendedContext.divide(Decimal('2.400'), Decimal('2.0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4254 Decimal('1.20')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4255 >>> ExtendedContext.divide(Decimal('1000'), Decimal('100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4256 Decimal('10')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4257 >>> ExtendedContext.divide(Decimal('1000'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4258 Decimal('1000')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4259 >>> ExtendedContext.divide(Decimal('2.40E+6'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4260 Decimal('1.20E+6')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4261 >>> ExtendedContext.divide(5, 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4262 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4263 >>> ExtendedContext.divide(Decimal(5), 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4264 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4265 >>> ExtendedContext.divide(5, Decimal(5))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4266 Decimal('1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4267 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4268 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4269 r = a.__truediv__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4270 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4271 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4272 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4273 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4274
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4275 def divide_int(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4276 """Divides two numbers and returns the integer part of the result.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4277
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4278 >>> ExtendedContext.divide_int(Decimal('2'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4279 Decimal('0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4280 >>> ExtendedContext.divide_int(Decimal('10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4281 Decimal('3')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4282 >>> ExtendedContext.divide_int(Decimal('1'), Decimal('0.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4283 Decimal('3')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4284 >>> ExtendedContext.divide_int(10, 3)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4285 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4286 >>> ExtendedContext.divide_int(Decimal(10), 3)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4287 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4288 >>> ExtendedContext.divide_int(10, Decimal(3))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4289 Decimal('3')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4290 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4291 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4292 r = a.__floordiv__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4293 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4294 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4295 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4296 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4297
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4298 def divmod(self, a, b):
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4299 """Return (a // b, a % b).
58171
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4300
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4301 >>> ExtendedContext.divmod(Decimal(8), Decimal(3))
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4302 (Decimal('2'), Decimal('2'))
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4303 >>> ExtendedContext.divmod(Decimal(8), Decimal(4))
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4304 (Decimal('2'), Decimal('0'))
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4305 >>> ExtendedContext.divmod(8, 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4306 (Decimal('2'), Decimal('0'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4307 >>> ExtendedContext.divmod(Decimal(8), 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4308 (Decimal('2'), Decimal('0'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4309 >>> ExtendedContext.divmod(8, Decimal(4))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4310 (Decimal('2'), Decimal('0'))
58171
07a749f066a1 Merged revisions 77326 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 56973
diff changeset
4311 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4312 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4313 r = a.__divmod__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4314 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4315 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4316 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4317 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4318
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4319 def exp(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4320 """Returns e ** a.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4321
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4322 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4323 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4324 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4325 >>> c.exp(Decimal('-Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4326 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4327 >>> c.exp(Decimal('-1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4328 Decimal('0.367879441')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4329 >>> c.exp(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4330 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4331 >>> c.exp(Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4332 Decimal('2.71828183')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4333 >>> c.exp(Decimal('0.693147181'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4334 Decimal('2.00000000')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4335 >>> c.exp(Decimal('+Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4336 Decimal('Infinity')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4337 >>> c.exp(10)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4338 Decimal('22026.4658')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4339 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4340 a =_convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4341 return a.exp(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4342
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4343 def fma(self, a, b, c):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4344 """Returns a multiplied by b, plus c.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4345
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4346 The first two operands are multiplied together, using multiply,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4347 the third operand is then added to the result of that
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4348 multiplication, using add, all with only one final rounding.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4349
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4350 >>> ExtendedContext.fma(Decimal('3'), Decimal('5'), Decimal('7'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4351 Decimal('22')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4352 >>> ExtendedContext.fma(Decimal('3'), Decimal('-5'), Decimal('7'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4353 Decimal('-8')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4354 >>> ExtendedContext.fma(Decimal('888565290'), Decimal('1557.96930'), Decimal('-86087.7578'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4355 Decimal('1.38435736E+12')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4356 >>> ExtendedContext.fma(1, 3, 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4357 Decimal('7')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4358 >>> ExtendedContext.fma(1, Decimal(3), 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4359 Decimal('7')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4360 >>> ExtendedContext.fma(1, 3, Decimal(4))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4361 Decimal('7')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4362 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4363 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4364 return a.fma(b, c, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4365
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4366 def is_canonical(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4367 """Return True if the operand is canonical; otherwise return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4368
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4369 Currently, the encoding of a Decimal instance is always
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4370 canonical, so this method returns True for any Decimal.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4371
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4372 >>> ExtendedContext.is_canonical(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4373 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4374 """
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4375 return a.is_canonical()
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4376
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4377 def is_finite(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4378 """Return True if the operand is finite; otherwise return False.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4379
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4380 A Decimal instance is considered finite if it is neither
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4381 infinite nor a NaN.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4382
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4383 >>> ExtendedContext.is_finite(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4384 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4385 >>> ExtendedContext.is_finite(Decimal('-0.3'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4386 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4387 >>> ExtendedContext.is_finite(Decimal('0'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4388 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4389 >>> ExtendedContext.is_finite(Decimal('Inf'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4390 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4391 >>> ExtendedContext.is_finite(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4392 False
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4393 >>> ExtendedContext.is_finite(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4394 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4395 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4396 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4397 return a.is_finite()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4398
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4399 def is_infinite(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4400 """Return True if the operand is infinite; otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4401
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4402 >>> ExtendedContext.is_infinite(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4403 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4404 >>> ExtendedContext.is_infinite(Decimal('-Inf'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4405 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4406 >>> ExtendedContext.is_infinite(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4407 False
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4408 >>> ExtendedContext.is_infinite(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4409 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4410 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4411 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4412 return a.is_infinite()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4413
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4414 def is_nan(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4415 """Return True if the operand is a qNaN or sNaN;
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4416 otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4417
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4418 >>> ExtendedContext.is_nan(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4419 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4420 >>> ExtendedContext.is_nan(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4421 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4422 >>> ExtendedContext.is_nan(Decimal('-sNaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4423 True
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4424 >>> ExtendedContext.is_nan(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4425 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4426 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4427 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4428 return a.is_nan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4429
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4430 def is_normal(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4431 """Return True if the operand is a normal number;
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4432 otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4433
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4434 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4435 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4436 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4437 >>> c.is_normal(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4438 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4439 >>> c.is_normal(Decimal('0.1E-999'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4440 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4441 >>> c.is_normal(Decimal('0.00'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4442 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4443 >>> c.is_normal(Decimal('-Inf'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4444 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4445 >>> c.is_normal(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4446 False
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4447 >>> c.is_normal(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4448 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4449 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4450 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4451 return a.is_normal(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4452
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4453 def is_qnan(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4454 """Return True if the operand is a quiet NaN; otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4455
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4456 >>> ExtendedContext.is_qnan(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4457 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4458 >>> ExtendedContext.is_qnan(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4459 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4460 >>> ExtendedContext.is_qnan(Decimal('sNaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4461 False
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4462 >>> ExtendedContext.is_qnan(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4463 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4464 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4465 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4466 return a.is_qnan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4467
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4468 def is_signed(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4469 """Return True if the operand is negative; otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4470
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4471 >>> ExtendedContext.is_signed(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4472 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4473 >>> ExtendedContext.is_signed(Decimal('-12'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4474 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4475 >>> ExtendedContext.is_signed(Decimal('-0'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4476 True
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4477 >>> ExtendedContext.is_signed(8)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4478 False
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4479 >>> ExtendedContext.is_signed(-8)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4480 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4481 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4482 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4483 return a.is_signed()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4484
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4485 def is_snan(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4486 """Return True if the operand is a signaling NaN;
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4487 otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4488
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4489 >>> ExtendedContext.is_snan(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4490 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4491 >>> ExtendedContext.is_snan(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4492 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4493 >>> ExtendedContext.is_snan(Decimal('sNaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4494 True
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4495 >>> ExtendedContext.is_snan(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4496 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4497 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4498 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4499 return a.is_snan()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4500
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4501 def is_subnormal(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4502 """Return True if the operand is subnormal; otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4503
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4504 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4505 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4506 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4507 >>> c.is_subnormal(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4508 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4509 >>> c.is_subnormal(Decimal('0.1E-999'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4510 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4511 >>> c.is_subnormal(Decimal('0.00'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4512 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4513 >>> c.is_subnormal(Decimal('-Inf'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4514 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4515 >>> c.is_subnormal(Decimal('NaN'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4516 False
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4517 >>> c.is_subnormal(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4518 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4519 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4520 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4521 return a.is_subnormal(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4522
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4523 def is_zero(self, a):
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4524 """Return True if the operand is a zero; otherwise return False.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4525
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4526 >>> ExtendedContext.is_zero(Decimal('0'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4527 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4528 >>> ExtendedContext.is_zero(Decimal('2.50'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4529 False
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4530 >>> ExtendedContext.is_zero(Decimal('-0E+2'))
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
4531 True
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4532 >>> ExtendedContext.is_zero(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4533 False
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4534 >>> ExtendedContext.is_zero(0)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4535 True
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4536 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4537 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4538 return a.is_zero()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4539
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4540 def ln(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4541 """Returns the natural (base e) logarithm of the operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4542
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4543 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4544 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4545 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4546 >>> c.ln(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4547 Decimal('-Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4548 >>> c.ln(Decimal('1.000'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4549 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4550 >>> c.ln(Decimal('2.71828183'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4551 Decimal('1.00000000')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4552 >>> c.ln(Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4553 Decimal('2.30258509')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4554 >>> c.ln(Decimal('+Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4555 Decimal('Infinity')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4556 >>> c.ln(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4557 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4558 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4559 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4560 return a.ln(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4561
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4562 def log10(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4563 """Returns the base 10 logarithm of the operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4564
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4565 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4566 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4567 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4568 >>> c.log10(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4569 Decimal('-Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4570 >>> c.log10(Decimal('0.001'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4571 Decimal('-3')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4572 >>> c.log10(Decimal('1.000'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4573 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4574 >>> c.log10(Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4575 Decimal('0.301029996')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4576 >>> c.log10(Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4577 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4578 >>> c.log10(Decimal('70'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4579 Decimal('1.84509804')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4580 >>> c.log10(Decimal('+Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4581 Decimal('Infinity')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4582 >>> c.log10(0)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4583 Decimal('-Infinity')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4584 >>> c.log10(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4585 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4586 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4587 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4588 return a.log10(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4589
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4590 def logb(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4591 """ Returns the exponent of the magnitude of the operand's MSD.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4592
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4593 The result is the integer which is the exponent of the magnitude
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4594 of the most significant digit of the operand (as though the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4595 operand were truncated to a single digit while maintaining the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4596 value of that digit and without limiting the resulting exponent).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4597
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4598 >>> ExtendedContext.logb(Decimal('250'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4599 Decimal('2')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4600 >>> ExtendedContext.logb(Decimal('2.50'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4601 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4602 >>> ExtendedContext.logb(Decimal('0.03'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4603 Decimal('-2')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4604 >>> ExtendedContext.logb(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4605 Decimal('-Infinity')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4606 >>> ExtendedContext.logb(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4607 Decimal('0')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4608 >>> ExtendedContext.logb(10)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4609 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4610 >>> ExtendedContext.logb(100)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4611 Decimal('2')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4612 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4613 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4614 return a.logb(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4615
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4616 def logical_and(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4617 """Applies the logical operation 'and' between each operand's digits.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4618
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4619 The operands must be both logical numbers.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4620
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4621 >>> ExtendedContext.logical_and(Decimal('0'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4622 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4623 >>> ExtendedContext.logical_and(Decimal('0'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4624 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4625 >>> ExtendedContext.logical_and(Decimal('1'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4626 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4627 >>> ExtendedContext.logical_and(Decimal('1'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4628 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4629 >>> ExtendedContext.logical_and(Decimal('1100'), Decimal('1010'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4630 Decimal('1000')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4631 >>> ExtendedContext.logical_and(Decimal('1111'), Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4632 Decimal('10')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4633 >>> ExtendedContext.logical_and(110, 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4634 Decimal('100')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4635 >>> ExtendedContext.logical_and(Decimal(110), 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4636 Decimal('100')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4637 >>> ExtendedContext.logical_and(110, Decimal(1101))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4638 Decimal('100')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4639 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4640 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4641 return a.logical_and(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4642
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4643 def logical_invert(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4644 """Invert all the digits in the operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4645
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4646 The operand must be a logical number.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4647
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4648 >>> ExtendedContext.logical_invert(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4649 Decimal('111111111')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4650 >>> ExtendedContext.logical_invert(Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4651 Decimal('111111110')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4652 >>> ExtendedContext.logical_invert(Decimal('111111111'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4653 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4654 >>> ExtendedContext.logical_invert(Decimal('101010101'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4655 Decimal('10101010')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4656 >>> ExtendedContext.logical_invert(1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4657 Decimal('111110010')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4658 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4659 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4660 return a.logical_invert(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4661
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4662 def logical_or(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4663 """Applies the logical operation 'or' between each operand's digits.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4664
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4665 The operands must be both logical numbers.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4666
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4667 >>> ExtendedContext.logical_or(Decimal('0'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4668 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4669 >>> ExtendedContext.logical_or(Decimal('0'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4670 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4671 >>> ExtendedContext.logical_or(Decimal('1'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4672 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4673 >>> ExtendedContext.logical_or(Decimal('1'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4674 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4675 >>> ExtendedContext.logical_or(Decimal('1100'), Decimal('1010'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4676 Decimal('1110')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4677 >>> ExtendedContext.logical_or(Decimal('1110'), Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4678 Decimal('1110')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4679 >>> ExtendedContext.logical_or(110, 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4680 Decimal('1111')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4681 >>> ExtendedContext.logical_or(Decimal(110), 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4682 Decimal('1111')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4683 >>> ExtendedContext.logical_or(110, Decimal(1101))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4684 Decimal('1111')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4685 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4686 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4687 return a.logical_or(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4688
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4689 def logical_xor(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4690 """Applies the logical operation 'xor' between each operand's digits.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4691
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4692 The operands must be both logical numbers.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4693
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4694 >>> ExtendedContext.logical_xor(Decimal('0'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4695 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4696 >>> ExtendedContext.logical_xor(Decimal('0'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4697 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4698 >>> ExtendedContext.logical_xor(Decimal('1'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4699 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4700 >>> ExtendedContext.logical_xor(Decimal('1'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4701 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4702 >>> ExtendedContext.logical_xor(Decimal('1100'), Decimal('1010'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4703 Decimal('110')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4704 >>> ExtendedContext.logical_xor(Decimal('1111'), Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4705 Decimal('1101')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4706 >>> ExtendedContext.logical_xor(110, 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4707 Decimal('1011')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4708 >>> ExtendedContext.logical_xor(Decimal(110), 1101)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4709 Decimal('1011')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4710 >>> ExtendedContext.logical_xor(110, Decimal(1101))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4711 Decimal('1011')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4712 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4713 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4714 return a.logical_xor(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4715
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4716 def max(self, a, b):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4717 """max compares two values numerically and returns the maximum.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4718
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4719 If either operand is a NaN then the general rules apply.
44742
14d4104976fc Merged revisions 59985-60000,60002,60005-60007,60009-60042 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44654
diff changeset
4720 Otherwise, the operands are compared as though by the compare
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4721 operation. If they are numerically equal then the left-hand operand
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4722 is chosen as the result. Otherwise the maximum (closer to positive
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4723 infinity) of the two operands is chosen as the result.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4724
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4725 >>> ExtendedContext.max(Decimal('3'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4726 Decimal('3')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4727 >>> ExtendedContext.max(Decimal('-10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4728 Decimal('3')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4729 >>> ExtendedContext.max(Decimal('1.0'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4730 Decimal('1')
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
4731 >>> ExtendedContext.max(Decimal('7'), Decimal('NaN'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4732 Decimal('7')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4733 >>> ExtendedContext.max(1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4734 Decimal('2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4735 >>> ExtendedContext.max(Decimal(1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4736 Decimal('2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4737 >>> ExtendedContext.max(1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4738 Decimal('2')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4739 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4740 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4741 return a.max(b, context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4742
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4743 def max_mag(self, a, b):
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4744 """Compares the values numerically with their sign ignored.
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4745
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4746 >>> ExtendedContext.max_mag(Decimal('7'), Decimal('NaN'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4747 Decimal('7')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4748 >>> ExtendedContext.max_mag(Decimal('7'), Decimal('-10'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4749 Decimal('-10')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4750 >>> ExtendedContext.max_mag(1, -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4751 Decimal('-2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4752 >>> ExtendedContext.max_mag(Decimal(1), -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4753 Decimal('-2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4754 >>> ExtendedContext.max_mag(1, Decimal(-2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4755 Decimal('-2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4756 """
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4757 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4758 return a.max_mag(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4759
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4760 def min(self, a, b):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4761 """min compares two values numerically and returns the minimum.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4762
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4763 If either operand is a NaN then the general rules apply.
44742
14d4104976fc Merged revisions 59985-60000,60002,60005-60007,60009-60042 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44654
diff changeset
4764 Otherwise, the operands are compared as though by the compare
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4765 operation. If they are numerically equal then the left-hand operand
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
4766 is chosen as the result. Otherwise the minimum (closer to negative
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4767 infinity) of the two operands is chosen as the result.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4768
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4769 >>> ExtendedContext.min(Decimal('3'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4770 Decimal('2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4771 >>> ExtendedContext.min(Decimal('-10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4772 Decimal('-10')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4773 >>> ExtendedContext.min(Decimal('1.0'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4774 Decimal('1.0')
33157
b2f427db228b Revise max() and min() to comply with the 8/2/2004 update to the specification
Raymond Hettinger <python@rcn.com>
parents: 33044
diff changeset
4775 >>> ExtendedContext.min(Decimal('7'), Decimal('NaN'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4776 Decimal('7')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4777 >>> ExtendedContext.min(1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4778 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4779 >>> ExtendedContext.min(Decimal(1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4780 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4781 >>> ExtendedContext.min(1, Decimal(29))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4782 Decimal('1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4783 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4784 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4785 return a.min(b, context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4786
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4787 def min_mag(self, a, b):
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4788 """Compares the values numerically with their sign ignored.
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4789
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4790 >>> ExtendedContext.min_mag(Decimal('3'), Decimal('-2'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4791 Decimal('-2')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4792 >>> ExtendedContext.min_mag(Decimal('-3'), Decimal('NaN'))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4793 Decimal('-3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4794 >>> ExtendedContext.min_mag(1, -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4795 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4796 >>> ExtendedContext.min_mag(Decimal(1), -2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4797 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4798 >>> ExtendedContext.min_mag(1, Decimal(-2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4799 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4800 """
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4801 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4802 return a.min_mag(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4803
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4804 def minus(self, a):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4805 """Minus corresponds to unary prefix minus in Python.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4806
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4807 The operation is evaluated using the same rules as subtract; the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4808 operation minus(a) is calculated as subtract('0', a) where the '0'
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4809 has the same exponent as the operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4810
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4811 >>> ExtendedContext.minus(Decimal('1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4812 Decimal('-1.3')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4813 >>> ExtendedContext.minus(Decimal('-1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4814 Decimal('1.3')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4815 >>> ExtendedContext.minus(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4816 Decimal('-1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4817 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4818 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4819 return a.__neg__(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4820
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4821 def multiply(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4822 """multiply multiplies two operands.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4823
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4824 If either operand is a special value then the general rules apply.
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4825 Otherwise, the operands are multiplied together
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4826 ('long multiplication'), resulting in a number which may be as long as
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4827 the sum of the lengths of the two operands.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4828
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4829 >>> ExtendedContext.multiply(Decimal('1.20'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4830 Decimal('3.60')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4831 >>> ExtendedContext.multiply(Decimal('7'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4832 Decimal('21')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4833 >>> ExtendedContext.multiply(Decimal('0.9'), Decimal('0.8'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4834 Decimal('0.72')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4835 >>> ExtendedContext.multiply(Decimal('0.9'), Decimal('-0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4836 Decimal('-0.0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4837 >>> ExtendedContext.multiply(Decimal('654321'), Decimal('654321'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4838 Decimal('4.28135971E+11')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4839 >>> ExtendedContext.multiply(7, 7)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4840 Decimal('49')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4841 >>> ExtendedContext.multiply(Decimal(7), 7)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4842 Decimal('49')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4843 >>> ExtendedContext.multiply(7, Decimal(7))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4844 Decimal('49')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4845 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4846 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4847 r = a.__mul__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4848 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4849 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4850 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4851 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4852
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4853 def next_minus(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4854 """Returns the largest representable number smaller than a.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4855
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4856 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4857 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4858 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4859 >>> ExtendedContext.next_minus(Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4860 Decimal('0.999999999')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4861 >>> c.next_minus(Decimal('1E-1007'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4862 Decimal('0E-1007')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4863 >>> ExtendedContext.next_minus(Decimal('-1.00000003'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4864 Decimal('-1.00000004')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4865 >>> c.next_minus(Decimal('Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4866 Decimal('9.99999999E+999')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4867 >>> c.next_minus(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4868 Decimal('0.999999999')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4869 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4870 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4871 return a.next_minus(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4872
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4873 def next_plus(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4874 """Returns the smallest representable number larger than a.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4875
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4876 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4877 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4878 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4879 >>> ExtendedContext.next_plus(Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4880 Decimal('1.00000001')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4881 >>> c.next_plus(Decimal('-1E-1007'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4882 Decimal('-0E-1007')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4883 >>> ExtendedContext.next_plus(Decimal('-1.00000003'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4884 Decimal('-1.00000002')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4885 >>> c.next_plus(Decimal('-Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4886 Decimal('-9.99999999E+999')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4887 >>> c.next_plus(1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4888 Decimal('1.00000001')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4889 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4890 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4891 return a.next_plus(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4892
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4893 def next_toward(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4894 """Returns the number closest to a, in direction towards b.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4895
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4896 The result is the closest representable number from the first
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4897 operand (but not the first operand) that is in the direction
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4898 towards the second operand, unless the operands have the same
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4899 value.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4900
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4901 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4902 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4903 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4904 >>> c.next_toward(Decimal('1'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4905 Decimal('1.00000001')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4906 >>> c.next_toward(Decimal('-1E-1007'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4907 Decimal('-0E-1007')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4908 >>> c.next_toward(Decimal('-1.00000003'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4909 Decimal('-1.00000002')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4910 >>> c.next_toward(Decimal('1'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4911 Decimal('0.999999999')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4912 >>> c.next_toward(Decimal('1E-1007'), Decimal('-100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4913 Decimal('0E-1007')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4914 >>> c.next_toward(Decimal('-1.00000003'), Decimal('-10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4915 Decimal('-1.00000004')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4916 >>> c.next_toward(Decimal('0.00'), Decimal('-0.0000'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4917 Decimal('-0.00')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4918 >>> c.next_toward(0, 1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4919 Decimal('1E-1007')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4920 >>> c.next_toward(Decimal(0), 1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4921 Decimal('1E-1007')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4922 >>> c.next_toward(0, Decimal(1))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4923 Decimal('1E-1007')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4924 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4925 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4926 return a.next_toward(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4927
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4928 def normalize(self, a):
32496
9c87518faf6b * Fixup docstrings
Raymond Hettinger <python@rcn.com>
parents: 32489
diff changeset
4929 """normalize reduces an operand to its simplest form.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4930
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4931 Essentially a plus operation with all trailing zeros removed from the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4932 result.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4933
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4934 >>> ExtendedContext.normalize(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4935 Decimal('2.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4936 >>> ExtendedContext.normalize(Decimal('-2.0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4937 Decimal('-2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4938 >>> ExtendedContext.normalize(Decimal('1.200'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4939 Decimal('1.2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4940 >>> ExtendedContext.normalize(Decimal('-120'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4941 Decimal('-1.2E+2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4942 >>> ExtendedContext.normalize(Decimal('120.00'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4943 Decimal('1.2E+2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
4944 >>> ExtendedContext.normalize(Decimal('0.00'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
4945 Decimal('0')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4946 >>> ExtendedContext.normalize(6)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4947 Decimal('6')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4948 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4949 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4950 return a.normalize(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
4951
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4952 def number_class(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4953 """Returns an indication of the class of the operand.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4954
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4955 The class is one of the following strings:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4956 -sNaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4957 -NaN
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4958 -Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4959 -Normal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4960 -Subnormal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4961 -Zero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4962 +Zero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4963 +Subnormal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4964 +Normal
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4965 +Infinity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4966
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4967 >>> c = Context(ExtendedContext)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4968 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4969 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4970 >>> c.number_class(Decimal('Infinity'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4971 '+Infinity'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4972 >>> c.number_class(Decimal('1E-10'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4973 '+Normal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4974 >>> c.number_class(Decimal('2.50'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4975 '+Normal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4976 >>> c.number_class(Decimal('0.1E-999'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4977 '+Subnormal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4978 >>> c.number_class(Decimal('0'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4979 '+Zero'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4980 >>> c.number_class(Decimal('-0'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4981 '-Zero'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4982 >>> c.number_class(Decimal('-0.1E-999'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4983 '-Subnormal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4984 >>> c.number_class(Decimal('-1E-10'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4985 '-Normal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4986 >>> c.number_class(Decimal('-2.50'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4987 '-Normal'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4988 >>> c.number_class(Decimal('-Infinity'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4989 '-Infinity'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4990 >>> c.number_class(Decimal('NaN'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4991 'NaN'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4992 >>> c.number_class(Decimal('-NaN'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4993 'NaN'
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4994 >>> c.number_class(Decimal('sNaN'))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4995 'sNaN'
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4996 >>> c.number_class(123)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4997 '+Normal'
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
4998 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
4999 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5000 return a.number_class(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5001
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5002 def plus(self, a):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5003 """Plus corresponds to unary prefix plus in Python.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5004
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5005 The operation is evaluated using the same rules as add; the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5006 operation plus(a) is calculated as add('0', a) where the '0'
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5007 has the same exponent as the operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5008
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5009 >>> ExtendedContext.plus(Decimal('1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5010 Decimal('1.3')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5011 >>> ExtendedContext.plus(Decimal('-1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5012 Decimal('-1.3')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5013 >>> ExtendedContext.plus(-1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5014 Decimal('-1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5015 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5016 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5017 return a.__pos__(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5018
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5019 def power(self, a, b, modulo=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5020 """Raises a to the power of b, to modulo if given.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5021
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5022 With two arguments, compute a**b. If a is negative then b
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5023 must be integral. The result will be inexact unless b is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5024 integral and the result is finite and can be expressed exactly
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5025 in 'precision' digits.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5026
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5027 With three arguments, compute (a**b) % modulo. For the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5028 three argument form, the following restrictions on the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5029 arguments hold:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5030
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5031 - all three arguments must be integral
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5032 - b must be nonnegative
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5033 - at least one of a or b must be nonzero
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5034 - modulo must be nonzero and have at most 'precision' digits
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5035
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5036 The result of pow(a, b, modulo) is identical to the result
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5037 that would be obtained by computing (a**b) % modulo with
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5038 unbounded precision, but is computed more efficiently. It is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5039 always exact.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5040
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5041 >>> c = ExtendedContext.copy()
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5042 >>> c.Emin = -999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5043 >>> c.Emax = 999
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5044 >>> c.power(Decimal('2'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5045 Decimal('8')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5046 >>> c.power(Decimal('-2'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5047 Decimal('-8')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5048 >>> c.power(Decimal('2'), Decimal('-3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5049 Decimal('0.125')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5050 >>> c.power(Decimal('1.7'), Decimal('8'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5051 Decimal('69.7575744')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5052 >>> c.power(Decimal('10'), Decimal('0.301029996'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5053 Decimal('2.00000000')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5054 >>> c.power(Decimal('Infinity'), Decimal('-1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5055 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5056 >>> c.power(Decimal('Infinity'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5057 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5058 >>> c.power(Decimal('Infinity'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5059 Decimal('Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5060 >>> c.power(Decimal('-Infinity'), Decimal('-1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5061 Decimal('-0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5062 >>> c.power(Decimal('-Infinity'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5063 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5064 >>> c.power(Decimal('-Infinity'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5065 Decimal('-Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5066 >>> c.power(Decimal('-Infinity'), Decimal('2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5067 Decimal('Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5068 >>> c.power(Decimal('0'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5069 Decimal('NaN')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5070
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5071 >>> c.power(Decimal('3'), Decimal('7'), Decimal('16'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5072 Decimal('11')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5073 >>> c.power(Decimal('-3'), Decimal('7'), Decimal('16'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5074 Decimal('-11')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5075 >>> c.power(Decimal('-3'), Decimal('8'), Decimal('16'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5076 Decimal('1')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5077 >>> c.power(Decimal('3'), Decimal('7'), Decimal('-16'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5078 Decimal('11')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5079 >>> c.power(Decimal('23E12345'), Decimal('67E189'), Decimal('123456789'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5080 Decimal('11729830')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5081 >>> c.power(Decimal('-0'), Decimal('17'), Decimal('1729'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5082 Decimal('-0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5083 >>> c.power(Decimal('-23'), Decimal('0'), Decimal('65537'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5084 Decimal('1')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5085 >>> ExtendedContext.power(7, 7)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5086 Decimal('823543')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5087 >>> ExtendedContext.power(Decimal(7), 7)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5088 Decimal('823543')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5089 >>> ExtendedContext.power(7, Decimal(7), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5090 Decimal('1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5091 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5092 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5093 r = a.__pow__(b, modulo, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5094 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5095 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5096 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5097 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5098
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5099 def quantize(self, a, b):
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5100 """Returns a value equal to 'a' (rounded), having the exponent of 'b'.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5101
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5102 The coefficient of the result is derived from that of the left-hand
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5103 operand. It may be rounded using the current rounding setting (if the
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5104 exponent is being increased), multiplied by a positive power of ten (if
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5105 the exponent is being decreased), or is unchanged (if the exponent is
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5106 already equal to that of the right-hand operand).
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5107
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5108 Unlike other operations, if the length of the coefficient after the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5109 quantize operation would be greater than precision then an Invalid
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5110 operation condition is raised. This guarantees that, unless there is
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5111 an error condition, the exponent of the result of a quantize is always
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5112 equal to that of the right-hand operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5113
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5114 Also unlike other operations, quantize will never raise Underflow, even
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5115 if the result is subnormal and inexact.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5116
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5117 >>> ExtendedContext.quantize(Decimal('2.17'), Decimal('0.001'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5118 Decimal('2.170')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5119 >>> ExtendedContext.quantize(Decimal('2.17'), Decimal('0.01'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5120 Decimal('2.17')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5121 >>> ExtendedContext.quantize(Decimal('2.17'), Decimal('0.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5122 Decimal('2.2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5123 >>> ExtendedContext.quantize(Decimal('2.17'), Decimal('1e+0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5124 Decimal('2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5125 >>> ExtendedContext.quantize(Decimal('2.17'), Decimal('1e+1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5126 Decimal('0E+1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5127 >>> ExtendedContext.quantize(Decimal('-Inf'), Decimal('Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5128 Decimal('-Infinity')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5129 >>> ExtendedContext.quantize(Decimal('2'), Decimal('Infinity'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5130 Decimal('NaN')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5131 >>> ExtendedContext.quantize(Decimal('-0.1'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5132 Decimal('-0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5133 >>> ExtendedContext.quantize(Decimal('-0'), Decimal('1e+5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5134 Decimal('-0E+5')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5135 >>> ExtendedContext.quantize(Decimal('+35236450.6'), Decimal('1e-2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5136 Decimal('NaN')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5137 >>> ExtendedContext.quantize(Decimal('-35236450.6'), Decimal('1e-2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5138 Decimal('NaN')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5139 >>> ExtendedContext.quantize(Decimal('217'), Decimal('1e-1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5140 Decimal('217.0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5141 >>> ExtendedContext.quantize(Decimal('217'), Decimal('1e-0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5142 Decimal('217')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5143 >>> ExtendedContext.quantize(Decimal('217'), Decimal('1e+1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5144 Decimal('2.2E+2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5145 >>> ExtendedContext.quantize(Decimal('217'), Decimal('1e+2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5146 Decimal('2E+2')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5147 >>> ExtendedContext.quantize(1, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5148 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5149 >>> ExtendedContext.quantize(Decimal(1), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5150 Decimal('1')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5151 >>> ExtendedContext.quantize(1, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5152 Decimal('1')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5153 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5154 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5155 return a.quantize(b, context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5156
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5157 def radix(self):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5158 """Just returns 10, as this is Decimal, :)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5159
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5160 >>> ExtendedContext.radix()
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5161 Decimal('10')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5162 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5163 return Decimal(10)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5164
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5165 def remainder(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5166 """Returns the remainder from integer division.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5167
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5168 The result is the residue of the dividend after the operation of
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5169 calculating integer division as described for divide-integer, rounded
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5170 to precision digits if necessary. The sign of the result, if
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5171 non-zero, is the same as that of the original dividend.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5172
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5173 This operation will fail under the same conditions as integer division
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5174 (that is, if integer division on the same two operands would fail, the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5175 remainder cannot be calculated).
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5176
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5177 >>> ExtendedContext.remainder(Decimal('2.1'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5178 Decimal('2.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5179 >>> ExtendedContext.remainder(Decimal('10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5180 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5181 >>> ExtendedContext.remainder(Decimal('-10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5182 Decimal('-1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5183 >>> ExtendedContext.remainder(Decimal('10.2'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5184 Decimal('0.2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5185 >>> ExtendedContext.remainder(Decimal('10'), Decimal('0.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5186 Decimal('0.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5187 >>> ExtendedContext.remainder(Decimal('3.6'), Decimal('1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5188 Decimal('1.0')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5189 >>> ExtendedContext.remainder(22, 6)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5190 Decimal('4')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5191 >>> ExtendedContext.remainder(Decimal(22), 6)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5192 Decimal('4')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5193 >>> ExtendedContext.remainder(22, Decimal(6))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5194 Decimal('4')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5195 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5196 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5197 r = a.__mod__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5198 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5199 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5200 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5201 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5202
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5203 def remainder_near(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5204 """Returns to be "a - b * n", where n is the integer nearest the exact
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5205 value of "x / b" (if two integers are equally near then the even one
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5206 is chosen). If the result is equal to 0 then its sign will be the
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5207 sign of a.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5208
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5209 This operation will fail under the same conditions as integer division
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5210 (that is, if integer division on the same two operands would fail, the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5211 remainder cannot be calculated).
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5212
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5213 >>> ExtendedContext.remainder_near(Decimal('2.1'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5214 Decimal('-0.9')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5215 >>> ExtendedContext.remainder_near(Decimal('10'), Decimal('6'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5216 Decimal('-2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5217 >>> ExtendedContext.remainder_near(Decimal('10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5218 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5219 >>> ExtendedContext.remainder_near(Decimal('-10'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5220 Decimal('-1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5221 >>> ExtendedContext.remainder_near(Decimal('10.2'), Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5222 Decimal('0.2')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5223 >>> ExtendedContext.remainder_near(Decimal('10'), Decimal('0.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5224 Decimal('0.1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5225 >>> ExtendedContext.remainder_near(Decimal('3.6'), Decimal('1.3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5226 Decimal('-0.3')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5227 >>> ExtendedContext.remainder_near(3, 11)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5228 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5229 >>> ExtendedContext.remainder_near(Decimal(3), 11)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5230 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5231 >>> ExtendedContext.remainder_near(3, Decimal(11))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5232 Decimal('3')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5233 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5234 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5235 return a.remainder_near(b, context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5236
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5237 def rotate(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5238 """Returns a rotated copy of a, b times.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5239
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5240 The coefficient of the result is a rotated copy of the digits in
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5241 the coefficient of the first operand. The number of places of
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5242 rotation is taken from the absolute value of the second operand,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5243 with the rotation being to the left if the second operand is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5244 positive or to the right otherwise.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5245
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5246 >>> ExtendedContext.rotate(Decimal('34'), Decimal('8'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5247 Decimal('400000003')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5248 >>> ExtendedContext.rotate(Decimal('12'), Decimal('9'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5249 Decimal('12')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5250 >>> ExtendedContext.rotate(Decimal('123456789'), Decimal('-2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5251 Decimal('891234567')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5252 >>> ExtendedContext.rotate(Decimal('123456789'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5253 Decimal('123456789')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5254 >>> ExtendedContext.rotate(Decimal('123456789'), Decimal('+2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5255 Decimal('345678912')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5256 >>> ExtendedContext.rotate(1333333, 1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5257 Decimal('13333330')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5258 >>> ExtendedContext.rotate(Decimal(1333333), 1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5259 Decimal('13333330')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5260 >>> ExtendedContext.rotate(1333333, Decimal(1))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5261 Decimal('13333330')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5262 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5263 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5264 return a.rotate(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5265
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5266 def same_quantum(self, a, b):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5267 """Returns True if the two operands have the same exponent.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5268
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5269 The result is never affected by either the sign or the coefficient of
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5270 either operand.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5271
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5272 >>> ExtendedContext.same_quantum(Decimal('2.17'), Decimal('0.001'))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5273 False
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5274 >>> ExtendedContext.same_quantum(Decimal('2.17'), Decimal('0.01'))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5275 True
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5276 >>> ExtendedContext.same_quantum(Decimal('2.17'), Decimal('1'))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5277 False
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5278 >>> ExtendedContext.same_quantum(Decimal('Inf'), Decimal('-Inf'))
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5279 True
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5280 >>> ExtendedContext.same_quantum(10000, -1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5281 True
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5282 >>> ExtendedContext.same_quantum(Decimal(10000), -1)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5283 True
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5284 >>> ExtendedContext.same_quantum(10000, Decimal(-1))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5285 True
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5286 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5287 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5288 return a.same_quantum(b)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5289
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5290 def scaleb (self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5291 """Returns the first operand after adding the second value its exp.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5292
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5293 >>> ExtendedContext.scaleb(Decimal('7.50'), Decimal('-2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5294 Decimal('0.0750')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5295 >>> ExtendedContext.scaleb(Decimal('7.50'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5296 Decimal('7.50')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5297 >>> ExtendedContext.scaleb(Decimal('7.50'), Decimal('3'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5298 Decimal('7.50E+3')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5299 >>> ExtendedContext.scaleb(1, 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5300 Decimal('1E+4')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5301 >>> ExtendedContext.scaleb(Decimal(1), 4)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5302 Decimal('1E+4')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5303 >>> ExtendedContext.scaleb(1, Decimal(4))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5304 Decimal('1E+4')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5305 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5306 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5307 return a.scaleb(b, context=self)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5308
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5309 def shift(self, a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5310 """Returns a shifted copy of a, b times.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5311
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5312 The coefficient of the result is a shifted copy of the digits
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5313 in the coefficient of the first operand. The number of places
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5314 to shift is taken from the absolute value of the second operand,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5315 with the shift being to the left if the second operand is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5316 positive or to the right otherwise. Digits shifted into the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5317 coefficient are zeros.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5318
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5319 >>> ExtendedContext.shift(Decimal('34'), Decimal('8'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5320 Decimal('400000000')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5321 >>> ExtendedContext.shift(Decimal('12'), Decimal('9'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5322 Decimal('0')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5323 >>> ExtendedContext.shift(Decimal('123456789'), Decimal('-2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5324 Decimal('1234567')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5325 >>> ExtendedContext.shift(Decimal('123456789'), Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5326 Decimal('123456789')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5327 >>> ExtendedContext.shift(Decimal('123456789'), Decimal('+2'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5328 Decimal('345678900')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5329 >>> ExtendedContext.shift(88888888, 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5330 Decimal('888888800')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5331 >>> ExtendedContext.shift(Decimal(88888888), 2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5332 Decimal('888888800')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5333 >>> ExtendedContext.shift(88888888, Decimal(2))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5334 Decimal('888888800')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5335 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5336 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5337 return a.shift(b, context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5338
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5339 def sqrt(self, a):
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5340 """Square root of a non-negative number to context precision.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5341
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5342 If the result must be inexact, it is rounded using the round-half-even
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5343 algorithm.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5344
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5345 >>> ExtendedContext.sqrt(Decimal('0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5346 Decimal('0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5347 >>> ExtendedContext.sqrt(Decimal('-0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5348 Decimal('-0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5349 >>> ExtendedContext.sqrt(Decimal('0.39'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5350 Decimal('0.624499800')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5351 >>> ExtendedContext.sqrt(Decimal('100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5352 Decimal('10')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5353 >>> ExtendedContext.sqrt(Decimal('1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5354 Decimal('1')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5355 >>> ExtendedContext.sqrt(Decimal('1.0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5356 Decimal('1.0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5357 >>> ExtendedContext.sqrt(Decimal('1.00'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5358 Decimal('1.0')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5359 >>> ExtendedContext.sqrt(Decimal('7'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5360 Decimal('2.64575131')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5361 >>> ExtendedContext.sqrt(Decimal('10'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5362 Decimal('3.16227766')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5363 >>> ExtendedContext.sqrt(2)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5364 Decimal('1.41421356')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5365 >>> ExtendedContext.prec
32481
b835d5c61d86 * Make the tests independent of the default precision.
Raymond Hettinger <python@rcn.com>
parents: 32477
diff changeset
5366 9
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5367 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5368 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5369 return a.sqrt(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5370
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5371 def subtract(self, a, b):
35379
43211be0de41 bug [ 1266296 ] Mistakes in decimal.Context.subtract documentation
Georg Brandl <georg@python.org>
parents: 35113
diff changeset
5372 """Return the difference between the two operands.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5373
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5374 >>> ExtendedContext.subtract(Decimal('1.3'), Decimal('1.07'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5375 Decimal('0.23')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5376 >>> ExtendedContext.subtract(Decimal('1.3'), Decimal('1.30'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5377 Decimal('0.00')
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5378 >>> ExtendedContext.subtract(Decimal('1.3'), Decimal('2.07'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5379 Decimal('-0.77')
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5380 >>> ExtendedContext.subtract(8, 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5381 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5382 >>> ExtendedContext.subtract(Decimal(8), 5)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5383 Decimal('3')
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5384 >>> ExtendedContext.subtract(8, Decimal(5))
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5385 Decimal('3')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5386 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5387 a = _convert_other(a, raiseit=True)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5388 r = a.__sub__(b, context=self)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5389 if r is NotImplemented:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5390 raise TypeError("Unable to convert %s to Decimal" % b)
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5391 else:
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5392 return r
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5393
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5394 def to_eng_string(self, a):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5395 """Converts a number to a string, using scientific notation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5396
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5397 The operation is not affected by the context.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5398 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5399 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5400 return a.to_eng_string(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5401
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5402 def to_sci_string(self, a):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5403 """Converts a number to a string, using scientific notation.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5404
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5405 The operation is not affected by the context.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5406 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5407 a = _convert_other(a, raiseit=True)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5408 return a.__str__(context=self)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5409
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5410 def to_integral_exact(self, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5411 """Rounds to an integer.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5412
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5413 When the operand has a negative exponent, the result is the same
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5414 as using the quantize() operation using the given operand as the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5415 left-hand-operand, 1E+0 as the right-hand-operand, and the precision
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5416 of the operand as the precision setting; Inexact and Rounded flags
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5417 are allowed in this operation. The rounding mode is taken from the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5418 context.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5419
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5420 >>> ExtendedContext.to_integral_exact(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5421 Decimal('2')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5422 >>> ExtendedContext.to_integral_exact(Decimal('100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5423 Decimal('100')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5424 >>> ExtendedContext.to_integral_exact(Decimal('100.0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5425 Decimal('100')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5426 >>> ExtendedContext.to_integral_exact(Decimal('101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5427 Decimal('102')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5428 >>> ExtendedContext.to_integral_exact(Decimal('-101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5429 Decimal('-102')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5430 >>> ExtendedContext.to_integral_exact(Decimal('10E+5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5431 Decimal('1.0E+6')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5432 >>> ExtendedContext.to_integral_exact(Decimal('7.89E+77'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5433 Decimal('7.89E+77')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5434 >>> ExtendedContext.to_integral_exact(Decimal('-Inf'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5435 Decimal('-Infinity')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5436 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5437 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5438 return a.to_integral_exact(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5439
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5440 def to_integral_value(self, a):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5441 """Rounds to an integer.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5442
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5443 When the operand has a negative exponent, the result is the same
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5444 as using the quantize() operation using the given operand as the
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5445 left-hand-operand, 1E+0 as the right-hand-operand, and the precision
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5446 of the operand as the precision setting, except that no flags will
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5447 be set. The rounding mode is taken from the context.
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5448
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5449 >>> ExtendedContext.to_integral_value(Decimal('2.1'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5450 Decimal('2')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5451 >>> ExtendedContext.to_integral_value(Decimal('100'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5452 Decimal('100')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5453 >>> ExtendedContext.to_integral_value(Decimal('100.0'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5454 Decimal('100')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5455 >>> ExtendedContext.to_integral_value(Decimal('101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5456 Decimal('102')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5457 >>> ExtendedContext.to_integral_value(Decimal('-101.5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5458 Decimal('-102')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5459 >>> ExtendedContext.to_integral_value(Decimal('10E+5'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5460 Decimal('1.0E+6')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5461 >>> ExtendedContext.to_integral_value(Decimal('7.89E+77'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5462 Decimal('7.89E+77')
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5463 >>> ExtendedContext.to_integral_value(Decimal('-Inf'))
45333
e70f56cf6972 Merged revisions 60481,60485,60489-60492,60494-60496,60498-60499,60501-60503,60505-60506,60508-60509,60523-60524,60532,60543,60545,60547-60548,60552,60554,60556-60559,60561-60562,60569,60571-60572,60574,60576-60583,60585-60586,60589,60591,60594-60595,60597-60598,60600-60601,60606-60612,60615,60617,60619-60621,60623-60625,60627-60629,60631,60633,60635,60647,60650,60652,60654,60656,60658-60659,60664-60666,60668-60670,60672,60676,60678,60680-60683,60685-60686,60688,60690,60692-60694,60697-60700,60705-60706,60708,60711,60714,60720,60724-60730,60732,60736,60742,60744,60746,60748,60750-60766,60769-60786 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45307
diff changeset
5464 Decimal('-Infinity')
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5465 """
58936
f225d5e6e0e5 Merged revisions 78217-78218 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 58668
diff changeset
5466 a = _convert_other(a, raiseit=True)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5467 return a.to_integral_value(context=self)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5468
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5469 # the method name changed, but we provide also the old one, for compatibility
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5470 to_integral = to_integral_value
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5471
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5472 class _WorkRep(object):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5473 __slots__ = ('sign','int','exp')
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
5474 # sign: 0 or 1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5475 # int: int
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5476 # exp: None, int, or string
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5477
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5478 def __init__(self, value=None):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5479 if value is None:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5480 self.sign = None
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5481 self.int = 0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5482 self.exp = None
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
5483 elif isinstance(value, Decimal):
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
5484 self.sign = value._sign
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5485 self.int = int(value._int)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5486 self.exp = value._exp
33851
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
5487 else:
2ee0301b483c SF patch #1053375.
Raymond Hettinger <python@rcn.com>
parents: 33845
diff changeset
5488 # assert isinstance(value, tuple)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5489 self.sign = value[0]
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5490 self.int = value[1]
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5491 self.exp = value[2]
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5492
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5493 def __repr__(self):
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5494 return "(%r, %r, %r)" % (self.sign, self.int, self.exp)
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5495
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5496 __str__ = __repr__
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5497
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5498
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5499
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5500 def _normalize(op1, op2, prec = 0):
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5501 """Normalizes op1, op2 to have the same exp and length of coefficient.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5502
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5503 Done during addition.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5504 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5505 if op1.exp < op2.exp:
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5506 tmp = op2
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5507 other = op1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5508 else:
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5509 tmp = op1
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5510 other = op2
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5511
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5512 # Let exp = min(tmp.exp - 1, tmp.adjusted() - precision - 1).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5513 # Then adding 10**exp to tmp has the same effect (after rounding)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5514 # as adding any positive quantity smaller than 10**exp; similarly
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5515 # for subtraction. So if other is smaller than 10**exp we replace
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5516 # it with 10**exp. This avoids tmp.exp - other.exp getting too large.
44329
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5517 tmp_len = len(str(tmp.int))
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5518 other_len = len(str(other.int))
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5519 exp = tmp.exp + min(-1, tmp_len - prec - 2)
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5520 if other_len + other.exp - 1 < exp:
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5521 other.int = 1
75c6bfd3b1f3 Merged revisions 59512-59540 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44256
diff changeset
5522 other.exp = exp
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5523
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5524 tmp.int *= 10 ** (tmp.exp - other.exp)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5525 tmp.exp = other.exp
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5526 return op1, op2
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5527
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5528 ##### Integer arithmetic functions used by ln, log10, exp and __pow__ #####
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5529
66506
fee98b604139 Replace _nbits() with int.bit_length().
Raymond Hettinger <python@rcn.com>
parents: 66444
diff changeset
5530 _nbits = int.bit_length
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5531
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5532 def _sqrt_nearest(n, a):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5533 """Closest integer to the square root of the positive integer n. a is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5534 an initial approximation to the square root. Any positive integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5535 will do for a, but the closer a is to the square root of n the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5536 faster convergence will be.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5537
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5538 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5539 if n <= 0 or a <= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5540 raise ValueError("Both arguments to _sqrt_nearest should be positive.")
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5541
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5542 b=0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5543 while a != b:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5544 b, a = a, a--n//a>>1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5545 return a
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5546
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5547 def _rshift_nearest(x, shift):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5548 """Given an integer x and a nonnegative integer shift, return closest
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5549 integer to x / 2**shift; use round-to-even in case of a tie.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5550
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5551 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5552 b, q = 1 << shift, x >> shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5553 return q + (2*(x & (b-1)) + (q&1) > b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5554
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5555 def _div_nearest(a, b):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5556 """Closest integer to a/b, a and b positive integers; rounds to even
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5557 in the case of a tie.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5558
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5559 """
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5560 q, r = divmod(a, b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5561 return q + (2*r + (q&1) > b)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5562
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5563 def _ilog(x, M, L = 8):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5564 """Integer approximation to M*log(x/M), with absolute error boundable
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5565 in terms only of x/M.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5566
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5567 Given positive integers x and M, return an integer approximation to
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5568 M * log(x/M). For L = 8 and 0.1 <= x/M <= 10 the difference
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5569 between the approximation and the exact result is at most 22. For
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5570 L = 8 and 1.0 <= x/M <= 10.0 the difference is at most 15. In
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5571 both cases these are upper bounds on the error; it will usually be
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5572 much smaller."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5573
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5574 # The basic algorithm is the following: let log1p be the function
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5575 # log1p(x) = log(1+x). Then log(x/M) = log1p((x-M)/M). We use
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5576 # the reduction
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5577 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5578 # log1p(y) = 2*log1p(y/(1+sqrt(1+y)))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5579 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5580 # repeatedly until the argument to log1p is small (< 2**-L in
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5581 # absolute value). For small y we can use the Taylor series
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5582 # expansion
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5583 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5584 # log1p(y) ~ y - y**2/2 + y**3/3 - ... - (-y)**T/T
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5585 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5586 # truncating at T such that y**T is small enough. The whole
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5587 # computation is carried out in a form of fixed-point arithmetic,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5588 # with a real number z being represented by an integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5589 # approximation to z*M. To avoid loss of precision, the y below
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5590 # is actually an integer approximation to 2**R*y*M, where R is the
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5591 # number of reductions performed so far.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5592
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5593 y = x-M
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5594 # argument reduction; R = number of reductions performed
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5595 R = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5596 while (R <= L and abs(y) << L-R >= M or
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5597 R > L and abs(y) >> R-L >= M):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5598 y = _div_nearest((M*y) << 1,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5599 M + _sqrt_nearest(M*(M+_rshift_nearest(y, R)), M))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5600 R += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5601
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5602 # Taylor series with T terms
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5603 T = -int(-10*len(str(M))//(3*L))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5604 yshift = _rshift_nearest(y, R)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5605 w = _div_nearest(M, T)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5606 for k in range(T-1, 0, -1):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5607 w = _div_nearest(M, k) - _div_nearest(yshift*w, M)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5608
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5609 return _div_nearest(w*y, M)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5610
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5611 def _dlog10(c, e, p):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5612 """Given integers c, e and p with c > 0, p >= 0, compute an integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5613 approximation to 10**p * log10(c*10**e), with an absolute error of
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5614 at most 1. Assumes that c*10**e is not exactly 1."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5615
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5616 # increase precision by 2; compensate for this by dividing
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5617 # final result by 100
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5618 p += 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5619
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5620 # write c*10**e as d*10**f with either:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5621 # f >= 0 and 1 <= d <= 10, or
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5622 # f <= 0 and 0.1 <= d <= 1.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5623 # Thus for c*10**e close to 1, f = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5624 l = len(str(c))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5625 f = e+l - (e+l >= 1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5626
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5627 if p > 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5628 M = 10**p
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5629 k = e+p-f
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5630 if k >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5631 c *= 10**k
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5632 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5633 c = _div_nearest(c, 10**-k)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5634
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5635 log_d = _ilog(c, M) # error < 5 + 22 = 27
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5636 log_10 = _log10_digits(p) # error < 1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5637 log_d = _div_nearest(log_d*M, log_10)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5638 log_tenpower = f*M # exact
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5639 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5640 log_d = 0 # error < 2.31
48848
5c75a33ef5b2 Merged revisions 66006 via svnmerge from
Neal Norwitz <nnorwitz@gmail.com>
parents: 48769
diff changeset
5641 log_tenpower = _div_nearest(f, 10**-p) # error < 0.5
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5642
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5643 return _div_nearest(log_tenpower+log_d, 100)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5644
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5645 def _dlog(c, e, p):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5646 """Given integers c, e and p with c > 0, compute an integer
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5647 approximation to 10**p * log(c*10**e), with an absolute error of
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5648 at most 1. Assumes that c*10**e is not exactly 1."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5649
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5650 # Increase precision by 2. The precision increase is compensated
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5651 # for at the end with a division by 100.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5652 p += 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5653
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5654 # rewrite c*10**e as d*10**f with either f >= 0 and 1 <= d <= 10,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5655 # or f <= 0 and 0.1 <= d <= 1. Then we can compute 10**p * log(c*10**e)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5656 # as 10**p * log(d) + 10**p*f * log(10).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5657 l = len(str(c))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5658 f = e+l - (e+l >= 1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5659
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5660 # compute approximation to 10**p*log(d), with error < 27
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5661 if p > 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5662 k = e+p-f
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5663 if k >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5664 c *= 10**k
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5665 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5666 c = _div_nearest(c, 10**-k) # error of <= 0.5 in c
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5667
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5668 # _ilog magnifies existing error in c by a factor of at most 10
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5669 log_d = _ilog(c, 10**p) # error < 5 + 22 = 27
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5670 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5671 # p <= 0: just approximate the whole thing by 0; error < 2.31
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5672 log_d = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5673
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5674 # compute approximation to f*10**p*log(10), with error < 11.
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5675 if f:
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5676 extra = len(str(abs(f)))-1
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5677 if p + extra >= 0:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5678 # error in f * _log10_digits(p+extra) < |f| * 1 = |f|
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5679 # after division, error < |f|/10**extra + 0.5 < 10 + 0.5 < 11
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5680 f_log_ten = _div_nearest(f*_log10_digits(p+extra), 10**extra)
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5681 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5682 f_log_ten = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5683 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5684 f_log_ten = 0
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5685
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5686 # error in sum < 11+27 = 38; error after division < 0.38 + 0.5 < 1
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5687 return _div_nearest(f_log_ten + log_d, 100)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5688
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5689 class _Log10Memoize(object):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5690 """Class to compute, store, and allow retrieval of, digits of the
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5691 constant log(10) = 2.302585.... This constant is needed by
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5692 Decimal.ln, Decimal.log10, Decimal.exp and Decimal.__pow__."""
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5693 def __init__(self):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5694 self.digits = "23025850929940456840179914546843642076011014886"
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5695
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5696 def getdigits(self, p):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5697 """Given an integer p >= 0, return floor(10**p)*log(10).
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5698
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5699 For example, self.getdigits(3) returns 2302.
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5700 """
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5701 # digits are stored as a string, for quick conversion to
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5702 # integer in the case that we've already computed enough
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5703 # digits; the stored digits should always be correct
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5704 # (truncated, not rounded to nearest).
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5705 if p < 0:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5706 raise ValueError("p should be nonnegative")
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5707
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5708 if p >= len(self.digits):
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5709 # compute p+3, p+6, p+9, ... digits; continue until at
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5710 # least one of the extra digits is nonzero
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5711 extra = 3
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5712 while True:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5713 # compute p+extra digits, correct to within 1ulp
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5714 M = 10**(p+extra+2)
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5715 digits = str(_div_nearest(_ilog(10*M, M), 100))
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5716 if digits[-extra:] != '0'*extra:
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5717 break
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5718 extra += 3
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5719 # keep all reliable digits so far; remove trailing zeros
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5720 # and next nonzero digit
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5721 self.digits = digits.rstrip('0')[:-1]
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5722 return int(self.digits[:p+1])
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5723
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5724 _log10_digits = _Log10Memoize().getdigits
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5725
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5726 def _iexp(x, M, L=8):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5727 """Given integers x and M, M > 0, such that x/M is small in absolute
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5728 value, compute an integer approximation to M*exp(x/M). For 0 <=
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5729 x/M <= 2.4, the absolute error in the result is bounded by 60 (and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5730 is usually much smaller)."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5731
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5732 # Algorithm: to compute exp(z) for a real number z, first divide z
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5733 # by a suitable power R of 2 so that |z/2**R| < 2**-L. Then
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5734 # compute expm1(z/2**R) = exp(z/2**R) - 1 using the usual Taylor
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5735 # series
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5736 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5737 # expm1(x) = x + x**2/2! + x**3/3! + ...
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5738 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5739 # Now use the identity
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5740 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5741 # expm1(2x) = expm1(x)*(expm1(x)+2)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5742 #
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5743 # R times to compute the sequence expm1(z/2**R),
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5744 # expm1(z/2**(R-1)), ... , exp(z/2), exp(z).
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5745
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5746 # Find R such that x/2**R/M <= 2**-L
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5747 R = _nbits((x<<L)//M)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5748
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5749 # Taylor series. (2**L)**T > M
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5750 T = -int(-10*len(str(M))//(3*L))
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5751 y = _div_nearest(x, T)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5752 Mshift = M<<R
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5753 for i in range(T-1, 0, -1):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5754 y = _div_nearest(x*(Mshift + y), Mshift * i)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5755
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5756 # Expansion
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5757 for k in range(R-1, -1, -1):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5758 Mshift = M<<(k+2)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5759 y = _div_nearest(y*(y+Mshift), Mshift)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5760
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5761 return M+y
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5762
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5763 def _dexp(c, e, p):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5764 """Compute an approximation to exp(c*10**e), with p decimal places of
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5765 precision.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5766
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5767 Returns integers d, f such that:
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5768
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5769 10**(p-1) <= d <= 10**p, and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5770 (d-1)*10**f < exp(c*10**e) < (d+1)*10**f
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5771
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5772 In other words, d*10**f is an approximation to exp(c*10**e) with p
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5773 digits of precision, and with an error in d of at most 1. This is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5774 almost, but not quite, the same as the error being < 1ulp: when d
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5775 = 10**(p-1) the error could be up to 10 ulp."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5776
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5777 # we'll call iexp with M = 10**(p+2), giving p+3 digits of precision
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5778 p += 2
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5779
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5780 # compute log(10) with extra precision = adjusted exponent of c*10**e
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5781 extra = max(0, e + len(str(c)) - 1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5782 q = p + extra
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5783
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5784 # compute quotient c*10**e/(log(10)) = c*10**(e+q)/(log(10)*10**q),
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5785 # rounding down
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5786 shift = e+q
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5787 if shift >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5788 cshift = c*10**shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5789 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5790 cshift = c//10**-shift
43734
3e5edf19d5f0 Merged revisions 58221-58741 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43577
diff changeset
5791 quot, rem = divmod(cshift, _log10_digits(q))
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5792
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5793 # reduce remainder back to original precision
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5794 rem = _div_nearest(rem, 10**extra)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5795
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5796 # error in result of _iexp < 120; error after division < 0.62
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5797 return _div_nearest(_iexp(rem, 10**p), 1000), quot - p + 3
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5798
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5799 def _dpower(xc, xe, yc, ye, p):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5800 """Given integers xc, xe, yc and ye representing Decimals x = xc*10**xe and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5801 y = yc*10**ye, compute x**y. Returns a pair of integers (c, e) such that:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5802
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5803 10**(p-1) <= c <= 10**p, and
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5804 (c-1)*10**e < x**y < (c+1)*10**e
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5805
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5806 in other words, c*10**e is an approximation to x**y with p digits
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5807 of precision, and with an error in c of at most 1. (This is
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5808 almost, but not quite, the same as the error being < 1ulp: when c
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5809 == 10**(p-1) we can only guarantee error < 10ulp.)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5810
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5811 We assume that: x is positive and not equal to 1, and y is nonzero.
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5812 """
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5813
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5814 # Find b such that 10**(b-1) <= |y| <= 10**b
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5815 b = len(str(abs(yc))) + ye
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5816
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5817 # log(x) = lxc*10**(-p-b-1), to p+b+1 places after the decimal point
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5818 lxc = _dlog(xc, xe, p+b+1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5819
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5820 # compute product y*log(x) = yc*lxc*10**(-p-b-1+ye) = pc*10**(-p-1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5821 shift = ye-b
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5822 if shift >= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5823 pc = lxc*yc*10**shift
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5824 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5825 pc = _div_nearest(lxc*yc, 10**-shift)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5826
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5827 if pc == 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5828 # we prefer a result that isn't exactly 1; this makes it
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5829 # easier to compute a correctly rounded result in __pow__
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5830 if ((len(str(xc)) + xe >= 1) == (yc > 0)): # if x**y > 1:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5831 coeff, exp = 10**(p-1)+1, 1-p
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5832 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5833 coeff, exp = 10**p-1, -p
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5834 else:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5835 coeff, exp = _dexp(pc, -(p+1), p+1)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5836 coeff = _div_nearest(coeff, 10)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5837 exp += 1
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5838
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5839 return coeff, exp
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5840
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5841 def _log10_lb(c, correction = {
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5842 '1': 100, '2': 70, '3': 53, '4': 40, '5': 31,
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5843 '6': 23, '7': 16, '8': 10, '9': 5}):
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5844 """Compute a lower bound for 100*log10(c) for a positive integer c."""
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5845 if c <= 0:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5846 raise ValueError("The argument to _log10_lb should be nonnegative.")
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5847 str_c = str(c)
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5848 return 100*len(str_c) - correction[str_c[0]]
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5849
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5850 ##### Helper Functions ####################################################
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5851
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5852 def _convert_other(other, raiseit=False, allow_float=False):
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5853 """Convert other to Decimal.
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5854
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5855 Verifies that it's ok to use in an implicit construction.
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5856 If allow_float is true, allow conversion from float; this
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5857 is used in the comparison methods (__eq__ and friends).
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5858
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5859 """
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5860 if isinstance(other, Decimal):
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5861 return other
41592
1e5a2a2b18ee Fix various spots where int/long and str/unicode unification
Walter Dörwald <walter@livinglogic.de>
parents: 41554
diff changeset
5862 if isinstance(other, int):
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5863 return Decimal(other)
60232
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5864 if allow_float and isinstance(other, float):
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5865 return Decimal.from_float(other)
5078220bd1ea Merged revisions 79583,79588-79589 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 60166
diff changeset
5866
43400
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5867 if raiseit:
1bac386c17cc Merged revisions 58095-58132,58136-58148,58151-58197 via svnmerge from
Thomas Wouters <thomas@python.org>
parents: 43020
diff changeset
5868 raise TypeError("Unable to convert %s to Decimal" % other)
34812
b016236dfbd9 * Fix decimal's handling of foreign types. Now returns NotImplemented
Raymond Hettinger <python@rcn.com>
parents: 34758
diff changeset
5869 return NotImplemented
33519
139a4012bead SF patch #1020845: Decimal performance enhancements
Raymond Hettinger <python@rcn.com>
parents: 33198
diff changeset
5870
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5871 def _convert_for_comparison(self, other, equality_op=False):
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5872 """Given a Decimal instance self and a Python object other, return
62244
ebc4e896924e Fix typo in docstring.
Mark Dickinson <dickinsm@gmail.com>
parents: 62241
diff changeset
5873 a pair (s, o) of Decimal instances such that "s op o" is
62241
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5874 equivalent to "self op other" for any of the 6 comparison
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5875 operators "op".
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5876
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5877 """
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5878 if isinstance(other, Decimal):
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5879 return self, other
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5880
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5881 # Comparison with a Rational instance (also includes integers):
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5882 # self op n/d <=> self*d op n (for n and d integers, d positive).
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5883 # A NaN or infinity can be left unchanged without affecting the
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5884 # comparison result.
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5885 if isinstance(other, _numbers.Rational):
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5886 if not self._is_special:
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5887 self = _dec_from_triple(self._sign,
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5888 str(int(self._int) * other.denominator),
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5889 self._exp)
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5890 return self, Decimal(other.numerator)
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5891
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5892 # Comparisons with float and complex types. == and != comparisons
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5893 # with complex numbers should succeed, returning either True or False
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5894 # as appropriate. Other comparisons return NotImplemented.
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5895 if equality_op and isinstance(other, _numbers.Complex) and other.imag == 0:
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5896 other = other.real
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5897 if isinstance(other, float):
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5898 return self, Decimal.from_float(other)
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5899 return NotImplemented, NotImplemented
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5900
26685311d313 Issue #8188: Comparisons between Decimal objects and other numeric
Mark Dickinson <dickinsm@gmail.com>
parents: 61873
diff changeset
5901
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
5902 ##### Setup Specific Contexts ############################################
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5903
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5904 # The default context prototype used by Context()
32666
c13d911ae05b * Rename "Signals" to "_signals" making it non-public.
Raymond Hettinger <python@rcn.com>
parents: 32576
diff changeset
5905 # Is mutable, so that new contexts can have different default values
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5906
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5907 DefaultContext = Context(
32481
b835d5c61d86 * Make the tests independent of the default precision.
Raymond Hettinger <python@rcn.com>
parents: 32477
diff changeset
5908 prec=28, rounding=ROUND_HALF_EVEN,
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5909 traps=[DivisionByZero, Overflow, InvalidOperation],
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5910 flags=[],
32674
3479610fb288 Factor out two unnecessary global variables.
Raymond Hettinger <python@rcn.com>
parents: 32667
diff changeset
5911 Emax=999999999,
3479610fb288 Factor out two unnecessary global variables.
Raymond Hettinger <python@rcn.com>
parents: 32667
diff changeset
5912 Emin=-999999999,
61864
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
5913 capitals=1,
6fee26c89f6e #Issue 8540: Make Context._clamp attribute public in decimal module.
Mark Dickinson <dickinsm@gmail.com>
parents: 61745
diff changeset
5914 clamp=0
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5915 )
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5916
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5917 # Pre-made alternate contexts offered by the specification
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5918 # Don't change these; the user should be able to select these
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5919 # contexts and be able to reproduce results from other implementations
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5920 # of the spec.
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5921
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5922 BasicContext = Context(
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5923 prec=9, rounding=ROUND_HALF_UP,
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5924 traps=[DivisionByZero, Overflow, InvalidOperation, Clamped, Underflow],
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5925 flags=[],
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5926 )
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5927
32482
eccd0fbe0cd5 Namespace cleanups:
Raymond Hettinger <python@rcn.com>
parents: 32481
diff changeset
5928 ExtendedContext = Context(
32481
b835d5c61d86 * Make the tests independent of the default precision.
Raymond Hettinger <python@rcn.com>
parents: 32477
diff changeset
5929 prec=9, rounding=ROUND_HALF_EVEN,
32576
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5930 traps=[],
83cbc025bfc7 Improve Context construction and representation:
Raymond Hettinger <python@rcn.com>
parents: 32561
diff changeset
5931 flags=[],
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5932 )
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5933
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
5934
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5935 ##### crud for parsing strings #############################################
45514
fce5af5ce16a Merged revisions 61038,61042-61045,61047,61049-61053,61055-61057 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45333
diff changeset
5936 #
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5937 # Regular expression used for parsing numeric strings. Additional
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5938 # comments:
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5939 #
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5940 # 1. Uncomment the two '\s*' lines to allow leading and/or trailing
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5941 # whitespace. But note that the specification disallows whitespace in
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5942 # a numeric string.
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5943 #
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5944 # 2. For finite numbers (not infinities and NaNs) the body of the
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5945 # number between the optional sign and the optional exponent must have
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5946 # at least one decimal digit, possibly after the decimal point. The
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5947 # lookahead expression '(?=\d|\.\d)' checks this.
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5948
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5949 import re
48412
5f4a8980c1ac Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 47674
diff changeset
5950 _parser = re.compile(r""" # A numeric string consists of:
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5951 # \s*
48412
5f4a8980c1ac Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 47674
diff changeset
5952 (?P<sign>[-+])? # an optional sign, followed by either...
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5953 (
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5954 (?=\d|\.\d) # ...a number (with at least one digit)
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5955 (?P<int>\d*) # having a (possibly empty) integer part
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5956 (\.(?P<frac>\d*))? # followed by an optional fractional part
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5957 (E(?P<exp>[-+]?\d+))? # followed by an optional exponent, or...
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5958 |
48412
5f4a8980c1ac Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 47674
diff changeset
5959 Inf(inity)? # ...an infinity, or...
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5960 |
48412
5f4a8980c1ac Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 47674
diff changeset
5961 (?P<signal>s)? # ...an (optionally signaling)
5f4a8980c1ac Merged revisions 64475,64544-64545,64550,64557-64558,64565,64570,64577,64582-64583,64585,64590,64592-64593,64625,64630,64638,64647,64655-64656,64663-64664 via svnmerge from
Benjamin Peterson <benjamin@python.org>
parents: 47674
diff changeset
5962 NaN # NaN
55517
88255cb4534d Merged revisions 74279 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 53299
diff changeset
5963 (?P<diag>\d*) # with (possibly empty) diagnostic info.
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5964 )
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5965 # \s*
44654
5a71dcc71eff Merged revisions 59921-59932 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44643
diff changeset
5966 \Z
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5967 """, re.VERBOSE | re.IGNORECASE).match
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5968
44129
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
5969 _all_zeros = re.compile('0*$').match
b637349336fd Merged revisions 59275-59303 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 44070
diff changeset
5970 _exact_half = re.compile('50*$').match
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5971
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5972 ##### PEP3101 support functions ##############################################
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5973 # The functions in this section have little to do with the Decimal
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5974 # class, and could potentially be reused or adapted for other pure
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5975 # Python numeric classes that want to implement __format__
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5976 #
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5977 # A format specifier for Decimal looks like:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5978 #
66444
eded691497b7 Issue #7094: Add alternate ('#') flag to __format__ methods for float, complex and Decimal. Allows greater control over when decimal points appear. Added to make transitioning from %-formatting easier. '#g' still has a problem with Decimal which I'll fix soon.
Eric Smith <eric@trueblade.com>
parents: 66346
diff changeset
5979 # [[fill]align][sign][#][0][minimumwidth][,][.precision][type]
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5980
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5981 _parse_format_specifier_regex = re.compile(r"""\A
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5982 (?:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5983 (?P<fill>.)?
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5984 (?P<align>[<>=^])
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5985 )?
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5986 (?P<sign>[-+ ])?
66444
eded691497b7 Issue #7094: Add alternate ('#') flag to __format__ methods for float, complex and Decimal. Allows greater control over when decimal points appear. Added to make transitioning from %-formatting easier. '#g' still has a problem with Decimal which I'll fix soon.
Eric Smith <eric@trueblade.com>
parents: 66346
diff changeset
5987 (?P<alt>\#)?
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5988 (?P<zeropad>0)?
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5989 (?P<minimumwidth>(?!0)\d+)?
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5990 (?P<thousands_sep>,)?
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5991 (?:\.(?P<precision>0|(?!0)\d+))?
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5992 (?P<type>[eEfFgGn%])?
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5993 \Z
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5994 """, re.VERBOSE)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
5995
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5996 del re
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
5997
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5998 # The locale module is only needed for the 'n' format specifier. The
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
5999 # rest of the PEP 3101 code functions quite happily without it, so we
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6000 # don't care too much if locale isn't present.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6001 try:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6002 import locale as _locale
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6003 except ImportError:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6004 pass
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6005
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6006 def _parse_format_specifier(format_spec, _localeconv=None):
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6007 """Parse and validate a format specifier.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6008
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6009 Turns a standard numeric format specifier into a dict, with the
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6010 following entries:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6011
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6012 fill: fill character to pad field to minimum width
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6013 align: alignment type, either '<', '>', '=' or '^'
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6014 sign: either '+', '-' or ' '
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6015 minimumwidth: nonnegative integer giving minimum width
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6016 zeropad: boolean, indicating whether to pad with zeros
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6017 thousands_sep: string to use as thousands separator, or ''
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6018 grouping: grouping for thousands separators, in format
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6019 used by localeconv
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6020 decimal_point: string to use for decimal point
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6021 precision: nonnegative integer giving precision, or None
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6022 type: one of the characters 'eEfFgG%', or None
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6023
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6024 """
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6025 m = _parse_format_specifier_regex.match(format_spec)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6026 if m is None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6027 raise ValueError("Invalid format specifier: " + format_spec)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6028
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6029 # get the dictionary
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6030 format_dict = m.groupdict()
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6031
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6032 # zeropad; defaults for fill and alignment. If zero padding
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6033 # is requested, the fill and align fields should be absent.
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6034 fill = format_dict['fill']
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6035 align = format_dict['align']
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6036 format_dict['zeropad'] = (format_dict['zeropad'] is not None)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6037 if format_dict['zeropad']:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6038 if fill is not None:
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6039 raise ValueError("Fill character conflicts with '0'"
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6040 " in format specifier: " + format_spec)
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6041 if align is not None:
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6042 raise ValueError("Alignment conflicts with '0' in "
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6043 "format specifier: " + format_spec)
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6044 format_dict['fill'] = fill or ' '
55892
0bc759f6ded5 Merged revisions 74723 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
6045 # PEP 3101 originally specified that the default alignment should
0bc759f6ded5 Merged revisions 74723 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
6046 # be left; it was later agreed that right-aligned makes more sense
0bc759f6ded5 Merged revisions 74723 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
6047 # for numeric types. See http://bugs.python.org/issue6857.
0bc759f6ded5 Merged revisions 74723 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55888
diff changeset
6048 format_dict['align'] = align or '>'
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6049
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6050 # default sign handling: '-' for negative, '' for positive
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6051 if format_dict['sign'] is None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6052 format_dict['sign'] = '-'
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6053
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6054 # minimumwidth defaults to 0; precision remains None if not given
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6055 format_dict['minimumwidth'] = int(format_dict['minimumwidth'] or '0')
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6056 if format_dict['precision'] is not None:
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6057 format_dict['precision'] = int(format_dict['precision'])
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6058
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6059 # if format type is 'g' or 'G' then a precision of 0 makes little
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6060 # sense; convert it to 1. Same if format type is unspecified.
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6061 if format_dict['precision'] == 0:
55876
0dd0b0de5e31 Merged revisions 74706 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 55743
diff changeset
6062 if format_dict['type'] is None or format_dict['type'] in 'gG':
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6063 format_dict['precision'] = 1
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6064
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6065 # determine thousands separator, grouping, and decimal separator, and
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6066 # add appropriate entries to format_dict
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6067 if format_dict['type'] == 'n':
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6068 # apart from separators, 'n' behaves just like 'g'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6069 format_dict['type'] = 'g'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6070 if _localeconv is None:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6071 _localeconv = _locale.localeconv()
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6072 if format_dict['thousands_sep'] is not None:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6073 raise ValueError("Explicit thousands separator conflicts with "
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6074 "'n' type in format specifier: " + format_spec)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6075 format_dict['thousands_sep'] = _localeconv['thousands_sep']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6076 format_dict['grouping'] = _localeconv['grouping']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6077 format_dict['decimal_point'] = _localeconv['decimal_point']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6078 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6079 if format_dict['thousands_sep'] is None:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6080 format_dict['thousands_sep'] = ''
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6081 format_dict['grouping'] = [3, 0]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6082 format_dict['decimal_point'] = '.'
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6083
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6084 return format_dict
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6085
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6086 def _format_align(sign, body, spec):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6087 """Given an unpadded, non-aligned numeric string 'body' and sign
68488
0991b40e895d #11515: fix several typos. Patch by Piotr Kasprzyk.
Ezio Melotti <ezio.melotti@gmail.com>
parents: 68395
diff changeset
6088 string 'sign', add padding and alignment conforming to the given
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6089 format specifier dictionary 'spec' (as produced by
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6090 parse_format_specifier).
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6091
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6092 """
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6093 # how much extra space do we have to play with?
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6094 minimumwidth = spec['minimumwidth']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6095 fill = spec['fill']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6096 padding = fill*(minimumwidth - len(sign) - len(body))
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6097
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6098 align = spec['align']
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6099 if align == '<':
52190
39f4fa51acfb Merged revisions 70430 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 51655
diff changeset
6100 result = sign + body + padding
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6101 elif align == '>':
52190
39f4fa51acfb Merged revisions 70430 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 51655
diff changeset
6102 result = padding + sign + body
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6103 elif align == '=':
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6104 result = sign + padding + body
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6105 elif align == '^':
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6106 half = len(padding)//2
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6107 result = padding[:half] + sign + body + padding[half:]
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6108 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6109 raise ValueError('Unrecognised alignment field')
45569
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6110
937a3c5af691 Merged revisions 61038,61042-61045,61047,61050,61053,61055-61056,61061-61062,61066,61068,61070,61083,61085,61092-61097,61103-61104,61110-61112,61114-61115,61117-61125 via svnmerge from
Christian Heimes <christian@cheimes.de>
parents: 45549
diff changeset
6111 return result
44025
ebc7389297d6 Merged revisions 59107-59186 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 43734
diff changeset
6112
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6113 def _group_lengths(grouping):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6114 """Convert a localeconv-style grouping into a (possibly infinite)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6115 iterable of integers representing group lengths.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6116
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6117 """
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6118 # The result from localeconv()['grouping'], and the input to this
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6119 # function, should be a list of integers in one of the
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6120 # following three forms:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6121 #
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6122 # (1) an empty list, or
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6123 # (2) nonempty list of positive integers + [0]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6124 # (3) list of positive integers + [locale.CHAR_MAX], or
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6125
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6126 from itertools import chain, repeat
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6127 if not grouping:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6128 return []
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6129 elif grouping[-1] == 0 and len(grouping) >= 2:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6130 return chain(grouping[:-1], repeat(grouping[-2]))
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6131 elif grouping[-1] == _locale.CHAR_MAX:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6132 return grouping[:-1]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6133 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6134 raise ValueError('unrecognised format for grouping')
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6135
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6136 def _insert_thousands_sep(digits, spec, min_width=1):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6137 """Insert thousands separators into a digit string.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6138
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6139 spec is a dictionary whose keys should include 'thousands_sep' and
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6140 'grouping'; typically it's the result of parsing the format
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6141 specifier using _parse_format_specifier.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6142
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6143 The min_width keyword argument gives the minimum length of the
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6144 result, which will be padded on the left with zeros if necessary.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6145
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6146 If necessary, the zero padding adds an extra '0' on the left to
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6147 avoid a leading thousands separator. For example, inserting
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6148 commas every three digits in '123456', with min_width=8, gives
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6149 '0,123,456', even though that has length 9.
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6150
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6151 """
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6152
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6153 sep = spec['thousands_sep']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6154 grouping = spec['grouping']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6155
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6156 groups = []
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6157 for l in _group_lengths(grouping):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6158 if l <= 0:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6159 raise ValueError("group length should be positive")
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6160 # max(..., 1) forces at least 1 digit to the left of a separator
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6161 l = min(max(len(digits), min_width, 1), l)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6162 groups.append('0'*(l - len(digits)) + digits[-l:])
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6163 digits = digits[:-l]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6164 min_width -= l
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6165 if not digits and min_width <= 0:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6166 break
52201
fcdffd85a8bd Merged revisions 70444 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52196
diff changeset
6167 min_width -= len(sep)
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6168 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6169 l = max(len(digits), min_width, 1)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6170 groups.append('0'*(l - len(digits)) + digits[-l:])
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6171 return sep.join(reversed(groups))
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6172
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6173 def _format_sign(is_negative, spec):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6174 """Determine sign character."""
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6175
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6176 if is_negative:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6177 return '-'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6178 elif spec['sign'] in ' +':
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6179 return spec['sign']
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6180 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6181 return ''
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6182
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6183 def _format_number(is_negative, intpart, fracpart, exp, spec):
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6184 """Format a number, given the following data:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6185
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6186 is_negative: true if the number is negative, else false
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6187 intpart: string of digits that must appear before the decimal point
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6188 fracpart: string of digits that must come after the point
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6189 exp: exponent, as an integer
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6190 spec: dictionary resulting from parsing the format specifier
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6191
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6192 This function uses the information in spec to:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6193 insert separators (decimal separator and thousands separators)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6194 format the sign
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6195 format the exponent
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6196 add trailing '%' for the '%' type
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6197 zero-pad if necessary
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6198 fill and align if necessary
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6199 """
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6200
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6201 sign = _format_sign(is_negative, spec)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6202
66444
eded691497b7 Issue #7094: Add alternate ('#') flag to __format__ methods for float, complex and Decimal. Allows greater control over when decimal points appear. Added to make transitioning from %-formatting easier. '#g' still has a problem with Decimal which I'll fix soon.
Eric Smith <eric@trueblade.com>
parents: 66346
diff changeset
6203 if fracpart or spec['alt']:
52196
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6204 fracpart = spec['decimal_point'] + fracpart
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6205
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6206 if exp != 0 or spec['type'] in 'eE':
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6207 echar = {'E': 'E', 'e': 'e', 'G': 'E', 'g': 'e'}[spec['type']]
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6208 fracpart += "{0}{1:+}".format(echar, exp)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6209 if spec['type'] == '%':
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6210 fracpart += '%'
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6211
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6212 if spec['zeropad']:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6213 min_width = spec['minimumwidth'] - len(fracpart) - len(sign)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6214 else:
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6215 min_width = 0
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6216 intpart = _insert_thousands_sep(intpart, spec, min_width)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6217
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6218 return _format_align(sign, intpart+fracpart, spec)
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6219
12e14e6f1f2d Merged revisions 70439 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 52190
diff changeset
6220
41554
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
6221 ##### Useful Constants (internal use only) ################################
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
6222
06145fbc7ab9 Merged revisions 53952-54987 via svnmerge from
Guido van Rossum <guido@python.org>
parents: 41464
diff changeset
6223 # Reusable defaults
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6224 _Infinity = Decimal('Inf')
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6225 _NegativeInfinity = Decimal('-Inf')
50473
d367be543f6c Merged revisions 68184 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50115
diff changeset
6226 _NaN = Decimal('NaN')
50482
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6227 _Zero = Decimal(0)
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6228 _One = Decimal(1)
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6229 _NegativeOne = Decimal(-1)
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6230
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6231 # _SignedInfinity[sign] is infinity w/ that sign
134d173b9350 Merged revisions 68193 via svnmerge from
Mark Dickinson <dickinsm@gmail.com>
parents: 50473
diff changeset
6232 _SignedInfinity = (_Infinity, _NegativeInfinity)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
6233
61873
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6234 # Constants related to the hash implementation; hash(x) is based
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6235 # on the reduction of x modulo _PyHASH_MODULUS
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6236 import sys
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6237 _PyHASH_MODULUS = sys.hash_info.modulus
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6238 # hash values to use for positive and negative infinities, and nans
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6239 _PyHASH_INF = sys.hash_info.inf
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6240 _PyHASH_NAN = sys.hash_info.nan
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6241 del sys
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6242
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6243 # _PyHASH_10INV is the inverse of 10 modulo the prime _PyHASH_MODULUS
0bc8ffe6ba9a Issue #8188: Introduce a new scheme for computing hashes of numbers
Mark Dickinson <dickinsm@gmail.com>
parents: 61864
diff changeset
6244 _PyHASH_10INV = pow(10, _PyHASH_MODULUS - 2, _PyHASH_MODULUS)
32451
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
6245
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
6246
d2c1c7ae7cf4 Move Decimal from the sandbox into production.
Raymond Hettinger <python@rcn.com>
parents:
diff changeset
6247 if __name__ == '__main__':
67843
9e65951266a2 Get command-line doctest of Lib/decimal.py to work again.
Raymond Hettinger <python@rcn.com>
parents: 66575
diff changeset
6248 import doctest, decimal
9e65951266a2 Get command-line doctest of Lib/decimal.py to work again.
Raymond Hettinger <python@rcn.com>
parents: 66575
diff changeset
6249 doctest.testmod(decimal)