# [LON-CAPA-cvs] cvs: loncom /html/adm/help/tex Problem_LON-CAPA_Functions.tex

www lon-capa-cvs@mail.lon-capa.org
Wed, 01 Jun 2005 21:55:28 -0000

www		Wed Jun  1 17:55:28 2005 EDT

Modified files:
Log:
Hopefully eliminate some strange characters (showing up as "?" in Safari)

--- loncom/html/adm/help/tex/Problem_LON-CAPA_Functions.tex:1.5	Fri Apr  1 13:32:42 2005
+++ loncom/html/adm/help/tex/Problem_LON-CAPA_Functions.tex	Wed Jun  1 17:55:28 2005
@@ -22,9 +22,9 @@
\&abs(\$x), \&sgn(\$x)  & Abs takes the absolute value of x while sgn(x) returns 1, 0 or -1 depending on the value of x. For x$>$0, sgn(x) = 1, for x=0, sgn(x) = 0 and for x$<$0, sgn(x) = -1. \$x can be a pure number \\ \hline -\&erf(\$x), \&erfc(\$x) & Error function. erf = 2/sqrt(pi) integral (0,x) et-sq and \emph{ erfx(x)} - = 1.0 - \emph{erf(x)} -. \$x can be a pure number \\
+\&erf(\$x), \&erfc(\$x)  & Error function.
+erf = 2/sqrt(pi) integral (0,x) et-sq and \emph{ erfx(x)}
+ = 1.0 - \emph{erf(x)}. \$x can be a pure number \\ \hline \&ceil(\$x), \&floor(\$x) & Ceil function returns an integer rounded up whereas floor function returns and integer rounded down. If x is an integer than it returns the value of the integer. \$x can be a pure number \\
@@ -48,10 +48,10 @@
\&format(\$x,'nn') & Display or format \$x as nn where nn is nF or nE or nS and n is an integer. \\
\hline

-\&prettyprint(\$x,'nn','optional target') &Display or format \$x as nn where nn is nF or nE or nS and n is an integer. Also supports the first character being a \$, it then will format the result with a a call to \&dollarformat() described below. If the first character is a , it will format it with commas grouping the thousands. In S mode it will fromat the number to the specified number of significant figures and display it in F mode. In E mode it will attempt to generate a pretty x10\^{}3 rather than a E3 following the number, the 'optional target' argument is optional but can be used to force \&prettyprint to generate either 'tex' output, or 'web' output, most people do not need to specify this argument and can leave it blank. \\ +\&prettyprint(\$x,'nn','optional target') &Display or format \$x as nn where nn is nF or nE or nS and n is an integer. Also supports the first character being a \$, it then will format the result with a a call to \&dollarformat() described below. If the first character is a , it will format it with commas grouping the thousands. In S mode it will fromat the number to the specified number of significant figures and display it in F mode. In E mode it will attempt to generate a pretty x10\^{}3 rather than a E3 following the number, the 'optional target' argument is optional but can be used to force \&prettyprint to generate either 'tex' output, or 'web' output, most people do not need to specify this argument and can leave it blank.\\
\hline

-\&dollarformat(\$x,'optional target') & Reformats \$x to have a \$(or$\backslash$\$ if in tex mode) and to have , grouping thousands. The 'optional target' argument is optional but can be used to force \&prettyprint to generate either 'tex' output, or 'web' output, most people do not need to specify this argument and can leave it blank. \\
+\&dollarformat(\$x,'optional target') & Reformats \$x to have a \$(or$\backslash$\$ if in tex mode) and to have , grouping thousands. The 'optional target' argument is optional but can be used to force \&prettyprint to generate either 'tex' output, or 'web' output, most people do not need to specify this argument and can leave it blank.\\
\hline

\&roundto(\$x,\$n)  & Rounds a real number to n decimal points. \$x and \$n can be pure numbers \\
@@ -118,7 +118,7 @@

\&name(), \&student\_number()  & Return the full name in the following format: lastname, firstname initial. Student\_number returns the student 9-alphanumeric string. If undefined, the functions return null. \\
\hline
-\&check\_status(\$partid) &Returns a number identifing the current status of a part. Ture values mean that a part is done'' (either unanswerable becuase of tries exhuastion, or correct) or a false value if a part can still be attempted. If \$part is unspecfied, it will check either the current $<$part$>$'s status or if outside of a $<$part$>$, check the status of previous $<$part$>$. The full set of return codes are: 'undef' means it is unattempted, 0 means it is attmpted and wrong but still has tries, 1 means it is marked correct, 2 means they have exceed maximum number of tries, 3 means it after the answer date   \\
+\&check\_status(\$partid) &Returns a number identifing the current status of a part. Ture values mean that a part is done'' (either unanswerable becuase of tries exhuastion, or correct) or a false value if a part can still be attempted. If \$part is unspecfied, it will check either the current $<$part$>$'s status or if outside of a $<$part$>$, check the status of previous $<$part$>$. The full set of return codes are: 'undef' means it is unattempted, 0 means it is attmpted and wrong but still has tries, 1 means it is marked correct, 2 means they have exceed maximum number of tries, 3 means it after the answer date\\
\hline
\&open\_date(), \&due\_date(), \&answer\_date()  & Problem open date, due date and answer date. The time is also included in 24-hr format. \\
\hline
@@ -127,7 +127,7 @@
\hline

\&sub\_string(\$a,\$b,\$c) -perl substr function. However, note the differences & Retrieve a portion of string a starting from b and length c. For example, \$a = Welcome to LON-CAPA''; \$result=\&sub\_string(\$a,4,4); then \$result is come'' \\ +perl substr function. However, note the differences & Retrieve a portion of string a starting from b and length c. For example, \$a = Welcome to LON-CAPA''; \$result=\&sub\_string(\$a,4,4); then \\$result is come'' \\
\hline

@arrayname
@@ -137,7 +137,7 @@
@B=\&array\_moments(@A)  & Evaluates the moments of an array A and place the result in array B[i] where i = 0 to 4. The contents of B are as follows: B[0] = number of elements, B[1] = mean, B[2] = variance, B[3] = skewness and B[4] = kurtosis. \\
\hline

-\&min(@Name), \&max(@Name)  & In LON-CAPA to find the maximum value of an array, use \&max(@arrayname)  and to find the minimum value of an array, use \&min(@arrayname) \\
+\&min(@Name), \&max(@Name)  & In LON-CAPA to find the maximum value of an array, use \&max(@arrayname) and to find the minimum value of an array, use \&min(@arrayname) \\
\hline

undef @name  & To destroy the contents of an array, use \\