| | 1 | from sage.rings.integer import Integer |
| | 2 | |
| | 3 | # TODO: check what the highest guaranteed valid prime returned by primegen is |
| | 4 | # (Currently set to (10^15).previous_prime() per the documentation.) |
| | 5 | |
| | 6 | # (10^15).previous_prime() |
| | 7 | max_prime = 999999999999989 |
| | 8 | |
| | 9 | cdef class PrimeGen: |
| | 10 | """ |
| | 11 | A wrapper class around D.J. Bernstein's primegen library |
| | 12 | that uses the Sieve of Atkin to generate primes efficiently. |
| | 13 | |
| | 14 | See http://cr.yp.to/primegen.html |
| | 15 | """ |
| | 16 | |
| | 17 | def __new__(self, start=2): |
| | 18 | """ |
| | 19 | Construct a new primegen wrapper and initialize it to the given start. |
| | 20 | |
| | 21 | EXAMPLES:: |
| | 22 | |
| | 23 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 24 | sage: pg = PrimeGen() |
| | 25 | sage: pg.next() |
| | 26 | 2 |
| | 27 | |
| | 28 | sage: pg = PrimeGen(37) |
| | 29 | sage: pg.next() |
| | 30 | 37 |
| | 31 | """ |
| | 32 | self.reset(start=start) |
| | 33 | |
| | 34 | def next(self): |
| | 35 | """ |
| | 36 | Return the next prime. If the end of the valid range for |
| | 37 | primegen has been reached, it will raise a RuntimeError. |
| | 38 | |
| | 39 | EXAMPLES:: |
| | 40 | |
| | 41 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 42 | sage: pg = PrimeGen(10) |
| | 43 | sage: pg.next() |
| | 44 | 11 |
| | 45 | sage: pg.next() |
| | 46 | 13 |
| | 47 | """ |
| | 48 | if self.done: |
| | 49 | raise RuntimeError("End of valid primegen range reached.") |
| | 50 | p = primegen_next(&self.pg) |
| | 51 | self.done = (p == max_prime) |
| | 52 | return Integer(p) |
| | 53 | |
| | 54 | |
| | 55 | def peek(self): |
| | 56 | """ |
| | 57 | Return the next prime without advancing its state. If the end of |
| | 58 | the valid range for primegen has been reached, it will return None. |
| | 59 | |
| | 60 | EXAMPLES:: |
| | 61 | |
| | 62 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 63 | sage: pg = PrimeGen(100) |
| | 64 | sage: pg.peek() |
| | 65 | 101 |
| | 66 | sage: pg.next() |
| | 67 | 101 |
| | 68 | """ |
| | 69 | |
| | 70 | if self.done: |
| | 71 | return None |
| | 72 | return Integer(primegen_peek(&self.pg)) |
| | 73 | |
| | 74 | def count(self, uint64 to): |
| | 75 | """ |
| | 76 | Count primes smaller than to starting at the current location. |
| | 77 | |
| | 78 | EXAMPLES:: |
| | 79 | |
| | 80 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 81 | sage: pg = PrimeGen() |
| | 82 | sage: pg.count(7) # 2, 3, 5 |
| | 83 | 3 |
| | 84 | sage: pg.count(10) # 7 |
| | 85 | 1 |
| | 86 | |
| | 87 | sage: pg = PrimeGen() |
| | 88 | sage: pg.count(1000000000) |
| | 89 | 50847534 |
| | 90 | |
| | 91 | sage: pg = PrimeGen() |
| | 92 | sage: pg.count(2000000000) == prime_pi(2000000000) |
| | 93 | True |
| | 94 | """ |
| | 95 | if to > max_prime: |
| | 96 | raise RuntimeError("Counting past end of valid primegen range.") |
| | 97 | return Integer(primegen_count(&self.pg, to)) |
| | 98 | |
| | 99 | def skipto(self, uint64 to): |
| | 100 | """ |
| | 101 | Advance primegen state so the next prime returned will be |
| | 102 | the smallest prime after to. This function has no effect if the |
| | 103 | current primegen location is already after to. |
| | 104 | |
| | 105 | EXAMPLES:: |
| | 106 | |
| | 107 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 108 | sage: pg = PrimeGen() |
| | 109 | sage: pg.skipto(13) |
| | 110 | sage: pg.next() |
| | 111 | 13 |
| | 112 | sage: pg.skipto(10) |
| | 113 | sage: pg.next() |
| | 114 | 17 |
| | 115 | """ |
| | 116 | if to > max_prime: |
| | 117 | raise RuntimeError("Skipping past end of valid primegen range.") |
| | 118 | primegen_skipto(&self.pg, to) |
| | 119 | |
| | 120 | def reset(self, start=2): |
| | 121 | """ |
| | 122 | Reinitialize the prime generator to restart at the given value. |
| | 123 | |
| | 124 | EXAMPLES:: |
| | 125 | |
| | 126 | sage: from sage.libs.primegen.primegen import PrimeGen |
| | 127 | sage: pg = PrimeGen(1000) |
| | 128 | sage: pg.reset() |
| | 129 | sage: pg.next() |
| | 130 | 2 |
| | 131 | sage: pg.reset(100) |
| | 132 | sage: pg.next() |
| | 133 | 101 |
| | 134 | """ |
| | 135 | primegen_init(&self.pg) |
| | 136 | self.done = False |
| | 137 | self.skipto(start) |