c_cpp/etc/calc/custom/pmodm127

   1 NAME
   2     pmodm127 - calculate q mod 2^(2^127-1)
   3
   4 SYNOPSIS
   5     custom("pmodm127", q)
   6
   7 TYPES
   8     q           int > 0
   9
  10     return      int
  11
  12 DESCRIPTION
  13
  14     This custom function will return the value:
  15
  16         q mod 2^(2^127-1)
  17
  18     This custom function serves as a demonstration of how to write
  19     a custom function.  It performs the equivalent of:
  20
  21         pmod(2, 2^127-1, q)
  22
  23     The return value is integer in the half open range: [0, q).
  24
  25     SPECIAL NOTE:
  26
  27         Can you find a value, q, for which this custom function returns 1?
  28         If you do, send the value of q to chongo using the EMail address
  29         found at:
  30
  31             http://www.isthe.com/chongo/address.html
  32
  33 EXAMPLE
  34     > custom("pmodm127", 65537)
  35             32769
  36
  37     > custom("pmodm127", 2^31-1)
  38             8
  39
  40     > custom("pmodm127", 7^51+2)
  41             11228202966269457258557496419097462731193173
  42
  43 LIMITS
  44     calc must be built with ALLOW_CUSTOM= -DCUSTOM
  45     calc must be executed with a -C arg.
  46     q must be an integer > 0
  47
  48 LIBRARY
  49     none
  50
  51 SEE ALSO
  52     custom
  53
  54 ## Copyright (C) 2004  Landon Curt Noll
  55 ##
  56 ## Calc is open software; you can redistribute it and/or modify it under
  57 ## the terms of the version 2.1 of the GNU Lesser General Public License
  58 ## as published by the Free Software Foundation.
  59 ##
  60 ## Calc is distributed in the hope that it will be useful, but WITHOUT
  61 ## ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
  62 ## or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General
  63 ## Public License for more details.
  64 ##
  65 ## A copy of version 2.1 of the GNU Lesser General Public License is
  66 ## distributed with calc under the filename COPYING-LGPL.  You should have
  67 ## received a copy with calc; if not, write to Free Software Foundation, Inc.
  68 ## 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
  69 ##
  70 ## @(#) $Revision: 30.1 $
  71 ## @(#) $Id: pmodm127,v 30.1 2007/03/16 11:10:04 chongo Exp $
  72 ## @(#) $Source: /usr/local/src/bin/calc/custom/RCS/pmodm127,v $
  73 ##
  74 ## Under source code control:   2004/02/25 07:13:15
  75 ## File existed as early as:    2004
  76 ##
  77 ## chongo <was here> /\oo/\     http://www.isthe.com/chongo/
  78 ## Share and enjoy!  :-)        http://www.isthe.com/chongo/tech/comp/calc/