Improve manual for table formulas

* doc/org.texi (Field coordinates in formulas): Rephrase and add an
example with a Lisp formula to copy from remote table.
This commit is contained in:
Michael Brand 2013-10-06 19:01:15 +02:00 committed by Carsten Dominik
parent aff4f10d79
commit 9bbdd22045
1 changed files with 20 additions and 13 deletions

View File

@ -2551,21 +2551,28 @@ for Calc}.
@cindex row, of field coordinates
@cindex column, of field coordinates
For Calc formulas and Lisp formulas @code{@@#} and @code{$#} can be used to
get the row or column number of the field where the formula result goes.
The traditional Lisp formula equivalents are @code{org-table-current-dline}
and @code{org-table-current-column}. Examples:
One of the very first actions during evaluation of Calc formulas and Lisp
formulas is to substitute @code{@@#} and @code{$#} in the formula with the
row or column number of the field where the current result will go to. The
traditional Lisp formula equivalents are @code{org-table-current-dline} and
@code{org-table-current-column}. Examples:
@example
if(@@# % 2, $#, string("")) @r{column number on odd lines only}
$3 = remote(FOO, @@@@#$2) @r{copy column 2 from table FOO into}
@r{column 3 of the current table}
@end example
@table @code
@item if(@@# % 2, $#, string(""))
Insert column number on odd rows, set field to empty on even rows.
@item $2 = '(identity remote(FOO, @@@@#$1))
Copy text or values of each row of column 1 of the table named @code{FOO}
into column 2 of the current table.
@item @@3 = 2 * remote(FOO, @@1$$#)
Insert the doubled value of each column of row 1 of the table named
@code{FOO} into row 3 of the current table.
@end table
@noindent For the second example, table FOO must have at least as many rows
as the current table. Note that this is inefficient@footnote{The computation time scales as
O(N^2) because table FOO is parsed for each field to be copied.} for large
number of rows.
@noindent For the second/third example, the table named @code{FOO} must have
at least as many rows/columns as the current table. Note that this is
inefficient@footnote{The computation time scales as O(N^2) because the table
named @code{FOO} is parsed for each field to be read.} for large number of
rows/columns.
@subsubheading Named references
@cindex named references