sys/man/1/mpc

   1 .TH MPC 1
   2 .SH NAME
   3 mpc \- extended precision arithmetic code generator
   4 .SH SYNOPSIS
   5 .B mpc
   6 [
   7 .I file ...
   8 ]
   9 .SH DESCRIPTION
  10 .I Mpc
  11 generates C functions from a simple language that operates on
  12 extended precision integers using the
  13 .IR mp (2)
  14 library.
  15 .SH LANGUAGE
  16 The language consists of a series of function definitions of the form:
  17 .IP
  18 .I name
  19 (
  20 .I "parameter list"
  21 ) {
  22 .I statements
  23 }
  24 .PP
  25 All variables and parameters are extended precision integers and are
  26 passed by reference. Statements are separated by semicolon and the
  27 following statemens are defined:
  28 .IP
  29 .I name
  30 .B =
  31 .I expression
  32 .IP
  33 .B if
  34 (
  35 .I condition
  36 ) {
  37 .I statements
  38 }
  39 .B "else if"
  40 (
  41 .I condition
  42 ) {
  43 .I statements
  44 }
  45 .B else
  46 {
  47 .I statements
  48 }
  49 .IP
  50 .B while
  51 (
  52 .I condition
  53 ) {
  54 .I statements
  55 }
  56 .IP
  57 .B break
  58 .IP
  59 .I
  60 name
  61 (
  62 .I "parameter list"
  63 )
  64 .IP
  65 .B
  66 mod
  67 (
  68 .I modulus
  69 ) {
  70 .I statements
  71 }
  72 .PP
  73 There is no distinction between input and output parameters, but
  74 conventionally, the outputs are put at the end of the
  75 .I "parameter list"
  76 and the language allows one to write
  77 .IP
  78 .I F
  79 (
  80 .IR X ,
  81 .IR Y ,
  82 .I Z
  83 )
  84 as
  85 .IR Y ,
  86 .I Z
  87 .B =
  88 .I F
  89 (
  90 .I X
  91 )
  92 .PP
  93 Expressions are composed out of the following arithmetic operations:
  94 .RS
  95 .TF _____________
  96 .TP
  97 .B +
  98 addition.
  99 .TP
 100 .B -
 101 subtraction.
 102 .TP
 103 .B *
 104 multiplication.
 105 .TP
 106 .B /
 107 division, or multiplicative inverse when enclosed in
 108 .B mod
 109 block.
 110 .TP
 111 .B %
 112 division remainder.
 113 .TP
 114 .B ^
 115 exponentiation.
 116 .TP
 117 .BI >> constant
 118 right shift by a constant.
 119 .TP
 120 .BI << constant
 121 left shift by a constant.
 122 .TP
 123 .IB condition ? a : b
 124 pick
 125 .I a
 126 when
 127 .I condition is true, otherwise
 128 .I b
 129 when false.
 130 .RE
 131 .PD
 132 .PP
 133 Conditions can use the following operations:
 134 .RS
 135 .TF _____________
 136 .TP
 137 .B ==
 138 equality.
 139 .TP
 140 .B !=
 141 inequality.
 142 .TP
 143 .B >
 144 bigger than.
 145 .TP
 146 .B <
 147 smaller than.
 148 .TP
 149 .BI ! condition
 150 negation.
 151 .RE
 152 .SH SOURCE
 153 .B /sys/src/cmd/mpc.y
 154 .SH "SEE ALSO"
 155 .IR mp (2)