X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2Fexpressions.texi;h=8e28ad5e24457e33c05161062f2ee546be707954;hb=60c545e6e958d868db3399a8989d37d8f9e0c131;hp=1141f3a53d723f0aba39d03b165447a961fd3d63;hpb=f5095492128c6ed72d5ad0db396809bebc5b7a91;p=pspp diff --git a/doc/expressions.texi b/doc/expressions.texi index 1141f3a53d..8e28ad5e24 100644 --- a/doc/expressions.texi +++ b/doc/expressions.texi @@ -1,5 +1,14 @@ -@c Use @func when refering to a function. -@c Use @deftypefn for their definitions +@c PSPP - a program for statistical analysis. +@c Copyright (C) 2017, 2020 Free Software Foundation, Inc. +@c Permission is granted to copy, distribute and/or modify this document +@c under the terms of the GNU Free Documentation License, Version 1.3 +@c or any later version published by the Free Software Foundation; +@c with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. +@c A copy of the license is included in the section entitled "GNU +@c Free Documentation License". +@c +@c Use @func when referring to a function. +@c Use @deftypefn for their definitions @macro func{NAME} @code{\NAME\} @end macro @@ -123,7 +132,7 @@ system-missing. The result of @code{0**0} is system-missing as well. @cindex @samp{-} @cindex negation @item - @var{a} -Reverses the sign of @var{a}. +Reverses the sign of @var{a}. @end table @node Logical Operators @@ -263,7 +272,7 @@ The sections below describe each function in detail. * Missing Value Functions:: MISSING NMISS NVALID SYSMIS VALUE * Set Membership:: ANY RANGE * Statistical Functions:: CFVAR MAX MEAN MEDIAN MIN SD SUM VARIANCE -* String Functions:: CONCAT INDEX LENGTH LOWER LPAD LTRIM NUMBER +* String Functions:: CONCAT INDEX LENGTH LOWER LPAD LTRIM NUMBER REPLACE RINDEX RPAD RTRIM STRING STRUNC SUBSTR UPCASE * Time and Date:: CTIME.xxx DATE.xxx TIME.xxx XDATE.xxx @@ -414,7 +423,11 @@ functions. In particular, user-missing values for numeric variables are converted to system-missing values. @deftypefn {Function} {} MISSING (@var{expr}) -Returns 1 if @var{expr} has the system-missing value, 0 otherwise. +When @var{expr} is simply the name of a numeric variable, returns 1 if +the variable has the system-missing value or if it is user-missing. +For any other value 0 is returned. +If @var{expr} takes another form, the function returns 1 if the value is +system-missing, 0 otherwise. @end deftypefn @deftypefn {Function} {} NMISS (@var{expr} [, @var{expr}]@dots{}) @@ -430,10 +443,7 @@ variable ranges using the @code{@var{var1} TO @var{var2}} syntax. @end deftypefn @deftypefn {Function} {} SYSMIS (@var{expr}) -When @var{expr} is simply the name of a numeric variable, returns 1 if -the variable has the system-missing value, 0 if it is user-missing or -not missing. If given @var{expr} takes another form, results in 1 if -the value is system-missing, 0 otherwise. +Returns 1 if @var{expr} has the system-missing value, 0 otherwise. @end deftypefn @deftypefn {Function} {} VALUE (@var{variable}) @@ -626,7 +636,7 @@ empty string. Returns the number produced when @var{string} is interpreted according to format specifier @var{format}. If the format width @var{w} is less than the length of @var{string}, then only the first @var{w} -characters in @var{string} are used, e.g.@: @code{NUMBER("123", F3.0)} +characters in @var{string} are used, @i{e.g.}@: @code{NUMBER("123", F3.0)} and @code{NUMBER("1234", F3.0)} both have value 123. If @var{w} is greater than @var{string}'s length, then it is treated as if it were right-padded with spaces. If @var{string} is not in the correct @@ -761,7 +771,7 @@ Most time and date functions will not accept earlier dates. Times and dates are handled by @pspp{} as single numbers. A @dfn{time} is an interval. @pspp{} measures times in seconds. Thus, the following intervals correspond with the numeric values given: - + @example 10 minutes 600 1 hour 3,600 @@ -804,7 +814,7 @@ Returns a time corresponding to @var{ndays} days. Returns a time corresponding to @var{nhours} hours, @var{nmins} minutes, and @var{nsecs} seconds. The arguments may not have mixed signs: if any of them are positive, then none may be negative, and -vice versa. +vice versa. @end deftypefn @node Time Extraction @@ -958,7 +968,7 @@ that is, gives the date that @var{date-or-time} is in. For a time, results in the number of whole hours beyond the number of whole days represented by @var{date-or-time}. For a date, results in the hour (as an integer between 0 and 23) corresponding to -@var{date-or-time}. +@var{date-or-time}. @end deftypefn @cindex day of the year @@ -980,7 +990,7 @@ corresponding to @var{date}. @cindex time, in minutes @deftypefn {Function} {} XDATE.MINUTE (@var{time-or-date}) Results in the number of minutes (as an integer between 0 and 59) after -the last hour in @var{time-or-date}. +the last hour in @var{time-or-date}. @end deftypefn @cindex months @@ -1214,8 +1224,8 @@ include an NCDF function. The individual distributions are described individually below. @menu -* Continuous Distributions:: -* Discrete Distributions:: +* Continuous Distributions:: +* Discrete Distributions:: @end menu @node Continuous Distributions @@ -1236,7 +1246,7 @@ Constraints: @var{a} > 0, @var{b} > 0, @var{lambda} >= 0, 0 <= @var{x} @end deftypefn @deftypefn {Function} {} PDF.BVNOR (@var{x0}, @var{x1}, @var{rho}) -@deftypefnx {Function} {} CDF.VBNOR (@var{x0}, @var{x1}, @var{rho}) +@deftypefnx {Function} {} CDF.BVNOR (@var{x0}, @var{x1}, @var{rho}) Bivariate normal distribution of two standard normal variables with correlation coefficient @var{rho}. Two variates @var{x0} and @var{x1} must be provided. Constraints: 0 <= @var{rho} <= 1, 0 <= @var{p} <= 1. @@ -1544,7 +1554,7 @@ subtraction. @enumerate @item -@code{( )} +@code{()} @item @code{**} @item @@ -1554,7 +1564,11 @@ subtraction. @item @code{+ -} @item -@code{EQ GE GT LE LT NE} +@code{= >= > <= < <>} +@item +@code{NOT} +@item +@code{AND} @item -@code{AND NOT OR} +@code{OR} @end enumerate