ref: d2089f949edd71626e2391672b723aa2d9fbcb9b
dir: /sys/man/1/hoc/
.TH HOC 1 .SH NAME hoc \- interactive floating point language .SH SYNOPSIS .B hoc [ .B -e .I expression ] [ .I file ... ] .SH DESCRIPTION .I Hoc interprets a simple language for floating point arithmetic, at about the level of BASIC, with C-like syntax and functions. .PP The named .I files are read and interpreted in order. If no .I file is given or if .I file is .L - .I hoc interprets the standard input. The .B -e option allows input to .I hoc to be specified on the command line, to be treated as if it appeared in a file. .PP .I Hoc input consists of .I expressions and .IR statements . Expressions are evaluated and their results printed. Statements, typically assignments and function or procedure definitions, produce no output unless they explicitly call .IR print . .PP Variable names have the usual syntax, including .LR _ ; the name .L _ by itself contains the value of the last expression evaluated. The variables .BR E , .BR PI , .BR PHI , .BR GAMMA and .B DEG are predefined; the last is 59.25..., degrees per radian. .PP Expressions are formed with these C-like operators, listed by decreasing precedence. .TP .B ^ exponentiation .TP .B ! - ++ -- .TP .B * / % .TP .B + - .TP .B > >= < <= == != .TP .B && .TP .B || .TP .B = += -= *= /= %= .PP Built in functions are .BR abs , .BR acos , .BR asin , .B atan (one argument), .BR cos , .BR cosh , .BR exp , .BR int , .BR log , .BR log10 , .BR sin , .BR sinh , .BR sqrt , .BR tan , and .BR tanh . The function .B read(x) reads a value into the variable .B x and returns 0 at EOF; the statement .B print prints a list of expressions that may include string constants such as \fL"hello\en"\f1.\fP .PP Control flow statements are .BR if - else , .BR while , and .BR for , with braces for grouping. Newline ends a statement. Backslash-newline is equivalent to a space. .PP Functions and procedures are introduced by the words .B func and .BR proc ; .B return is used to return with a value from a function. .SH EXAMPLES .EX func gcd(a, b) { temp = abs(a) % abs(b) if(temp == 0) return abs(b) return gcd(b, temp) } for(i=1; i<12; i++) print gcd(i,12) .EE .SH SOURCE .B /sys/src/cmd/hoc .SH "SEE ALSO" .IR bc (1), .IR dc (1) .br B. W. Kernighan and R. Pike, .I The Unix Programming Environment, Prentice-Hall, 1984 .SH BUGS Error recovery is imperfect within function and procedure definitions.