2008-11-23 Carsten Dominik <carsten.dominik@gmail.com>
[bpt/emacs.git] / lisp / org / org-table.el
CommitLineData
20908596
CD
1;;; org-table.el --- The table editor for Org-mode
2
3;; Copyright (C) 2004, 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
4
5;; Author: Carsten Dominik <carsten at orgmode dot org>
6;; Keywords: outlines, hypermedia, calendar, wp
7;; Homepage: http://orgmode.org
ce4fdcb9 8;; Version: 6.13
20908596
CD
9;;
10;; This file is part of GNU Emacs.
11;;
b1fc2b50 12;; GNU Emacs is free software: you can redistribute it and/or modify
20908596 13;; it under the terms of the GNU General Public License as published by
b1fc2b50
GM
14;; the Free Software Foundation, either version 3 of the License, or
15;; (at your option) any later version.
20908596
CD
16
17;; GNU Emacs is distributed in the hope that it will be useful,
18;; but WITHOUT ANY WARRANTY; without even the implied warranty of
19;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20;; GNU General Public License for more details.
21
22;; You should have received a copy of the GNU General Public License
b1fc2b50 23;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
20908596
CD
24;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
25;;
26;;; Commentary:
27
28;; This file contains the table editor and spreadsheed for Org-mode.
29
30;; Watch out: Here we are talking about two different kind of tables.
31;; Most of the code is for the tables created with the Org-mode table editor.
32;; Sometimes, we talk about tables created and edited with the table.el
33;; Emacs package. We call the former org-type tables, and the latter
34;; table.el-type tables.
35
36;;; Code:
37
38(eval-when-compile
39 (require 'cl))
40(require 'org)
41
42(declare-function org-table-clean-before-export "org-exp" (lines))
43(declare-function org-format-org-table-html "org-exp" (lines &optional splice))
44(defvar orgtbl-mode) ; defined below
45(defvar orgtbl-mode-menu) ; defined when orgtbl mode get initialized
71d35b24 46(defvar org-export-html-table-tag) ; defined in org-exp.el
20908596
CD
47(defvar constants-unit-system)
48
49(defcustom orgtbl-optimized (eq org-enable-table-editor 'optimized)
50 "Non-nil means, use the optimized table editor version for `orgtbl-mode'.
51In the optimized version, the table editor takes over all simple keys that
52normally just insert a character. In tables, the characters are inserted
53in a way to minimize disturbing the table structure (i.e. in overwrite mode
54for empty fields). Outside tables, the correct binding of the keys is
55restored.
56
57The default for this option is t if the optimized version is also used in
58Org-mode. See the variable `org-enable-table-editor' for details. Changing
59this variable requires a restart of Emacs to become effective."
60 :group 'org-table
61 :type 'boolean)
62
63(defcustom orgtbl-radio-table-templates
64 '((latex-mode "% BEGIN RECEIVE ORGTBL %n
65% END RECEIVE ORGTBL %n
66\\begin{comment}
67#+ORGTBL: SEND %n orgtbl-to-latex :splice nil :skip 0
68| | |
69\\end{comment}\n")
70 (texinfo-mode "@c BEGIN RECEIVE ORGTBL %n
71@c END RECEIVE ORGTBL %n
72@ignore
73#+ORGTBL: SEND %n orgtbl-to-html :splice nil :skip 0
74| | |
75@end ignore\n")
76 (html-mode "<!-- BEGIN RECEIVE ORGTBL %n -->
77<!-- END RECEIVE ORGTBL %n -->
78<!--
79#+ORGTBL: SEND %n orgtbl-to-html :splice nil :skip 0
80| | |
81-->\n"))
82 "Templates for radio tables in different major modes.
83All occurrences of %n in a template will be replaced with the name of the
84table, obtained by prompting the user."
85 :group 'org-table
86 :type '(repeat
87 (list (symbol :tag "Major mode")
88 (string :tag "Format"))))
89
90(defgroup org-table-settings nil
91 "Settings for tables in Org-mode."
92 :tag "Org Table Settings"
93 :group 'org-table)
94
95(defcustom org-table-default-size "5x2"
96 "The default size for newly created tables, Columns x Rows."
97 :group 'org-table-settings
98 :type 'string)
99
100(defcustom org-table-number-regexp
101 "^\\([<>]?[-+^.0-9]*[0-9][-+^.0-9eEdDx()%:]*\\|\\(0[xX]\\)[0-9a-fA-F]+\\|nan\\)$"
102 "Regular expression for recognizing numbers in table columns.
103If a table column contains mostly numbers, it will be aligned to the
104right. If not, it will be aligned to the left.
105
106The default value of this option is a regular expression which allows
107anything which looks remotely like a number as used in scientific
108context. For example, all of the following will be considered a
109number:
110 12 12.2 2.4e-08 2x10^12 4.034+-0.02 2.7(10) >3.5
111
112Other options offered by the customize interface are more restrictive."
113 :group 'org-table-settings
114 :type '(choice
115 (const :tag "Positive Integers"
116 "^[0-9]+$")
117 (const :tag "Integers"
118 "^[-+]?[0-9]+$")
119 (const :tag "Floating Point Numbers"
120 "^[-+]?\\([0-9]*\\.[0-9]+\\|[0-9]+\\.[0-9]*\\)$")
121 (const :tag "Floating Point Number or Integer"
122 "^[-+]?\\([0-9]*\\.[0-9]+\\|[0-9]+\\.?[0-9]*\\)$")
123 (const :tag "Exponential, Floating point, Integer"
124 "^[-+]?[0-9.]+\\([eEdD][-+0-9]+\\)?$")
125 (const :tag "Very General Number-Like, including hex"
126 "^\\([<>]?[-+^.0-9]*[0-9][-+^.0-9eEdDx()%]*\\|\\(0[xX]\\)[0-9a-fA-F]+\\|nan\\)$")
127 (string :tag "Regexp:")))
128
129(defcustom org-table-number-fraction 0.5
130 "Fraction of numbers in a column required to make the column align right.
131In a column all non-white fields are considered. If at least this
132fraction of fields is matched by `org-table-number-fraction',
133alignment to the right border applies."
134 :group 'org-table-settings
135 :type 'number)
136
137(defgroup org-table-editing nil
138 "Behavior of tables during editing in Org-mode."
139 :tag "Org Table Editing"
140 :group 'org-table)
141
142(defcustom org-table-automatic-realign t
143 "Non-nil means, automatically re-align table when pressing TAB or RETURN.
144When nil, aligning is only done with \\[org-table-align], or after column
145removal/insertion."
146 :group 'org-table-editing
147 :type 'boolean)
148
149(defcustom org-table-auto-blank-field t
150 "Non-nil means, automatically blank table field when starting to type into it.
151This only happens when typing immediately after a field motion
152command (TAB, S-TAB or RET).
153Only relevant when `org-enable-table-editor' is equal to `optimized'."
154 :group 'org-table-editing
155 :type 'boolean)
156
157(defcustom org-table-tab-jumps-over-hlines t
158 "Non-nil means, tab in the last column of a table with jump over a hline.
159If a horizontal separator line is following the current line,
160`org-table-next-field' can either create a new row before that line, or jump
161over the line. When this option is nil, a new line will be created before
162this line."
163 :group 'org-table-editing
164 :type 'boolean)
165
166(defgroup org-table-calculation nil
167 "Options concerning tables in Org-mode."
168 :tag "Org Table Calculation"
169 :group 'org-table)
170
171(defcustom org-table-use-standard-references t
172 "Should org-mode work with table refrences like B3 instead of @3$2?
173Possible values are:
174nil never use them
175from accept as input, do not present for editing
176t: accept as input and present for editing"
177 :group 'org-table-calculation
178 :type '(choice
179 (const :tag "Never, don't even check user input for them" nil)
180 (const :tag "Always, both as user input, and when editing" t)
181 (const :tag "Convert user input, don't offer during editing" 'from)))
182
183(defcustom org-table-copy-increment t
184 "Non-nil means, increment when copying current field with \\[org-table-copy-down]."
185 :group 'org-table-calculation
186 :type 'boolean)
187
188(defcustom org-calc-default-modes
189 '(calc-internal-prec 12
b349f79f 190 calc-float-format (float 8)
20908596
CD
191 calc-angle-mode deg
192 calc-prefer-frac nil
193 calc-symbolic-mode nil
621f83e4 194 calc-date-format (YYYY "-" MM "-" DD " " Www (" " hh ":" mm))
20908596
CD
195 calc-display-working-message t
196 )
197 "List with Calc mode settings for use in calc-eval for table formulas.
198The list must contain alternating symbols (Calc modes variables and values).
199Don't remove any of the default settings, just change the values. Org-mode
200relies on the variables to be present in the list."
201 :group 'org-table-calculation
202 :type 'plist)
203
204(defcustom org-table-formula-evaluate-inline t
205 "Non-nil means, TAB and RET evaluate a formula in current table field.
206If the current field starts with an equal sign, it is assumed to be a formula
207which should be evaluated as described in the manual and in the documentation
208string of the command `org-table-eval-formula'. This feature requires the
209Emacs calc package.
210When this variable is nil, formula calculation is only available through
211the command \\[org-table-eval-formula]."
212 :group 'org-table-calculation
213 :type 'boolean)
214
215(defcustom org-table-formula-use-constants t
216 "Non-nil means, interpret constants in formulas in tables.
217A constant looks like `$c' or `$Grav' and will be replaced before evaluation
218by the value given in `org-table-formula-constants', or by a value obtained
219from the `constants.el' package."
220 :group 'org-table-calculation
221 :type 'boolean)
222
223(defcustom org-table-formula-constants nil
224 "Alist with constant names and values, for use in table formulas.
225The car of each element is a name of a constant, without the `$' before it.
226The cdr is the value as a string. For example, if you'd like to use the
227speed of light in a formula, you would configure
228
229 (setq org-table-formula-constants '((\"c\" . \"299792458.\")))
230
231and then use it in an equation like `$1*$c'.
232
233Constants can also be defined on a per-file basis using a line like
234
235#+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6"
236 :group 'org-table-calculation
237 :type '(repeat
238 (cons (string :tag "name")
239 (string :tag "value"))))
240
241(defcustom org-table-allow-automatic-line-recalculation t
242 "Non-nil means, lines marked with |#| or |*| will be recomputed automatically.
243Automatically means, when TAB or RET or C-c C-c are pressed in the line."
244 :group 'org-table-calculation
245 :type 'boolean)
246
247(defgroup org-table-import-export nil
248 "Options concerning table import and export in Org-mode."
249 :tag "Org Table Import Export"
250 :group 'org-table)
251
b349f79f 252(defcustom org-table-export-default-format "orgtbl-to-tsv"
20908596 253 "Default export parameters for org-table-export. These can be
b349f79f
CD
254overridden on for a specific table by setting the TABLE_EXPORT_FORMAT
255property. See the manual section on orgtbl radio tables for the different
256export transformations and available parameters."
20908596
CD
257 :group 'org-table-import-export
258 :type 'string)
259
260(defconst org-table-auto-recalculate-regexp "^[ \t]*| *# *\\(|\\|$\\)"
261 "Detects a table line marked for automatic recalculation.")
262(defconst org-table-recalculate-regexp "^[ \t]*| *[#*] *\\(|\\|$\\)"
263 "Detects a table line marked for automatic recalculation.")
264(defconst org-table-calculate-mark-regexp "^[ \t]*| *[!$^_#*] *\\(|\\|$\\)"
265 "Detects a table line marked for automatic recalculation.")
266(defconst org-table-border-regexp "^[ \t]*[^| \t]"
267 "Searching from within a table (any type) this finds the first line
268outside the table.")
269(defvar org-table-last-highlighted-reference nil)
270(defvar org-table-formula-history nil)
271
272(defvar org-table-column-names nil
273 "Alist with column names, derived from the `!' line.")
274(defvar org-table-column-name-regexp nil
275 "Regular expression matching the current column names.")
276(defvar org-table-local-parameters nil
277 "Alist with parameter names, derived from the `$' line.")
278(defvar org-table-named-field-locations nil
279 "Alist with locations of named fields.")
280
281(defvar org-table-current-line-types nil
282 "Table row types, non-nil only for the duration of a comand.")
283(defvar org-table-current-begin-line nil
284 "Table begin line, non-nil only for the duration of a comand.")
285(defvar org-table-current-begin-pos nil
286 "Table begin position, non-nil only for the duration of a comand.")
287(defvar org-table-dlines nil
288 "Vector of data line line numbers in the current table.")
289(defvar org-table-hlines nil
290 "Vector of hline line numbers in the current table.")
291
292(defconst org-table-range-regexp
293 "@\\([-+]?I*[-+]?[0-9]*\\)?\\(\\$[-+]?[0-9]+\\)?\\(\\.\\.@?\\([-+]?I*[-+]?[0-9]*\\)?\\(\\$[-+]?[0-9]+\\)?\\)?"
294 ;; 1 2 3 4 5
295 "Regular expression for matching ranges in formulas.")
296
297(defconst org-table-range-regexp2
298 (concat
299 "\\(" "@[-0-9I$&]+" "\\|" "[a-zA-Z]\\{1,2\\}\\([0-9]+\\|&\\)" "\\|" "\\$[a-zA-Z0-9]+" "\\)"
300 "\\.\\."
301 "\\(" "@?[-0-9I$&]+" "\\|" "[a-zA-Z]\\{1,2\\}\\([0-9]+\\|&\\)" "\\|" "\\$[a-zA-Z0-9]+" "\\)")
302 "Match a range for reference display.")
303
304(defconst org-table-translate-regexp
305 (concat "\\(" "@[-0-9I$]+" "\\|" "[a-zA-Z]\\{1,2\\}\\([0-9]+\\|&\\)" "\\)")
306 "Match a reference that needs translation, for reference display.")
307
308(defun org-table-create-with-table.el ()
309 "Use the table.el package to insert a new table.
310If there is already a table at point, convert between Org-mode tables
311and table.el tables."
312 (interactive)
313 (require 'table)
314 (cond
315 ((org-at-table.el-p)
316 (if (y-or-n-p "Convert table to Org-mode table? ")
317 (org-table-convert)))
318 ((org-at-table-p)
319 (if (y-or-n-p "Convert table to table.el table? ")
320 (org-table-convert)))
321 (t (call-interactively 'table-insert))))
322
323(defun org-table-create-or-convert-from-region (arg)
324 "Convert region to table, or create an empty table.
325If there is an active region, convert it to a table, using the function
326`org-table-convert-region'. See the documentation of that function
327to learn how the prefix argument is interpreted to determine the field
328separator.
329If there is no such region, create an empty table with `org-table-create'."
330 (interactive "P")
331 (if (org-region-active-p)
332 (org-table-convert-region (region-beginning) (region-end) arg)
333 (org-table-create arg)))
334
335(defun org-table-create (&optional size)
336 "Query for a size and insert a table skeleton.
337SIZE is a string Columns x Rows like for example \"3x2\"."
338 (interactive "P")
339 (unless size
340 (setq size (read-string
341 (concat "Table size Columns x Rows [e.g. "
342 org-table-default-size "]: ")
343 "" nil org-table-default-size)))
344
345 (let* ((pos (point))
346 (indent (make-string (current-column) ?\ ))
347 (split (org-split-string size " *x *"))
348 (rows (string-to-number (nth 1 split)))
349 (columns (string-to-number (car split)))
350 (line (concat (apply 'concat indent "|" (make-list columns " |"))
351 "\n")))
352 (if (string-match "^[ \t]*$" (buffer-substring-no-properties
353 (point-at-bol) (point)))
354 (beginning-of-line 1)
355 (newline))
356 ;; (mapcar (lambda (x) (insert line)) (make-list rows t))
357 (dotimes (i rows) (insert line))
358 (goto-char pos)
359 (if (> rows 1)
360 ;; Insert a hline after the first row.
361 (progn
362 (end-of-line 1)
363 (insert "\n|-")
364 (goto-char pos)))
365 (org-table-align)))
366
367(defun org-table-convert-region (beg0 end0 &optional separator)
368 "Convert region to a table.
369The region goes from BEG0 to END0, but these borders will be moved
370slightly, to make sure a beginning of line in the first line is included.
371
372SEPARATOR specifies the field separator in the lines. It can have the
373following values:
374
375'(4) Use the comma as a field separator
376'(16) Use a TAB as field separator
377integer When a number, use that many spaces as field separator
378nil When nil, the command tries to be smart and figure out the
379 separator in the following way:
380 - when each line contains a TAB, assume TAB-separated material
381 - when each line contains a comme, assume CSV material
40ac2137 382 - else, assume one or more SPACE characters as separator."
20908596
CD
383 (interactive "rP")
384 (let* ((beg (min beg0 end0))
385 (end (max beg0 end0))
386 re)
387 (goto-char beg)
388 (beginning-of-line 1)
389 (setq beg (move-marker (make-marker) (point)))
390 (goto-char end)
391 (if (bolp) (backward-char 1) (end-of-line 1))
392 (setq end (move-marker (make-marker) (point)))
393 ;; Get the right field separator
394 (unless separator
395 (goto-char beg)
396 (setq separator
397 (cond
398 ((not (re-search-forward "^[^\n\t]+$" end t)) '(16))
399 ((not (re-search-forward "^[^\n,]+$" end t)) '(4))
400 (t 1))))
401 (setq re (cond
402 ((equal separator '(4)) "^\\|\"?[ \t]*,[ \t]*\"?")
403 ((equal separator '(16)) "^\\|\t")
404 ((integerp separator)
405 (format "^ *\\| *\t *\\| \\{%d,\\}" separator))
406 (t (error "This should not happen"))))
407 (goto-char beg)
408 (while (re-search-forward re end t)
409 (replace-match "| " t t))
410 (goto-char beg)
411 (insert " ")
412 (org-table-align)))
413
414(defun org-table-import (file arg)
415 "Import FILE as a table.
416The file is assumed to be tab-separated. Such files can be produced by most
417spreadsheet and database applications. If no tabs (at least one per line)
418are found, lines will be split on whitespace into fields."
419 (interactive "f\nP")
420 (or (bolp) (newline))
421 (let ((beg (point))
422 (pm (point-max)))
423 (insert-file-contents file)
424 (org-table-convert-region beg (+ (point) (- (point-max) pm)) arg)))
425
426
427(defvar org-table-last-alignment)
428(defvar org-table-last-column-widths)
429(defun org-table-export (&optional file format)
b349f79f 430 "Export table to a file, with configurable format.
20908596
CD
431Such a file can be imported into a spreadsheet program like Excel.
432FILE can be the output file name. If not given, it will be taken from
433a TABLE_EXPORT_FILE property in the current entry or higher up in the
434hierarchy, or the user will be prompted for a file name.
435FORMAT can be an export format, of the same kind as it used when
436orgtbl-mode sends a table in a different format. The default format can
437be found in the variable `org-table-export-default-format', but the function
438first checks if there is an export format specified in a TABLE_EXPORT_FORMAT
439property, locally or anywhere up in the hierarchy."
440 (interactive)
b349f79f
CD
441 (unless (org-at-table-p)
442 (error "No table at point"))
443 (require 'org-exp)
20908596
CD
444 (org-table-align) ;; make sure we have everything we need
445 (let* ((beg (org-table-begin))
446 (end (org-table-end))
447 (txt (buffer-substring-no-properties beg end))
2c3ad40d
CD
448 (file (or file
449 (condition-case nil
450 (org-entry-get beg "TABLE_EXPORT_FILE" t)
451 (error nil))))
452 (format (or format
453 (condition-case nil
454 (org-entry-get beg "TABLE_EXPORT_FORMAT" t)
455 (error nil))))
b349f79f
CD
456 buf deffmt-readable)
457 (unless file
458 (setq file (read-file-name "Export table to: "))
459 (unless (or (not (file-exists-p file))
460 (y-or-n-p (format "Overwrite file %s? " file)))
461 (error "Abort")))
462 (if (file-directory-p file)
463 (error "This is a directory path, not a file"))
464 (if (equal (file-truename file)
465 (file-truename (buffer-file-name)))
466 (error "Please specify a file name that is different from current"))
467 (unless format
468 (setq deffmt-readable org-table-export-default-format)
469 (while (string-match "\t" deffmt-readable)
470 (setq deffmt-readable (replace-match "\\t" t t deffmt-readable)))
471 (while (string-match "\n" deffmt-readable)
472 (setq deffmt-readable (replace-match "\\n" t t deffmt-readable)))
2c3ad40d
CD
473 (setq format (org-completing-read
474 "Format: "
475 '("orgtbl-to-tsv" "orgtbl-to-csv"
476 "orgtbl-to-latex" "orgtbl-to-html"
477 "orgtbl-to-generic" "orgtbl-to-texinfo"
478 "orgtbl-to-orgtbl") nil nil
479 deffmt-readable)))
20908596
CD
480 (if (string-match "\\([^ \t\r\n]+\\)\\( +.*\\)?" format)
481 (let* ((transform (intern (match-string 1 format)))
482 (params (if (match-end 2)
483 (read (concat "(" (match-string 2 format) ")"))))
484 (skip (plist-get params :skip))
485 (skipcols (plist-get params :skipcols))
486 (lines (nthcdr (or skip 0) (org-split-string txt "[ \t]*\n[ \t]*")))
487 (lines (org-table-clean-before-export lines))
488 (i0 (if org-table-clean-did-remove-column 2 1))
489 (table (mapcar
490 (lambda (x)
491 (if (string-match org-table-hline-regexp x)
492 'hline
493 (org-remove-by-index
494 (org-split-string (org-trim x) "\\s-*|\\s-*")
495 skipcols i0)))
496 lines))
497 (fun (if (= i0 2) 'cdr 'identity))
498 (org-table-last-alignment
499 (org-remove-by-index (funcall fun org-table-last-alignment)
500 skipcols i0))
501 (org-table-last-column-widths
502 (org-remove-by-index (funcall fun org-table-last-column-widths)
503 skipcols i0)))
504
505 (unless (fboundp transform)
506 (error "No such transformation function %s" transform))
507 (setq txt (funcall transform table params))
508
509 (with-current-buffer (find-file-noselect file)
510 (setq buf (current-buffer))
511 (erase-buffer)
512 (fundamental-mode)
513 (insert txt "\n")
514 (save-buffer))
515 (kill-buffer buf)
516 (message "Export done."))
517 (error "TABLE_EXPORT_FORMAT invalid"))))
518
519(defvar org-table-aligned-begin-marker (make-marker)
520 "Marker at the beginning of the table last aligned.
521Used to check if cursor still is in that table, to minimize realignment.")
522(defvar org-table-aligned-end-marker (make-marker)
523 "Marker at the end of the table last aligned.
524Used to check if cursor still is in that table, to minimize realignment.")
525(defvar org-table-last-alignment nil
526 "List of flags for flushright alignment, from the last re-alignment.
527This is being used to correctly align a single field after TAB or RET.")
528(defvar org-table-last-column-widths nil
529 "List of max width of fields in each column.
530This is being used to correctly align a single field after TAB or RET.")
531(defvar org-table-formula-debug nil
532 "Non-nil means, debug table formulas.
533When nil, simply write \"#ERROR\" in corrupted fields.")
534(make-variable-buffer-local 'org-table-formula-debug)
535(defvar org-table-overlay-coordinates nil
536 "Overlay coordinates after each align of a table.")
537(make-variable-buffer-local 'org-table-overlay-coordinates)
538
539(defvar org-last-recalc-line nil)
540(defconst org-narrow-column-arrow "=>"
541 "Used as display property in narrowed table columns.")
542
543(defun org-table-align ()
544 "Align the table at point by aligning all vertical bars."
545 (interactive)
546 (let* (
547 ;; Limits of table
548 (beg (org-table-begin))
549 (end (org-table-end))
550 ;; Current cursor position
551 (linepos (org-current-line))
552 (colpos (org-table-current-column))
553 (winstart (window-start))
554 (winstartline (org-current-line (min winstart (1- (point-max)))))
555 lines (new "") lengths l typenums ty fields maxfields i
556 column
557 (indent "") cnt frac
558 rfmt hfmt
559 (spaces '(1 . 1))
560 (sp1 (car spaces))
561 (sp2 (cdr spaces))
562 (rfmt1 (concat
563 (make-string sp2 ?\ ) "%%%s%ds" (make-string sp1 ?\ ) "|"))
564 (hfmt1 (concat
565 (make-string sp2 ?-) "%s" (make-string sp1 ?-) "+"))
566 emptystrings links dates emph narrow fmax f1 len c e)
567 (untabify beg end)
568 (remove-text-properties beg end '(org-cwidth t org-dwidth t display t))
569 ;; Check if we have links or dates
570 (goto-char beg)
571 (setq links (re-search-forward org-bracket-link-regexp end t))
572 (goto-char beg)
573 (setq emph (and org-hide-emphasis-markers
574 (re-search-forward org-emph-re end t)))
575 (goto-char beg)
576 (setq dates (and org-display-custom-times
577 (re-search-forward org-ts-regexp-both end t)))
578 ;; Make sure the link properties are right
579 (when links (goto-char beg) (while (org-activate-bracket-links end)))
580 ;; Make sure the date properties are right
581 (when dates (goto-char beg) (while (org-activate-dates end)))
582 (when emph (goto-char beg) (while (org-do-emphasis-faces end)))
583
584 ;; Check if we are narrowing any columns
585 (goto-char beg)
586 (setq narrow (and org-format-transports-properties-p
587 (re-search-forward "<[0-9]+>" end t)))
588 ;; Get the rows
589 (setq lines (org-split-string
590 (buffer-substring beg end) "\n"))
591 ;; Store the indentation of the first line
592 (if (string-match "^ *" (car lines))
593 (setq indent (make-string (- (match-end 0) (match-beginning 0)) ?\ )))
594 ;; Mark the hlines by setting the corresponding element to nil
595 ;; At the same time, we remove trailing space.
596 (setq lines (mapcar (lambda (l)
597 (if (string-match "^ *|-" l)
598 nil
599 (if (string-match "[ \t]+$" l)
600 (substring l 0 (match-beginning 0))
601 l)))
602 lines))
603 ;; Get the data fields by splitting the lines.
604 (setq fields (mapcar
605 (lambda (l)
606 (org-split-string l " *| *"))
607 (delq nil (copy-sequence lines))))
608 ;; How many fields in the longest line?
609 (condition-case nil
610 (setq maxfields (apply 'max (mapcar 'length fields)))
611 (error
612 (kill-region beg end)
613 (org-table-create org-table-default-size)
614 (error "Empty table - created default table")))
615 ;; A list of empty strings to fill any short rows on output
616 (setq emptystrings (make-list maxfields ""))
617 ;; Check for special formatting.
618 (setq i -1)
619 (while (< (setq i (1+ i)) maxfields) ;; Loop over all columns
620 (setq column (mapcar (lambda (x) (or (nth i x) "")) fields))
621 ;; Check if there is an explicit width specified
622 (when narrow
623 (setq c column fmax nil)
624 (while c
625 (setq e (pop c))
626 (if (and (stringp e) (string-match "^<\\([0-9]+\\)>$" e))
627 (setq fmax (string-to-number (match-string 1 e)) c nil)))
628 ;; Find fields that are wider than fmax, and shorten them
629 (when fmax
630 (loop for xx in column do
631 (when (and (stringp xx)
632 (> (org-string-width xx) fmax))
633 (org-add-props xx nil
634 'help-echo
635 (concat "Clipped table field, use C-c ` to edit. Full value is:\n" (org-no-properties (copy-sequence xx))))
636 (setq f1 (min fmax (or (string-match org-bracket-link-regexp xx) fmax)))
637 (unless (> f1 1)
638 (error "Cannot narrow field starting with wide link \"%s\""
639 (match-string 0 xx)))
640 (add-text-properties f1 (length xx) (list 'org-cwidth t) xx)
641 (add-text-properties (- f1 2) f1
642 (list 'display org-narrow-column-arrow)
643 xx)))))
644 ;; Get the maximum width for each column
645 (push (apply 'max 1 (mapcar 'org-string-width column)) lengths)
646 ;; Get the fraction of numbers, to decide about alignment of the column
647 (setq cnt 0 frac 0.0)
648 (loop for x in column do
649 (if (equal x "")
650 nil
651 (setq frac ( / (+ (* frac cnt)
652 (if (string-match org-table-number-regexp x) 1 0))
653 (setq cnt (1+ cnt))))))
654 (push (>= frac org-table-number-fraction) typenums))
655 (setq lengths (nreverse lengths) typenums (nreverse typenums))
656
657 ;; Store the alignment of this table, for later editing of single fields
658 (setq org-table-last-alignment typenums
659 org-table-last-column-widths lengths)
660
661 ;; With invisible characters, `format' does not get the field width right
662 ;; So we need to make these fields wide by hand.
663 (when (or links emph)
664 (loop for i from 0 upto (1- maxfields) do
665 (setq len (nth i lengths))
666 (loop for j from 0 upto (1- (length fields)) do
667 (setq c (nthcdr i (car (nthcdr j fields))))
668 (if (and (stringp (car c))
669 (text-property-any 0 (length (car c)) 'invisible 'org-link (car c))
670; (string-match org-bracket-link-regexp (car c))
671 (< (org-string-width (car c)) len))
672 (setcar c (concat (car c) (make-string (- len (org-string-width (car c))) ?\ )))))))
673
674 ;; Compute the formats needed for output of the table
675 (setq rfmt (concat indent "|") hfmt (concat indent "|"))
676 (while (setq l (pop lengths))
677 (setq ty (if (pop typenums) "" "-")) ; number types flushright
678 (setq rfmt (concat rfmt (format rfmt1 ty l))
679 hfmt (concat hfmt (format hfmt1 (make-string l ?-)))))
680 (setq rfmt (concat rfmt "\n")
681 hfmt (concat (substring hfmt 0 -1) "|\n"))
682
683 (setq new (mapconcat
684 (lambda (l)
685 (if l (apply 'format rfmt
686 (append (pop fields) emptystrings))
687 hfmt))
688 lines ""))
689 ;; Replace the old one
690 (delete-region beg end)
691 (move-marker end nil)
692 (move-marker org-table-aligned-begin-marker (point))
693 (insert new)
694 (move-marker org-table-aligned-end-marker (point))
695 (when (and orgtbl-mode (not (org-mode-p)))
696 (goto-char org-table-aligned-begin-marker)
697 (while (org-hide-wide-columns org-table-aligned-end-marker)))
698 ;; Try to move to the old location
699 (goto-line winstartline)
700 (setq winstart (point-at-bol))
701 (goto-line linepos)
702 (set-window-start (selected-window) winstart 'noforce)
703 (org-table-goto-column colpos)
704 (and org-table-overlay-coordinates (org-table-overlay-coordinates))
705 (setq org-table-may-need-update nil)
706 ))
707
708
709
710
711
712
713
714
715
716(defun org-table-begin (&optional table-type)
717 "Find the beginning of the table and return its position.
718With argument TABLE-TYPE, go to the beginning of a table.el-type table."
719 (save-excursion
720 (if (not (re-search-backward
721 (if table-type org-table-any-border-regexp
722 org-table-border-regexp)
723 nil t))
724 (progn (goto-char (point-min)) (point))
725 (goto-char (match-beginning 0))
726 (beginning-of-line 2)
727 (point))))
728
729(defun org-table-end (&optional table-type)
730 "Find the end of the table and return its position.
731With argument TABLE-TYPE, go to the end of a table.el-type table."
732 (save-excursion
733 (if (not (re-search-forward
734 (if table-type org-table-any-border-regexp
735 org-table-border-regexp)
736 nil t))
737 (goto-char (point-max))
738 (goto-char (match-beginning 0)))
739 (point-marker)))
740
741(defun org-table-justify-field-maybe (&optional new)
742 "Justify the current field, text to left, number to right.
743Optional argument NEW may specify text to replace the current field content."
744 (cond
745 ((and (not new) org-table-may-need-update)) ; Realignment will happen anyway
746 ((org-at-table-hline-p))
747 ((and (not new)
748 (or (not (equal (marker-buffer org-table-aligned-begin-marker)
749 (current-buffer)))
750 (< (point) org-table-aligned-begin-marker)
751 (>= (point) org-table-aligned-end-marker)))
752 ;; This is not the same table, force a full re-align
753 (setq org-table-may-need-update t))
754 (t ;; realign the current field, based on previous full realign
755 (let* ((pos (point)) s
756 (col (org-table-current-column))
757 (num (if (> col 0) (nth (1- col) org-table-last-alignment)))
758 l f n o e)
759 (when (> col 0)
760 (skip-chars-backward "^|\n")
761 (if (looking-at " *\\([^|\n]*?\\) *\\(|\\|$\\)")
762 (progn
763 (setq s (match-string 1)
764 o (match-string 0)
765 l (max 1 (- (match-end 0) (match-beginning 0) 3))
766 e (not (= (match-beginning 2) (match-end 2))))
767 (setq f (format (if num " %%%ds %s" " %%-%ds %s")
768 l (if e "|" (setq org-table-may-need-update t) ""))
769 n (format f s))
770 (if new
771 (if (<= (length new) l) ;; FIXME: length -> str-width?
772 (setq n (format f new))
773 (setq n (concat new "|") org-table-may-need-update t)))
774 (or (equal n o)
775 (let (org-table-may-need-update)
776 (replace-match n t t))))
777 (setq org-table-may-need-update t))
778 (goto-char pos))))))
779
780(defun org-table-next-field ()
781 "Go to the next field in the current table, creating new lines as needed.
782Before doing so, re-align the table if necessary."
783 (interactive)
784 (org-table-maybe-eval-formula)
785 (org-table-maybe-recalculate-line)
786 (if (and org-table-automatic-realign
787 org-table-may-need-update)
788 (org-table-align))
789 (let ((end (org-table-end)))
790 (if (org-at-table-hline-p)
791 (end-of-line 1))
792 (condition-case nil
793 (progn
794 (re-search-forward "|" end)
795 (if (looking-at "[ \t]*$")
796 (re-search-forward "|" end))
797 (if (and (looking-at "-")
798 org-table-tab-jumps-over-hlines
799 (re-search-forward "^[ \t]*|\\([^-]\\)" end t))
800 (goto-char (match-beginning 1)))
801 (if (looking-at "-")
802 (progn
803 (beginning-of-line 0)
804 (org-table-insert-row 'below))
805 (if (looking-at " ") (forward-char 1))))
806 (error
807 (org-table-insert-row 'below)))))
808
809(defun org-table-previous-field ()
810 "Go to the previous field in the table.
811Before doing so, re-align the table if necessary."
812 (interactive)
813 (org-table-justify-field-maybe)
814 (org-table-maybe-recalculate-line)
815 (if (and org-table-automatic-realign
816 org-table-may-need-update)
817 (org-table-align))
818 (if (org-at-table-hline-p)
819 (end-of-line 1))
820 (re-search-backward "|" (org-table-begin))
821 (re-search-backward "|" (org-table-begin))
822 (while (looking-at "|\\(-\\|[ \t]*$\\)")
823 (re-search-backward "|" (org-table-begin)))
824 (if (looking-at "| ?")
825 (goto-char (match-end 0))))
826
827(defun org-table-next-row ()
828 "Go to the next row (same column) in the current table.
829Before doing so, re-align the table if necessary."
830 (interactive)
831 (org-table-maybe-eval-formula)
832 (org-table-maybe-recalculate-line)
833 (if (or (looking-at "[ \t]*$")
834 (save-excursion (skip-chars-backward " \t") (bolp)))
835 (newline)
836 (if (and org-table-automatic-realign
837 org-table-may-need-update)
838 (org-table-align))
839 (let ((col (org-table-current-column)))
840 (beginning-of-line 2)
841 (if (or (not (org-at-table-p))
842 (org-at-table-hline-p))
843 (progn
844 (beginning-of-line 0)
845 (org-table-insert-row 'below)))
846 (org-table-goto-column col)
847 (skip-chars-backward "^|\n\r")
848 (if (looking-at " ") (forward-char 1)))))
849
850(defun org-table-copy-down (n)
851 "Copy a field down in the current column.
852If the field at the cursor is empty, copy into it the content of the nearest
853non-empty field above. With argument N, use the Nth non-empty field.
854If the current field is not empty, it is copied down to the next row, and
855the cursor is moved with it. Therefore, repeating this command causes the
856column to be filled row-by-row.
857If the variable `org-table-copy-increment' is non-nil and the field is an
858integer or a timestamp, it will be incremented while copying. In the case of
859a timestamp, if the cursor is on the year, change the year. If it is on the
860month or the day, change that. Point will stay on the current date field
861in order to easily repeat the interval."
862 (interactive "p")
863 (let* ((colpos (org-table-current-column))
864 (col (current-column))
865 (field (org-table-get-field))
866 (non-empty (string-match "[^ \t]" field))
867 (beg (org-table-begin))
621f83e4 868 (orig-n n)
20908596
CD
869 txt)
870 (org-table-check-inside-data-field)
871 (if non-empty
872 (progn
873 (setq txt (org-trim field))
874 (org-table-next-row)
875 (org-table-blank-field))
876 (save-excursion
877 (setq txt
878 (catch 'exit
879 (while (progn (beginning-of-line 1)
880 (re-search-backward org-table-dataline-regexp
881 beg t))
882 (org-table-goto-column colpos t)
883 (if (and (looking-at
884 "|[ \t]*\\([^| \t][^|]*?\\)[ \t]*|")
621f83e4 885 (<= (setq n (1- n)) 0))
20908596
CD
886 (throw 'exit (match-string 1))))))))
887 (if txt
888 (progn
889 (if (and org-table-copy-increment
621f83e4
CD
890 (not (equal orig-n 0))
891 (string-match "^[0-9]+$" txt)
892 (< (string-to-number txt) 100000000))
20908596
CD
893 (setq txt (format "%d" (+ (string-to-number txt) 1))))
894 (insert txt)
895 (org-move-to-column col)
896 (if (and org-table-copy-increment (org-at-timestamp-p t))
71d35b24 897 (org-timestamp-up-day)
20908596
CD
898 (org-table-maybe-recalculate-line))
899 (org-table-align)
900 (org-move-to-column col))
901 (error "No non-empty field found"))))
902
903(defun org-table-check-inside-data-field ()
904 "Is point inside a table data field?
905I.e. not on a hline or before the first or after the last column?
906This actually throws an error, so it aborts the current command."
907 (if (or (not (org-at-table-p))
908 (= (org-table-current-column) 0)
909 (org-at-table-hline-p)
910 (looking-at "[ \t]*$"))
911 (error "Not in table data field")))
912
913(defvar org-table-clip nil
914 "Clipboard for table regions.")
915
916(defun org-table-blank-field ()
917 "Blank the current table field or active region."
918 (interactive)
919 (org-table-check-inside-data-field)
920 (if (and (interactive-p) (org-region-active-p))
921 (let (org-table-clip)
922 (org-table-cut-region (region-beginning) (region-end)))
923 (skip-chars-backward "^|")
924 (backward-char 1)
925 (if (looking-at "|[^|\n]+")
926 (let* ((pos (match-beginning 0))
927 (match (match-string 0))
928 (len (org-string-width match)))
929 (replace-match (concat "|" (make-string (1- len) ?\ )))
930 (goto-char (+ 2 pos))
931 (substring match 1)))))
932
933(defun org-table-get-field (&optional n replace)
934 "Return the value of the field in column N of current row.
935N defaults to current field.
936If REPLACE is a string, replace field with this value. The return value
937is always the old value."
938 (and n (org-table-goto-column n))
939 (skip-chars-backward "^|\n")
940 (backward-char 1)
941 (if (looking-at "|[^|\r\n]*")
942 (let* ((pos (match-beginning 0))
943 (val (buffer-substring (1+ pos) (match-end 0))))
944 (if replace
945 (replace-match (concat "|" replace) t t))
946 (goto-char (min (point-at-eol) (+ 2 pos)))
947 val)
948 (forward-char 1) ""))
949
950(defun org-table-field-info (arg)
951 "Show info about the current field, and highlight any reference at point."
952 (interactive "P")
953 (org-table-get-specials)
954 (save-excursion
955 (let* ((pos (point))
956 (col (org-table-current-column))
957 (cname (car (rassoc (int-to-string col) org-table-column-names)))
958 (name (car (rassoc (list (org-current-line) col)
959 org-table-named-field-locations)))
960 (eql (org-table-get-stored-formulas))
961 (dline (org-table-current-dline))
962 (ref (format "@%d$%d" dline col))
963 (ref1 (org-table-convert-refs-to-an ref))
964 (fequation (or (assoc name eql) (assoc ref eql)))
965 (cequation (assoc (int-to-string col) eql))
966 (eqn (or fequation cequation)))
967 (goto-char pos)
968 (condition-case nil
969 (org-table-show-reference 'local)
970 (error nil))
971 (message "line @%d, col $%s%s, ref @%d$%d or %s%s%s"
972 dline col
973 (if cname (concat " or $" cname) "")
974 dline col ref1
975 (if name (concat " or $" name) "")
976 ;; FIXME: formula info not correct if special table line
977 (if eqn
978 (concat ", formula: "
979 (org-table-formula-to-user
980 (concat
981 (if (string-match "^[$@]"(car eqn)) "" "$")
982 (car eqn) "=" (cdr eqn))))
983 "")))))
984
985(defun org-table-current-column ()
986 "Find out which column we are in."
987 (save-excursion
988 (let ((cnt 0) (pos (point)))
989 (beginning-of-line 1)
990 (while (search-forward "|" pos t)
991 (setq cnt (1+ cnt)))
992 cnt)))
993
994(defun org-table-current-dline ()
995 "Find out what table data line we are in.
996Only datalins count for this."
997 (interactive)
998 (if (interactive-p) (org-table-check-inside-data-field))
999 (save-excursion
1000 (let ((cnt 0) (pos (point)))
1001 (goto-char (org-table-begin))
1002 (while (<= (point) pos)
1003 (if (looking-at org-table-dataline-regexp) (setq cnt (1+ cnt)))
1004 (beginning-of-line 2))
1005 (if (interactive-p) (message "This is table line %d" cnt))
1006 cnt)))
1007
1008(defun org-table-goto-column (n &optional on-delim force)
1009 "Move the cursor to the Nth column in the current table line.
1010With optional argument ON-DELIM, stop with point before the left delimiter
1011of the field.
1012If there are less than N fields, just go to after the last delimiter.
1013However, when FORCE is non-nil, create new columns if necessary."
1014 (interactive "p")
1015 (let ((pos (point-at-eol)))
1016 (beginning-of-line 1)
1017 (when (> n 0)
1018 (while (and (> (setq n (1- n)) -1)
1019 (or (search-forward "|" pos t)
1020 (and force
1021 (progn (end-of-line 1)
1022 (skip-chars-backward "^|")
1023 (insert " | "))))))
1024; (backward-char 2) t)))))
1025 (when (and force (not (looking-at ".*|")))
1026 (save-excursion (end-of-line 1) (insert " | ")))
1027 (if on-delim
1028 (backward-char 1)
1029 (if (looking-at " ") (forward-char 1))))))
1030
1031
1032(defun org-table-insert-column ()
1033 "Insert a new column into the table."
1034 (interactive)
1035 (if (not (org-at-table-p))
1036 (error "Not at a table"))
1037 (org-table-find-dataline)
1038 (let* ((col (max 1 (org-table-current-column)))
1039 (beg (org-table-begin))
1040 (end (org-table-end))
1041 ;; Current cursor position
1042 (linepos (org-current-line))
1043 (colpos col))
1044 (goto-char beg)
1045 (while (< (point) end)
1046 (if (org-at-table-hline-p)
1047 nil
1048 (org-table-goto-column col t)
1049 (insert "| "))
1050 (beginning-of-line 2))
1051 (move-marker end nil)
1052 (goto-line linepos)
1053 (org-table-goto-column colpos)
1054 (org-table-align)
1055 (org-table-fix-formulas "$" nil (1- col) 1)))
1056
1057(defun org-table-find-dataline ()
1058 "Find a dataline in the current table, which is needed for column commands."
1059 (if (and (org-at-table-p)
1060 (not (org-at-table-hline-p)))
1061 t
1062 (let ((col (current-column))
1063 (end (org-table-end)))
1064 (org-move-to-column col)
1065 (while (and (< (point) end)
1066 (or (not (= (current-column) col))
1067 (org-at-table-hline-p)))
1068 (beginning-of-line 2)
1069 (org-move-to-column col))
1070 (if (and (org-at-table-p)
1071 (not (org-at-table-hline-p)))
1072 t
1073 (error
1074 "Please position cursor in a data line for column operations")))))
1075
1076(defun org-table-delete-column ()
1077 "Delete a column from the table."
1078 (interactive)
1079 (if (not (org-at-table-p))
1080 (error "Not at a table"))
1081 (org-table-find-dataline)
1082 (org-table-check-inside-data-field)
1083 (let* ((col (org-table-current-column))
1084 (beg (org-table-begin))
1085 (end (org-table-end))
1086 ;; Current cursor position
1087 (linepos (org-current-line))
1088 (colpos col))
1089 (goto-char beg)
1090 (while (< (point) end)
1091 (if (org-at-table-hline-p)
1092 nil
1093 (org-table-goto-column col t)
1094 (and (looking-at "|[^|\n]+|")
1095 (replace-match "|")))
1096 (beginning-of-line 2))
1097 (move-marker end nil)
1098 (goto-line linepos)
1099 (org-table-goto-column colpos)
1100 (org-table-align)
1101 (org-table-fix-formulas "$" (list (cons (number-to-string col) "INVALID"))
1102 col -1 col)))
1103
1104(defun org-table-move-column-right ()
1105 "Move column to the right."
1106 (interactive)
1107 (org-table-move-column nil))
1108(defun org-table-move-column-left ()
1109 "Move column to the left."
1110 (interactive)
1111 (org-table-move-column 'left))
1112
1113(defun org-table-move-column (&optional left)
1114 "Move the current column to the right. With arg LEFT, move to the left."
1115 (interactive "P")
1116 (if (not (org-at-table-p))
1117 (error "Not at a table"))
1118 (org-table-find-dataline)
1119 (org-table-check-inside-data-field)
1120 (let* ((col (org-table-current-column))
1121 (col1 (if left (1- col) col))
1122 (beg (org-table-begin))
1123 (end (org-table-end))
1124 ;; Current cursor position
1125 (linepos (org-current-line))
1126 (colpos (if left (1- col) (1+ col))))
1127 (if (and left (= col 1))
1128 (error "Cannot move column further left"))
1129 (if (and (not left) (looking-at "[^|\n]*|[^|\n]*$"))
1130 (error "Cannot move column further right"))
1131 (goto-char beg)
1132 (while (< (point) end)
1133 (if (org-at-table-hline-p)
1134 nil
1135 (org-table-goto-column col1 t)
1136 (and (looking-at "|\\([^|\n]+\\)|\\([^|\n]+\\)|")
1137 (replace-match "|\\2|\\1|")))
1138 (beginning-of-line 2))
1139 (move-marker end nil)
1140 (goto-line linepos)
1141 (org-table-goto-column colpos)
1142 (org-table-align)
1143 (org-table-fix-formulas
1144 "$" (list (cons (number-to-string col) (number-to-string colpos))
1145 (cons (number-to-string colpos) (number-to-string col))))))
1146
1147(defun org-table-move-row-down ()
1148 "Move table row down."
1149 (interactive)
1150 (org-table-move-row nil))
1151(defun org-table-move-row-up ()
1152 "Move table row up."
1153 (interactive)
1154 (org-table-move-row 'up))
1155
1156(defun org-table-move-row (&optional up)
1157 "Move the current table line down. With arg UP, move it up."
1158 (interactive "P")
1159 (let* ((col (current-column))
1160 (pos (point))
1161 (hline1p (save-excursion (beginning-of-line 1)
1162 (looking-at org-table-hline-regexp)))
1163 (dline1 (org-table-current-dline))
1164 (dline2 (+ dline1 (if up -1 1)))
1165 (tonew (if up 0 2))
1166 txt hline2p)
1167 (beginning-of-line tonew)
1168 (unless (org-at-table-p)
1169 (goto-char pos)
1170 (error "Cannot move row further"))
1171 (setq hline2p (looking-at org-table-hline-regexp))
1172 (goto-char pos)
1173 (beginning-of-line 1)
1174 (setq pos (point))
1175 (setq txt (buffer-substring (point) (1+ (point-at-eol))))
1176 (delete-region (point) (1+ (point-at-eol)))
1177 (beginning-of-line tonew)
1178 (insert txt)
1179 (beginning-of-line 0)
1180 (org-move-to-column col)
1181 (unless (or hline1p hline2p)
1182 (org-table-fix-formulas
1183 "@" (list (cons (number-to-string dline1) (number-to-string dline2))
1184 (cons (number-to-string dline2) (number-to-string dline1)))))))
1185
1186(defun org-table-insert-row (&optional arg)
1187 "Insert a new row above the current line into the table.
1188With prefix ARG, insert below the current line."
1189 (interactive "P")
1190 (if (not (org-at-table-p))
1191 (error "Not at a table"))
1192 (let* ((line (buffer-substring (point-at-bol) (point-at-eol)))
1193 (new (org-table-clean-line line)))
1194 ;; Fix the first field if necessary
1195 (if (string-match "^[ \t]*| *[#$] *|" line)
1196 (setq new (replace-match (match-string 0 line) t t new)))
1197 (beginning-of-line (if arg 2 1))
1198 (let (org-table-may-need-update) (insert-before-markers new "\n"))
1199 (beginning-of-line 0)
1200 (re-search-forward "| ?" (point-at-eol) t)
1201 (and (or org-table-may-need-update org-table-overlay-coordinates)
1202 (org-table-align))
1203 (org-table-fix-formulas "@" nil (1- (org-table-current-dline)) 1)))
1204
1205(defun org-table-insert-hline (&optional above)
1206 "Insert a horizontal-line below the current line into the table.
1207With prefix ABOVE, insert above the current line."
1208 (interactive "P")
1209 (if (not (org-at-table-p))
1210 (error "Not at a table"))
1211 (let ((line (org-table-clean-line
1212 (buffer-substring (point-at-bol) (point-at-eol))))
1213 (col (current-column)))
1214 (while (string-match "|\\( +\\)|" line)
1215 (setq line (replace-match
1216 (concat "+" (make-string (- (match-end 1) (match-beginning 1))
1217 ?-) "|") t t line)))
1218 (and (string-match "\\+" line) (setq line (replace-match "|" t t line)))
1219 (beginning-of-line (if above 1 2))
1220 (insert line "\n")
1221 (beginning-of-line (if above 1 -1))
1222 (org-move-to-column col)
1223 (and org-table-overlay-coordinates (org-table-align))))
1224
1225(defun org-table-hline-and-move (&optional same-column)
1226 "Insert a hline and move to the row below that line."
1227 (interactive "P")
1228 (let ((col (org-table-current-column)))
1229 (org-table-maybe-eval-formula)
1230 (org-table-maybe-recalculate-line)
1231 (org-table-insert-hline)
1232 (end-of-line 2)
1233 (if (looking-at "\n[ \t]*|-")
1234 (progn (insert "\n|") (org-table-align))
1235 (org-table-next-field))
1236 (if same-column (org-table-goto-column col))))
1237
1238(defun org-table-clean-line (s)
1239 "Convert a table line S into a string with only \"|\" and space.
1240In particular, this does handle wide and invisible characters."
1241 (if (string-match "^[ \t]*|-" s)
1242 ;; It's a hline, just map the characters
1243 (setq s (mapconcat (lambda (x) (if (member x '(?| ?+)) "|" " ")) s ""))
1244 (while (string-match "|\\([ \t]*?[^ \t\r\n|][^\r\n|]*\\)|" s)
1245 (setq s (replace-match
1246 (concat "|" (make-string (org-string-width (match-string 1 s))
1247 ?\ ) "|")
1248 t t s)))
1249 s))
1250
1251(defun org-table-kill-row ()
1252 "Delete the current row or horizontal line from the table."
1253 (interactive)
1254 (if (not (org-at-table-p))
1255 (error "Not at a table"))
1256 (let ((col (current-column))
1257 (dline (org-table-current-dline)))
1258 (kill-region (point-at-bol) (min (1+ (point-at-eol)) (point-max)))
1259 (if (not (org-at-table-p)) (beginning-of-line 0))
1260 (org-move-to-column col)
1261 (org-table-fix-formulas "@" (list (cons (number-to-string dline) "INVALID"))
1262 dline -1 dline)))
1263
1264(defun org-table-sort-lines (with-case &optional sorting-type)
1265 "Sort table lines according to the column at point.
1266
1267The position of point indicates the column to be used for
1268sorting, and the range of lines is the range between the nearest
1269horizontal separator lines, or the entire table of no such lines
1270exist. If point is before the first column, you will be prompted
1271for the sorting column. If there is an active region, the mark
1272specifies the first line and the sorting column, while point
1273should be in the last line to be included into the sorting.
1274
1275The command then prompts for the sorting type which can be
1276alphabetically, numerically, or by time (as given in a time stamp
1277in the field). Sorting in reverse order is also possible.
1278
1279With prefix argument WITH-CASE, alphabetic sorting will be case-sensitive.
1280
1281If SORTING-TYPE is specified when this function is called from a Lisp
1282program, no prompting will take place. SORTING-TYPE must be a character,
1283any of (?a ?A ?n ?N ?t ?T) where the capital letter indicate that sorting
1284should be done in reverse order."
1285 (interactive "P")
1286 (let* ((thisline (org-current-line))
1287 (thiscol (org-table-current-column))
1288 beg end bcol ecol tend tbeg column lns pos)
1289 (when (equal thiscol 0)
1290 (if (interactive-p)
1291 (setq thiscol
1292 (string-to-number
1293 (read-string "Use column N for sorting: ")))
1294 (setq thiscol 1))
1295 (org-table-goto-column thiscol))
1296 (org-table-check-inside-data-field)
1297 (if (org-region-active-p)
1298 (progn
1299 (setq beg (region-beginning) end (region-end))
1300 (goto-char beg)
1301 (setq column (org-table-current-column)
1302 beg (point-at-bol))
1303 (goto-char end)
1304 (setq end (point-at-bol 2)))
1305 (setq column (org-table-current-column)
1306 pos (point)
1307 tbeg (org-table-begin)
1308 tend (org-table-end))
1309 (if (re-search-backward org-table-hline-regexp tbeg t)
1310 (setq beg (point-at-bol 2))
1311 (goto-char tbeg)
1312 (setq beg (point-at-bol 1)))
1313 (goto-char pos)
1314 (if (re-search-forward org-table-hline-regexp tend t)
1315 (setq end (point-at-bol 1))
1316 (goto-char tend)
1317 (setq end (point-at-bol))))
1318 (setq beg (move-marker (make-marker) beg)
1319 end (move-marker (make-marker) end))
1320 (untabify beg end)
1321 (goto-char beg)
1322 (org-table-goto-column column)
1323 (skip-chars-backward "^|")
1324 (setq bcol (current-column))
1325 (org-table-goto-column (1+ column))
1326 (skip-chars-backward "^|")
1327 (setq ecol (1- (current-column)))
1328 (org-table-goto-column column)
1329 (setq lns (mapcar (lambda(x) (cons
1330 (org-sort-remove-invisible
1331 (nth (1- column)
1332 (org-split-string x "[ \t]*|[ \t]*")))
1333 x))
1334 (org-split-string (buffer-substring beg end) "\n")))
1335 (setq lns (org-do-sort lns "Table" with-case sorting-type))
1336 (delete-region beg end)
1337 (move-marker beg nil)
1338 (move-marker end nil)
1339 (insert (mapconcat 'cdr lns "\n") "\n")
1340 (goto-line thisline)
1341 (org-table-goto-column thiscol)
1342 (message "%d lines sorted, based on column %d" (length lns) column)))
1343
1344
1345(defun org-table-cut-region (beg end)
1346 "Copy region in table to the clipboard and blank all relevant fields."
1347 (interactive "r")
1348 (org-table-copy-region beg end 'cut))
1349
1350(defun org-table-copy-region (beg end &optional cut)
1351 "Copy rectangular region in table to clipboard.
1352A special clipboard is used which can only be accessed
1353with `org-table-paste-rectangle'."
1354 (interactive "rP")
1355 (let* (l01 c01 l02 c02 l1 c1 l2 c2 ic1 ic2
1356 region cols
1357 (rpl (if cut " " nil)))
1358 (goto-char beg)
1359 (org-table-check-inside-data-field)
1360 (setq l01 (org-current-line)
1361 c01 (org-table-current-column))
1362 (goto-char end)
1363 (org-table-check-inside-data-field)
1364 (setq l02 (org-current-line)
1365 c02 (org-table-current-column))
1366 (setq l1 (min l01 l02) l2 (max l01 l02)
1367 c1 (min c01 c02) c2 (max c01 c02))
1368 (catch 'exit
1369 (while t
1370 (catch 'nextline
1371 (if (> l1 l2) (throw 'exit t))
1372 (goto-line l1)
1373 (if (org-at-table-hline-p) (throw 'nextline (setq l1 (1+ l1))))
1374 (setq cols nil ic1 c1 ic2 c2)
1375 (while (< ic1 (1+ ic2))
1376 (push (org-table-get-field ic1 rpl) cols)
1377 (setq ic1 (1+ ic1)))
1378 (push (nreverse cols) region)
1379 (setq l1 (1+ l1)))))
1380 (setq org-table-clip (nreverse region))
1381 (if cut (org-table-align))
1382 org-table-clip))
1383
1384(defun org-table-paste-rectangle ()
1385 "Paste a rectangular region into a table.
1386The upper right corner ends up in the current field. All involved fields
1387will be overwritten. If the rectangle does not fit into the present table,
1388the table is enlarged as needed. The process ignores horizontal separator
1389lines."
1390 (interactive)
1391 (unless (and org-table-clip (listp org-table-clip))
1392 (error "First cut/copy a region to paste!"))
1393 (org-table-check-inside-data-field)
1394 (let* ((clip org-table-clip)
1395 (line (org-current-line))
1396 (col (org-table-current-column))
1397 (org-enable-table-editor t)
1398 (org-table-automatic-realign nil)
1399 c cols field)
1400 (while (setq cols (pop clip))
1401 (while (org-at-table-hline-p) (beginning-of-line 2))
1402 (if (not (org-at-table-p))
1403 (progn (end-of-line 0) (org-table-next-field)))
1404 (setq c col)
1405 (while (setq field (pop cols))
1406 (org-table-goto-column c nil 'force)
1407 (org-table-get-field nil field)
1408 (setq c (1+ c)))
1409 (beginning-of-line 2))
1410 (goto-line line)
1411 (org-table-goto-column col)
1412 (org-table-align)))
1413
1414(defun org-table-convert ()
1415 "Convert from `org-mode' table to table.el and back.
1416Obviously, this only works within limits. When an Org-mode table is
1417converted to table.el, all horizontal separator lines get lost, because
1418table.el uses these as cell boundaries and has no notion of horizontal lines.
1419A table.el table can be converted to an Org-mode table only if it does not
1420do row or column spanning. Multiline cells will become multiple cells.
1421Beware, Org-mode does not test if the table can be successfully converted - it
1422blindly applies a recipe that works for simple tables."
1423 (interactive)
1424 (require 'table)
1425 (if (org-at-table.el-p)
1426 ;; convert to Org-mode table
1427 (let ((beg (move-marker (make-marker) (org-table-begin t)))
1428 (end (move-marker (make-marker) (org-table-end t))))
1429 (table-unrecognize-region beg end)
1430 (goto-char beg)
1431 (while (re-search-forward "^\\([ \t]*\\)\\+-.*\n" end t)
1432 (replace-match ""))
1433 (goto-char beg))
1434 (if (org-at-table-p)
1435 ;; convert to table.el table
1436 (let ((beg (move-marker (make-marker) (org-table-begin)))
1437 (end (move-marker (make-marker) (org-table-end))))
1438 ;; first, get rid of all horizontal lines
1439 (goto-char beg)
1440 (while (re-search-forward "^\\([ \t]*\\)|-.*\n" end t)
1441 (replace-match ""))
1442 ;; insert a hline before first
1443 (goto-char beg)
1444 (org-table-insert-hline 'above)
1445 (beginning-of-line -1)
1446 ;; insert a hline after each line
1447 (while (progn (beginning-of-line 3) (< (point) end))
1448 (org-table-insert-hline))
1449 (goto-char beg)
1450 (setq end (move-marker end (org-table-end)))
1451 ;; replace "+" at beginning and ending of hlines
1452 (while (re-search-forward "^\\([ \t]*\\)|-" end t)
1453 (replace-match "\\1+-"))
1454 (goto-char beg)
1455 (while (re-search-forward "-|[ \t]*$" end t)
1456 (replace-match "-+"))
1457 (goto-char beg)))))
1458
1459(defun org-table-wrap-region (arg)
1460 "Wrap several fields in a column like a paragraph.
1461This is useful if you'd like to spread the contents of a field over several
1462lines, in order to keep the table compact.
1463
1464If there is an active region, and both point and mark are in the same column,
1465the text in the column is wrapped to minimum width for the given number of
1466lines. Generally, this makes the table more compact. A prefix ARG may be
1467used to change the number of desired lines. For example, `C-2 \\[org-table-wrap]'
1468formats the selected text to two lines. If the region was longer than two
1469lines, the remaining lines remain empty. A negative prefix argument reduces
1470the current number of lines by that amount. The wrapped text is pasted back
1471into the table. If you formatted it to more lines than it was before, fields
1472further down in the table get overwritten - so you might need to make space in
1473the table first.
1474
1475If there is no region, the current field is split at the cursor position and
1476the text fragment to the right of the cursor is prepended to the field one
1477line down.
1478
1479If there is no region, but you specify a prefix ARG, the current field gets
1480blank, and the content is appended to the field above."
1481 (interactive "P")
1482 (org-table-check-inside-data-field)
1483 (if (org-region-active-p)
1484 ;; There is a region: fill as a paragraph
1485 (let* ((beg (region-beginning))
1486 (cline (save-excursion (goto-char beg) (org-current-line)))
1487 (ccol (save-excursion (goto-char beg) (org-table-current-column)))
1488 nlines)
1489 (org-table-cut-region (region-beginning) (region-end))
1490 (if (> (length (car org-table-clip)) 1)
1491 (error "Region must be limited to single column"))
1492 (setq nlines (if arg
1493 (if (< arg 1)
1494 (+ (length org-table-clip) arg)
1495 arg)
1496 (length org-table-clip)))
1497 (setq org-table-clip
1498 (mapcar 'list (org-wrap (mapconcat 'car org-table-clip " ")
1499 nil nlines)))
1500 (goto-line cline)
1501 (org-table-goto-column ccol)
1502 (org-table-paste-rectangle))
1503 ;; No region, split the current field at point
1504 (unless (org-get-alist-option org-M-RET-may-split-line 'table)
1505 (skip-chars-forward "^\r\n|"))
1506 (if arg
1507 ;; combine with field above
1508 (let ((s (org-table-blank-field))
1509 (col (org-table-current-column)))
1510 (beginning-of-line 0)
1511 (while (org-at-table-hline-p) (beginning-of-line 0))
1512 (org-table-goto-column col)
1513 (skip-chars-forward "^|")
1514 (skip-chars-backward " ")
1515 (insert " " (org-trim s))
1516 (org-table-align))
1517 ;; split field
1518 (if (looking-at "\\([^|]+\\)+|")
1519 (let ((s (match-string 1)))
1520 (replace-match " |")
1521 (goto-char (match-beginning 0))
1522 (org-table-next-row)
1523 (insert (org-trim s) " ")
1524 (org-table-align))
1525 (org-table-next-row)))))
1526
1527(defvar org-field-marker nil)
1528
1529(defun org-table-edit-field (arg)
1530 "Edit table field in a different window.
1531This is mainly useful for fields that contain hidden parts.
1532When called with a \\[universal-argument] prefix, just make the full field visible so that
1533it can be edited in place."
1534 (interactive "P")
1535 (if arg
1536 (let ((b (save-excursion (skip-chars-backward "^|") (point)))
1537 (e (save-excursion (skip-chars-forward "^|\r\n") (point))))
1538 (remove-text-properties b e '(org-cwidth t invisible t
1539 display t intangible t))
1540 (if (and (boundp 'font-lock-mode) font-lock-mode)
1541 (font-lock-fontify-block)))
1542 (let ((pos (move-marker (make-marker) (point)))
1543 (field (org-table-get-field))
1544 (cw (current-window-configuration))
1545 p)
1546 (org-switch-to-buffer-other-window "*Org tmp*")
1547 (erase-buffer)
1548 (insert "#\n# Edit field and finish with C-c C-c\n#\n")
1549 (let ((org-inhibit-startup t)) (org-mode))
1550 (goto-char (setq p (point-max)))
1551 (insert (org-trim field))
1552 (remove-text-properties p (point-max)
1553 '(invisible t org-cwidth t display t
1554 intangible t))
1555 (goto-char p)
1556 (org-set-local 'org-finish-function 'org-table-finish-edit-field)
1557 (org-set-local 'org-window-configuration cw)
1558 (org-set-local 'org-field-marker pos)
1559 (message "Edit and finish with C-c C-c"))))
1560
1561(defun org-table-finish-edit-field ()
1562 "Finish editing a table data field.
1563Remove all newline characters, insert the result into the table, realign
1564the table and kill the editing buffer."
1565 (let ((pos org-field-marker)
1566 (cw org-window-configuration)
1567 (cb (current-buffer))
1568 text)
1569 (goto-char (point-min))
1570 (while (re-search-forward "^#.*\n?" nil t) (replace-match ""))
1571 (while (re-search-forward "\\([ \t]*\n[ \t]*\\)+" nil t)
1572 (replace-match " "))
1573 (setq text (org-trim (buffer-string)))
1574 (set-window-configuration cw)
1575 (kill-buffer cb)
1576 (select-window (get-buffer-window (marker-buffer pos)))
1577 (goto-char pos)
1578 (move-marker pos nil)
1579 (org-table-check-inside-data-field)
1580 (org-table-get-field nil text)
1581 (org-table-align)
1582 (message "New field value inserted")))
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601(defvar org-timecnt) ; dynamically scoped parameter
1602
1603(defun org-table-sum (&optional beg end nlast)
1604 "Sum numbers in region of current table column.
1605The result will be displayed in the echo area, and will be available
1606as kill to be inserted with \\[yank].
1607
1608If there is an active region, it is interpreted as a rectangle and all
1609numbers in that rectangle will be summed. If there is no active
1610region and point is located in a table column, sum all numbers in that
1611column.
1612
1613If at least one number looks like a time HH:MM or HH:MM:SS, all other
1614numbers are assumed to be times as well (in decimal hours) and the
1615numbers are added as such.
1616
1617If NLAST is a number, only the NLAST fields will actually be summed."
1618 (interactive)
1619 (save-excursion
1620 (let (col (org-timecnt 0) diff h m s org-table-clip)
1621 (cond
1622 ((and beg end)) ; beg and end given explicitly
1623 ((org-region-active-p)
1624 (setq beg (region-beginning) end (region-end)))
1625 (t
1626 (setq col (org-table-current-column))
1627 (goto-char (org-table-begin))
1628 (unless (re-search-forward "^[ \t]*|[^-]" nil t)
1629 (error "No table data"))
1630 (org-table-goto-column col)
1631 (setq beg (point))
1632 (goto-char (org-table-end))
1633 (unless (re-search-backward "^[ \t]*|[^-]" nil t)
1634 (error "No table data"))
1635 (org-table-goto-column col)
1636 (setq end (point))))
1637 (let* ((items (apply 'append (org-table-copy-region beg end)))
1638 (items1 (cond ((not nlast) items)
1639 ((>= nlast (length items)) items)
1640 (t (setq items (reverse items))
1641 (setcdr (nthcdr (1- nlast) items) nil)
1642 (nreverse items))))
1643 (numbers (delq nil (mapcar 'org-table-get-number-for-summing
1644 items1)))
1645 (res (apply '+ numbers))
1646 (sres (if (= org-timecnt 0)
621f83e4 1647 (number-to-string res)
20908596
CD
1648 (setq diff (* 3600 res)
1649 h (floor (/ diff 3600)) diff (mod diff 3600)
1650 m (floor (/ diff 60)) diff (mod diff 60)
1651 s diff)
1652 (format "%d:%02d:%02d" h m s))))
1653 (kill-new sres)
1654 (if (interactive-p)
1655 (message "%s"
1656 (substitute-command-keys
1657 (format "Sum of %d items: %-20s (\\[yank] will insert result into buffer)"
1658 (length numbers) sres))))
1659 sres))))
1660
1661(defun org-table-get-number-for-summing (s)
1662 (let (n)
1663 (if (string-match "^ *|? *" s)
1664 (setq s (replace-match "" nil nil s)))
1665 (if (string-match " *|? *$" s)
1666 (setq s (replace-match "" nil nil s)))
1667 (setq n (string-to-number s))
1668 (cond
1669 ((and (string-match "0" s)
1670 (string-match "\\`[-+ \t0.edED]+\\'" s)) 0)
1671 ((string-match "\\`[ \t]+\\'" s) nil)
1672 ((string-match "\\`\\([0-9]+\\):\\([0-9]+\\)\\(:\\([0-9]+\\)\\)?\\'" s)
1673 (let ((h (string-to-number (or (match-string 1 s) "0")))
1674 (m (string-to-number (or (match-string 2 s) "0")))
1675 (s (string-to-number (or (match-string 4 s) "0"))))
1676 (if (boundp 'org-timecnt) (setq org-timecnt (1+ org-timecnt)))
1677 (* 1.0 (+ h (/ m 60.0) (/ s 3600.0)))))
1678 ((equal n 0) nil)
1679 (t n))))
1680
1681(defun org-table-current-field-formula (&optional key noerror)
1682 "Return the formula active for the current field.
1683Assumes that specials are in place.
1684If KEY is given, return the key to this formula.
1685Otherwise return the formula preceeded with \"=\" or \":=\"."
1686 (let* ((name (car (rassoc (list (org-current-line)
1687 (org-table-current-column))
1688 org-table-named-field-locations)))
1689 (col (org-table-current-column))
1690 (scol (int-to-string col))
1691 (ref (format "@%d$%d" (org-table-current-dline) col))
1692 (stored-list (org-table-get-stored-formulas noerror))
1693 (ass (or (assoc name stored-list)
1694 (assoc ref stored-list)
1695 (assoc scol stored-list))))
1696 (if key
1697 (car ass)
1698 (if ass (concat (if (string-match "^[0-9]+$" (car ass)) "=" ":=")
1699 (cdr ass))))))
1700
1701(defun org-table-get-formula (&optional equation named)
1702 "Read a formula from the minibuffer, offer stored formula as default.
1703When NAMED is non-nil, look for a named equation."
1704 (let* ((stored-list (org-table-get-stored-formulas))
1705 (name (car (rassoc (list (org-current-line)
1706 (org-table-current-column))
1707 org-table-named-field-locations)))
1708 (ref (format "@%d$%d" (org-table-current-dline)
1709 (org-table-current-column)))
1710 (refass (assoc ref stored-list))
1711 (scol (if named
1712 (if name name ref)
1713 (int-to-string (org-table-current-column))))
1714 (dummy (and (or name refass) (not named)
1715 (not (y-or-n-p "Replace field formula with column formula? " ))
1716 (error "Abort")))
1717 (name (or name ref))
1718 (org-table-may-need-update nil)
1719 (stored (cdr (assoc scol stored-list)))
1720 (eq (cond
1721 ((and stored equation (string-match "^ *=? *$" equation))
1722 stored)
1723 ((stringp equation)
1724 equation)
1725 (t (org-table-formula-from-user
1726 (read-string
1727 (org-table-formula-to-user
1728 (format "%s formula %s%s="
1729 (if named "Field" "Column")
1730 (if (member (string-to-char scol) '(?$ ?@)) "" "$")
1731 scol))
1732 (if stored (org-table-formula-to-user stored) "")
1733 'org-table-formula-history
1734 )))))
1735 mustsave)
1736 (when (not (string-match "\\S-" eq))
1737 ;; remove formula
1738 (setq stored-list (delq (assoc scol stored-list) stored-list))
1739 (org-table-store-formulas stored-list)
1740 (error "Formula removed"))
1741 (if (string-match "^ *=?" eq) (setq eq (replace-match "" t t eq)))
1742 (if (string-match " *$" eq) (setq eq (replace-match "" t t eq)))
1743 (if (and name (not named))
1744 ;; We set the column equation, delete the named one.
1745 (setq stored-list (delq (assoc name stored-list) stored-list)
1746 mustsave t))
1747 (if stored
1748 (setcdr (assoc scol stored-list) eq)
1749 (setq stored-list (cons (cons scol eq) stored-list)))
1750 (if (or mustsave (not (equal stored eq)))
1751 (org-table-store-formulas stored-list))
1752 eq))
1753
1754(defun org-table-store-formulas (alist)
1755 "Store the list of formulas below the current table."
1756 (setq alist (sort alist 'org-table-formula-less-p))
1757 (save-excursion
1758 (goto-char (org-table-end))
1759 (if (looking-at "\\([ \t]*\n\\)*#\\+TBLFM:\\(.*\n?\\)")
1760 (progn
1761 ;; don't overwrite TBLFM, we might use text properties to store stuff
1762 (goto-char (match-beginning 2))
1763 (delete-region (match-beginning 2) (match-end 0)))
1764 (insert "#+TBLFM:"))
1765 (insert " "
1766 (mapconcat (lambda (x)
1767 (concat
1768 (if (equal (string-to-char (car x)) ?@) "" "$")
1769 (car x) "=" (cdr x)))
1770 alist "::")
1771 "\n")))
1772
1773(defsubst org-table-formula-make-cmp-string (a)
1774 (when (string-match "^\\(@\\([0-9]+\\)\\)?\\(\\$?\\([0-9]+\\)\\)?\\(\\$?[a-zA-Z0-9]+\\)?" a)
1775 (concat
1776 (if (match-end 2) (format "@%05d" (string-to-number (match-string 2 a))) "")
1777 (if (match-end 4) (format "$%05d" (string-to-number (match-string 4 a))) "")
1778 (if (match-end 5) (concat "@@" (match-string 5 a))))))
1779
1780(defun org-table-formula-less-p (a b)
1781 "Compare two formulas for sorting."
1782 (let ((as (org-table-formula-make-cmp-string (car a)))
1783 (bs (org-table-formula-make-cmp-string (car b))))
1784 (and as bs (string< as bs))))
1785
1786(defun org-table-get-stored-formulas (&optional noerror)
1787 "Return an alist with the stored formulas directly after current table."
1788 (interactive)
1789 (let (scol eq eq-alist strings string seen)
1790 (save-excursion
1791 (goto-char (org-table-end))
1792 (when (looking-at "\\([ \t]*\n\\)*#\\+TBLFM: *\\(.*\\)")
1793 (setq strings (org-split-string (match-string 2) " *:: *"))
1794 (while (setq string (pop strings))
1795 (when (string-match "\\`\\(@[0-9]+\\$[0-9]+\\|\\$\\([a-zA-Z0-9]+\\)\\) *= *\\(.*[^ \t]\\)" string)
1796 (setq scol (if (match-end 2)
1797 (match-string 2 string)
1798 (match-string 1 string))
1799 eq (match-string 3 string)
1800 eq-alist (cons (cons scol eq) eq-alist))
1801 (if (member scol seen)
1802 (if noerror
1803 (progn
1804 (message "Double definition `$%s=' in TBLFM line, please fix by hand" scol)
1805 (ding)
1806 (sit-for 2))
1807 (error "Double definition `$%s=' in TBLFM line, please fix by hand" scol))
1808 (push scol seen))))))
1809 (nreverse eq-alist)))
1810
1811(defun org-table-fix-formulas (key replace &optional limit delta remove)
1812 "Modify the equations after the table structure has been edited.
1813KEY is \"@\" or \"$\". REPLACE is an alist of numbers to replace.
1814For all numbers larger than LIMIT, shift them by DELTA."
1815 (save-excursion
1816 (goto-char (org-table-end))
1817 (when (looking-at "#\\+TBLFM:")
1818 (let ((re (concat key "\\([0-9]+\\)"))
1819 (re2
1820 (when remove
1821 (if (equal key "$")
1822 (format "\\(@[0-9]+\\)?\\$%d=.*?\\(::\\|$\\)" remove)
1823 (format "@%d\\$[0-9]+=.*?\\(::\\|$\\)" remove))))
1824 s n a)
1825 (when remove
1826 (while (re-search-forward re2 (point-at-eol) t)
1827 (replace-match "")))
1828 (while (re-search-forward re (point-at-eol) t)
1829 (setq s (match-string 1) n (string-to-number s))
1830 (cond
1831 ((setq a (assoc s replace))
1832 (replace-match (concat key (cdr a)) t t))
1833 ((and limit (> n limit))
1834 (replace-match (concat key (int-to-string (+ n delta))) t t))))))))
1835
1836(defun org-table-get-specials ()
1837 "Get the column names and local parameters for this table."
1838 (save-excursion
1839 (let ((beg (org-table-begin)) (end (org-table-end))
1840 names name fields fields1 field cnt
1841 c v l line col types dlines hlines)
1842 (setq org-table-column-names nil
1843 org-table-local-parameters nil
1844 org-table-named-field-locations nil
1845 org-table-current-begin-line nil
1846 org-table-current-begin-pos nil
1847 org-table-current-line-types nil)
1848 (goto-char beg)
1849 (when (re-search-forward "^[ \t]*| *! *\\(|.*\\)" end t)
1850 (setq names (org-split-string (match-string 1) " *| *")
1851 cnt 1)
1852 (while (setq name (pop names))
1853 (setq cnt (1+ cnt))
1854 (if (string-match "^[a-zA-Z][a-zA-Z0-9]*$" name)
1855 (push (cons name (int-to-string cnt)) org-table-column-names))))
1856 (setq org-table-column-names (nreverse org-table-column-names))
1857 (setq org-table-column-name-regexp
1858 (concat "\\$\\(" (mapconcat 'car org-table-column-names "\\|") "\\)\\>"))
1859 (goto-char beg)
1860 (while (re-search-forward "^[ \t]*| *\\$ *\\(|.*\\)" end t)
1861 (setq fields (org-split-string (match-string 1) " *| *"))
1862 (while (setq field (pop fields))
1863 (if (string-match "^\\([a-zA-Z][_a-zA-Z0-9]*\\|%\\) *= *\\(.*\\)" field)
1864 (push (cons (match-string 1 field) (match-string 2 field))
1865 org-table-local-parameters))))
1866 (goto-char beg)
1867 (while (re-search-forward "^[ \t]*| *\\([_^]\\) *\\(|.*\\)" end t)
1868 (setq c (match-string 1)
1869 fields (org-split-string (match-string 2) " *| *"))
1870 (save-excursion
1871 (beginning-of-line (if (equal c "_") 2 0))
1872 (setq line (org-current-line) col 1)
1873 (and (looking-at "^[ \t]*|[^|]*\\(|.*\\)")
1874 (setq fields1 (org-split-string (match-string 1) " *| *"))))
1875 (while (and fields1 (setq field (pop fields)))
1876 (setq v (pop fields1) col (1+ col))
1877 (when (and (stringp field) (stringp v)
1878 (string-match "^[a-zA-Z][a-zA-Z0-9]*$" field))
1879 (push (cons field v) org-table-local-parameters)
1880 (push (list field line col) org-table-named-field-locations))))
2c3ad40d 1881 ;; Analyse the line types
20908596
CD
1882 (goto-char beg)
1883 (setq org-table-current-begin-line (org-current-line)
1884 org-table-current-begin-pos (point)
1885 l org-table-current-begin-line)
1886 (while (looking-at "[ \t]*|\\(-\\)?")
1887 (push (if (match-end 1) 'hline 'dline) types)
1888 (if (match-end 1) (push l hlines) (push l dlines))
1889 (beginning-of-line 2)
1890 (setq l (1+ l)))
1891 (setq org-table-current-line-types (apply 'vector (nreverse types))
1892 org-table-dlines (apply 'vector (cons nil (nreverse dlines)))
1893 org-table-hlines (apply 'vector (cons nil (nreverse hlines)))))))
1894
1895(defun org-table-maybe-eval-formula ()
1896 "Check if the current field starts with \"=\" or \":=\".
1897If yes, store the formula and apply it."
1898 ;; We already know we are in a table. Get field will only return a formula
1899 ;; when appropriate. It might return a separator line, but no problem.
1900 (when org-table-formula-evaluate-inline
1901 (let* ((field (org-trim (or (org-table-get-field) "")))
1902 named eq)
1903 (when (string-match "^:?=\\(.*\\)" field)
1904 (setq named (equal (string-to-char field) ?:)
1905 eq (match-string 1 field))
1906 (if (or (fboundp 'calc-eval)
1907 (equal (substring eq 0 (min 2 (length eq))) "'("))
1908 (org-table-eval-formula (if named '(4) nil)
1909 (org-table-formula-from-user eq))
1910 (error "Calc does not seem to be installed, and is needed to evaluate the formula"))))))
1911
1912(defvar org-recalc-commands nil
1913 "List of commands triggering the recalculation of a line.
1914Will be filled automatically during use.")
1915
1916(defvar org-recalc-marks
1917 '((" " . "Unmarked: no special line, no automatic recalculation")
1918 ("#" . "Automatically recalculate this line upon TAB, RET, and C-c C-c in the line")
1919 ("*" . "Recalculate only when entire table is recalculated with `C-u C-c *'")
1920 ("!" . "Column name definition line. Reference in formula as $name.")
1921 ("$" . "Parameter definition line name=value. Reference in formula as $name.")
1922 ("_" . "Names for values in row below this one.")
1923 ("^" . "Names for values in row above this one.")))
1924
1925(defun org-table-rotate-recalc-marks (&optional newchar)
1926 "Rotate the recalculation mark in the first column.
1927If in any row, the first field is not consistent with a mark,
1928insert a new column for the markers.
1929When there is an active region, change all the lines in the region,
1930after prompting for the marking character.
1931After each change, a message will be displayed indicating the meaning
1932of the new mark."
1933 (interactive)
1934 (unless (org-at-table-p) (error "Not at a table"))
1935 (let* ((marks (append (mapcar 'car org-recalc-marks) '(" ")))
1936 (beg (org-table-begin))
1937 (end (org-table-end))
1938 (l (org-current-line))
1939 (l1 (if (org-region-active-p) (org-current-line (region-beginning))))
1940 (l2 (if (org-region-active-p) (org-current-line (region-end))))
1941 (have-col
1942 (save-excursion
1943 (goto-char beg)
1944 (not (re-search-forward "^[ \t]*|[^-|][^|]*[^#!$*_^| \t][^|]*|" end t))))
1945 (col (org-table-current-column))
1946 (forcenew (car (assoc newchar org-recalc-marks)))
1947 epos new)
1948 (when l1
1949 (message "Change region to what mark? Type # * ! $ or SPC: ")
1950 (setq newchar (char-to-string (read-char-exclusive))
1951 forcenew (car (assoc newchar org-recalc-marks))))
1952 (if (and newchar (not forcenew))
1953 (error "Invalid NEWCHAR `%s' in `org-table-rotate-recalc-marks'"
1954 newchar))
1955 (if l1 (goto-line l1))
1956 (save-excursion
1957 (beginning-of-line 1)
1958 (unless (looking-at org-table-dataline-regexp)
1959 (error "Not at a table data line")))
1960 (unless have-col
1961 (org-table-goto-column 1)
1962 (org-table-insert-column)
1963 (org-table-goto-column (1+ col)))
1964 (setq epos (point-at-eol))
1965 (save-excursion
1966 (beginning-of-line 1)
1967 (org-table-get-field
1968 1 (if (looking-at "^[ \t]*| *\\([#!$*^_ ]\\) *|")
1969 (concat " "
1970 (setq new (or forcenew
1971 (cadr (member (match-string 1) marks))))
1972 " ")
1973 " # ")))
1974 (if (and l1 l2)
1975 (progn
1976 (goto-line l1)
1977 (while (progn (beginning-of-line 2) (not (= (org-current-line) l2)))
1978 (and (looking-at org-table-dataline-regexp)
1979 (org-table-get-field 1 (concat " " new " "))))
1980 (goto-line l1)))
1981 (if (not (= epos (point-at-eol))) (org-table-align))
1982 (goto-line l)
1983 (and (interactive-p) (message "%s" (cdr (assoc new org-recalc-marks))))))
1984
1985(defun org-table-maybe-recalculate-line ()
1986 "Recompute the current line if marked for it, and if we haven't just done it."
1987 (interactive)
1988 (and org-table-allow-automatic-line-recalculation
1989 (not (and (memq last-command org-recalc-commands)
1990 (equal org-last-recalc-line (org-current-line))))
1991 (save-excursion (beginning-of-line 1)
1992 (looking-at org-table-auto-recalculate-regexp))
1993 (org-table-recalculate) t))
1994
1995(defvar modes)
1996(defsubst org-set-calc-mode (var &optional value)
1997 (if (stringp var)
1998 (setq var (assoc var '(("D" calc-angle-mode deg)
1999 ("R" calc-angle-mode rad)
2000 ("F" calc-prefer-frac t)
2001 ("S" calc-symbolic-mode t)))
2002 value (nth 2 var) var (nth 1 var)))
2003 (if (memq var modes)
2004 (setcar (cdr (memq var modes)) value)
2005 (cons var (cons value modes)))
2006 modes)
2007
2008(defun org-table-eval-formula (&optional arg equation
2009 suppress-align suppress-const
2010 suppress-store suppress-analysis)
2011 "Replace the table field value at the cursor by the result of a calculation.
2012
2013This function makes use of Dave Gillespie's Calc package, in my view the
2014most exciting program ever written for GNU Emacs. So you need to have Calc
2015installed in order to use this function.
2016
2017In a table, this command replaces the value in the current field with the
2018result of a formula. It also installs the formula as the \"current\" column
2019formula, by storing it in a special line below the table. When called
2020with a `C-u' prefix, the current field must ba a named field, and the
2021formula is installed as valid in only this specific field.
2022
2023When called with two `C-u' prefixes, insert the active equation
2024for the field back into the current field, so that it can be
2025edited there. This is useful in order to use \\[org-table-show-reference]
2026to check the referenced fields.
2027
2028When called, the command first prompts for a formula, which is read in
2029the minibuffer. Previously entered formulas are available through the
2030history list, and the last used formula is offered as a default.
2031These stored formulas are adapted correctly when moving, inserting, or
2032deleting columns with the corresponding commands.
2033
2034The formula can be any algebraic expression understood by the Calc package.
2035For details, see the Org-mode manual.
2036
2037This function can also be called from Lisp programs and offers
2038additional arguments: EQUATION can be the formula to apply. If this
2039argument is given, the user will not be prompted. SUPPRESS-ALIGN is
2040used to speed-up recursive calls by by-passing unnecessary aligns.
2041SUPPRESS-CONST suppresses the interpretation of constants in the
2042formula, assuming that this has been done already outside the function.
2043SUPPRESS-STORE means the formula should not be stored, either because
2044it is already stored, or because it is a modified equation that should
2045not overwrite the stored one."
2046 (interactive "P")
2047 (org-table-check-inside-data-field)
2048 (or suppress-analysis (org-table-get-specials))
2049 (if (equal arg '(16))
2050 (let ((eq (org-table-current-field-formula)))
2051 (or eq (error "No equation active for current field"))
2052 (org-table-get-field nil eq)
2053 (org-table-align)
2054 (setq org-table-may-need-update t))
2055 (let* (fields
2056 (ndown (if (integerp arg) arg 1))
2057 (org-table-automatic-realign nil)
2058 (case-fold-search nil)
2059 (down (> ndown 1))
2060 (formula (if (and equation suppress-store)
2061 equation
2062 (org-table-get-formula equation (equal arg '(4)))))
2063 (n0 (org-table-current-column))
2064 (modes (copy-sequence org-calc-default-modes))
2065 (numbers nil) ; was a variable, now fixed default
2066 (keep-empty nil)
2067 n form form0 bw fmt x ev orig c lispp literal)
2068 ;; Parse the format string. Since we have a lot of modes, this is
2069 ;; a lot of work. However, I think calc still uses most of the time.
2070 (if (string-match ";" formula)
2071 (let ((tmp (org-split-string formula ";")))
2072 (setq formula (car tmp)
2073 fmt (concat (cdr (assoc "%" org-table-local-parameters))
2074 (nth 1 tmp)))
2075 (while (string-match "\\([pnfse]\\)\\(-?[0-9]+\\)" fmt)
2076 (setq c (string-to-char (match-string 1 fmt))
2077 n (string-to-number (match-string 2 fmt)))
2078 (if (= c ?p)
2079 (setq modes (org-set-calc-mode 'calc-internal-prec n))
2080 (setq modes (org-set-calc-mode
2081 'calc-float-format
2082 (list (cdr (assoc c '((?n . float) (?f . fix)
2083 (?s . sci) (?e . eng))))
2084 n))))
2085 (setq fmt (replace-match "" t t fmt)))
2086 (if (string-match "[NT]" fmt)
2087 (setq numbers (equal (match-string 0 fmt) "N")
2088 fmt (replace-match "" t t fmt)))
2089 (if (string-match "L" fmt)
2090 (setq literal t
2091 fmt (replace-match "" t t fmt)))
2092 (if (string-match "E" fmt)
2093 (setq keep-empty t
2094 fmt (replace-match "" t t fmt)))
2095 (while (string-match "[DRFS]" fmt)
2096 (setq modes (org-set-calc-mode (match-string 0 fmt)))
2097 (setq fmt (replace-match "" t t fmt)))
2098 (unless (string-match "\\S-" fmt)
2099 (setq fmt nil))))
2100 (if (and (not suppress-const) org-table-formula-use-constants)
2101 (setq formula (org-table-formula-substitute-names formula)))
2102 (setq orig (or (get-text-property 1 :orig-formula formula) "?"))
2103 (while (> ndown 0)
2104 (setq fields (org-split-string
2105 (org-no-properties
2106 (buffer-substring (point-at-bol) (point-at-eol)))
2107 " *| *"))
2108 (if (eq numbers t)
2109 (setq fields (mapcar
2110 (lambda (x) (number-to-string (string-to-number x)))
2111 fields)))
2112 (setq ndown (1- ndown))
2113 (setq form (copy-sequence formula)
2114 lispp (and (> (length form) 2)(equal (substring form 0 2) "'(")))
2115 (if (and lispp literal) (setq lispp 'literal))
2116 ;; Check for old vertical references
2117 (setq form (org-rewrite-old-row-references form))
2118 ;; Insert complex ranges
71d35b24
CD
2119 (while (and (string-match org-table-range-regexp form)
2120 (> (length (match-string 0 form)) 1))
20908596
CD
2121 (setq form
2122 (replace-match
2123 (save-match-data
2124 (org-table-make-reference
2125 (org-table-get-range (match-string 0 form) nil n0)
2126 keep-empty numbers lispp))
2127 t t form)))
2128 ;; Insert simple ranges
2129 (while (string-match "\\$\\([0-9]+\\)\\.\\.\\$\\([0-9]+\\)" form)
2130 (setq form
2131 (replace-match
2132 (save-match-data
2133 (org-table-make-reference
2134 (org-sublist
2135 fields (string-to-number (match-string 1 form))
2136 (string-to-number (match-string 2 form)))
2137 keep-empty numbers lispp))
2138 t t form)))
2139 (setq form0 form)
2140 ;; Insert the references to fields in same row
2141 (while (string-match "\\$\\([0-9]+\\)" form)
2142 (setq n (string-to-number (match-string 1 form))
2143 x (nth (1- (if (= n 0) n0 n)) fields))
2144 (unless x (error "Invalid field specifier \"%s\""
2145 (match-string 0 form)))
2146 (setq form (replace-match
2147 (save-match-data
2148 (org-table-make-reference x nil numbers lispp))
2149 t t form)))
2150
2151 (if lispp
2152 (setq ev (condition-case nil
2153 (eval (eval (read form)))
2154 (error "#ERROR"))
2155 ev (if (numberp ev) (number-to-string ev) ev))
2156 (or (fboundp 'calc-eval)
2157 (error "Calc does not seem to be installed, and is needed to evaluate the formula"))
2158 (setq ev (calc-eval (cons form modes)
2159 (if numbers 'num))))
2160
2161 (when org-table-formula-debug
2162 (with-output-to-temp-buffer "*Substitution History*"
2163 (princ (format "Substitution history of formula
2164Orig: %s
2165$xyz-> %s
2166@r$c-> %s
2167$1-> %s\n" orig formula form0 form))
2168 (if (listp ev)
2169 (princ (format " %s^\nError: %s"
2170 (make-string (car ev) ?\-) (nth 1 ev)))
2171 (princ (format "Result: %s\nFormat: %s\nFinal: %s"
2172 ev (or fmt "NONE")
2173 (if fmt (format fmt (string-to-number ev)) ev)))))
2174 (setq bw (get-buffer-window "*Substitution History*"))
93b62de8 2175 (org-fit-window-to-buffer bw)
20908596
CD
2176 (unless (and (interactive-p) (not ndown))
2177 (unless (let (inhibit-redisplay)
2178 (y-or-n-p "Debugging Formula. Continue to next? "))
2179 (org-table-align)
2180 (error "Abort"))
2181 (delete-window bw)
2182 (message "")))
2183 (if (listp ev) (setq fmt nil ev "#ERROR"))
2184 (org-table-justify-field-maybe
2185 (if fmt (format fmt (string-to-number ev)) ev))
2186 (if (and down (> ndown 0) (looking-at ".*\n[ \t]*|[^-]"))
2187 (call-interactively 'org-return)
2188 (setq ndown 0)))
2189 (and down (org-table-maybe-recalculate-line))
2190 (or suppress-align (and org-table-may-need-update
2191 (org-table-align))))))
2192
2193(defun org-table-put-field-property (prop value)
2194 (save-excursion
2195 (put-text-property (progn (skip-chars-backward "^|") (point))
2196 (progn (skip-chars-forward "^|") (point))
2197 prop value)))
2198
2199(defun org-table-get-range (desc &optional tbeg col highlight)
2200 "Get a calc vector from a column, accorting to descriptor DESC.
2201Optional arguments TBEG and COL can give the beginning of the table and
2202the current column, to avoid unnecessary parsing.
2203HIGHLIGHT means, just highlight the range."
2204 (if (not (equal (string-to-char desc) ?@))
2205 (setq desc (concat "@" desc)))
2206 (save-excursion
2207 (or tbeg (setq tbeg (org-table-begin)))
2208 (or col (setq col (org-table-current-column)))
2209 (let ((thisline (org-current-line))
2210 beg end c1 c2 r1 r2 rangep tmp)
2211 (unless (string-match org-table-range-regexp desc)
2212 (error "Invalid table range specifier `%s'" desc))
2213 (setq rangep (match-end 3)
2214 r1 (and (match-end 1) (match-string 1 desc))
2215 r2 (and (match-end 4) (match-string 4 desc))
2216 c1 (and (match-end 2) (substring (match-string 2 desc) 1))
2217 c2 (and (match-end 5) (substring (match-string 5 desc) 1)))
2218
2219 (and c1 (setq c1 (+ (string-to-number c1)
2220 (if (memq (string-to-char c1) '(?- ?+)) col 0))))
2221 (and c2 (setq c2 (+ (string-to-number c2)
2222 (if (memq (string-to-char c2) '(?- ?+)) col 0))))
2223 (if (equal r1 "") (setq r1 nil))
2224 (if (equal r2 "") (setq r2 nil))
2225 (if r1 (setq r1 (org-table-get-descriptor-line r1)))
2226 (if r2 (setq r2 (org-table-get-descriptor-line r2)))
2227; (setq r2 (or r2 r1) c2 (or c2 c1))
2228 (if (not r1) (setq r1 thisline))
2229 (if (not r2) (setq r2 thisline))
2230 (if (not c1) (setq c1 col))
2231 (if (not c2) (setq c2 col))
2232 (if (or (not rangep) (and (= r1 r2) (= c1 c2)))
2233 ;; just one field
2234 (progn
2235 (goto-line r1)
2236 (while (not (looking-at org-table-dataline-regexp))
2237 (beginning-of-line 2))
2238 (prog1 (org-trim (org-table-get-field c1))
2239 (if highlight (org-table-highlight-rectangle (point) (point)))))
2240 ;; A range, return a vector
2241 ;; First sort the numbers to get a regular ractangle
2242 (if (< r2 r1) (setq tmp r1 r1 r2 r2 tmp))
2243 (if (< c2 c1) (setq tmp c1 c1 c2 c2 tmp))
2244 (goto-line r1)
2245 (while (not (looking-at org-table-dataline-regexp))
2246 (beginning-of-line 2))
2247 (org-table-goto-column c1)
2248 (setq beg (point))
2249 (goto-line r2)
2250 (while (not (looking-at org-table-dataline-regexp))
2251 (beginning-of-line 0))
2252 (org-table-goto-column c2)
2253 (setq end (point))
2254 (if highlight
2255 (org-table-highlight-rectangle
2256 beg (progn (skip-chars-forward "^|\n") (point))))
2257 ;; return string representation of calc vector
2258 (mapcar 'org-trim
2259 (apply 'append (org-table-copy-region beg end)))))))
2260
2261(defun org-table-get-descriptor-line (desc &optional cline bline table)
2262 "Analyze descriptor DESC and retrieve the corresponding line number.
2263The cursor is currently in line CLINE, the table begins in line BLINE,
2264and TABLE is a vector with line types."
2265 (if (string-match "^[0-9]+$" desc)
2266 (aref org-table-dlines (string-to-number desc))
2267 (setq cline (or cline (org-current-line))
2268 bline (or bline org-table-current-begin-line)
2269 table (or table org-table-current-line-types))
2270 (if (or
2271 (not (string-match "^\\(\\([-+]\\)?\\(I+\\)\\)?\\(\\([-+]\\)?\\([0-9]+\\)\\)?" desc))
2272 ;; 1 2 3 4 5 6
2273 (and (not (match-end 3)) (not (match-end 6)))
2274 (and (match-end 3) (match-end 6) (not (match-end 5))))
2275 (error "invalid row descriptor `%s'" desc))
2276 (let* ((hdir (and (match-end 2) (match-string 2 desc)))
2277 (hn (if (match-end 3) (- (match-end 3) (match-beginning 3)) nil))
2278 (odir (and (match-end 5) (match-string 5 desc)))
2279 (on (if (match-end 6) (string-to-number (match-string 6 desc))))
2280 (i (- cline bline))
2281 (rel (and (match-end 6)
2282 (or (and (match-end 1) (not (match-end 3)))
2283 (match-end 5)))))
2284 (if (and hn (not hdir))
2285 (progn
2286 (setq i 0 hdir "+")
2287 (if (eq (aref table 0) 'hline) (setq hn (1- hn)))))
2288 (if (and (not hn) on (not odir))
2289 (error "should never happen");;(aref org-table-dlines on)
2290 (if (and hn (> hn 0))
2291 (setq i (org-find-row-type table i 'hline (equal hdir "-") nil hn)))
2292 (if on
2293 (setq i (org-find-row-type table i 'dline (equal odir "-") rel on)))
2294 (+ bline i)))))
2295
2296(defun org-find-row-type (table i type backwards relative n)
2297 (let ((l (length table)))
2298 (while (> n 0)
2299 (while (and (setq i (+ i (if backwards -1 1)))
2300 (>= i 0) (< i l)
2301 (not (eq (aref table i) type))
2302 (if (and relative (eq (aref table i) 'hline))
2303 (progn (setq i (- i (if backwards -1 1)) n 1) nil)
2304 t)))
2305 (setq n (1- n)))
2306 (if (or (< i 0) (>= i l))
2307 (error "Row descriptor leads outside table")
2308 i)))
2309
2310(defun org-rewrite-old-row-references (s)
2311 (if (string-match "&[-+0-9I]" s)
2312 (error "Formula contains old &row reference, please rewrite using @-syntax")
2313 s))
2314
2315(defun org-table-make-reference (elements keep-empty numbers lispp)
2316 "Convert list ELEMENTS to something appropriate to insert into formula.
2317KEEP-EMPTY indicated to keep empty fields, default is to skip them.
2318NUMBERS indicates that everything should be converted to numbers.
2319LISPP means to return something appropriate for a Lisp list."
2320 (if (stringp elements) ; just a single val
2321 (if lispp
2322 (if (eq lispp 'literal)
2323 elements
2324 (prin1-to-string (if numbers (string-to-number elements) elements)))
2325 (if (equal elements "") (setq elements "0"))
2326 (if numbers (setq elements (number-to-string (string-to-number elements))))
2327 (concat "(" elements ")"))
2328 (unless keep-empty
2329 (setq elements
2330 (delq nil
2331 (mapcar (lambda (x) (if (string-match "\\S-" x) x nil))
2332 elements))))
2333 (setq elements (or elements '("0")))
2334 (if lispp
2335 (mapconcat
2336 (lambda (x)
2337 (if (eq lispp 'literal)
2338 x
2339 (prin1-to-string (if numbers (string-to-number x) x))))
2340 elements " ")
2341 (concat "[" (mapconcat
2342 (lambda (x)
2343 (if numbers (number-to-string (string-to-number x)) x))
2344 elements
2345 ",") "]"))))
2346
2347(defun org-table-recalculate (&optional all noalign)
2348 "Recalculate the current table line by applying all stored formulas.
2349With prefix arg ALL, do this for all lines in the table."
2350 (interactive "P")
2351 (or (memq this-command org-recalc-commands)
2352 (setq org-recalc-commands (cons this-command org-recalc-commands)))
2353 (unless (org-at-table-p) (error "Not at a table"))
2354 (if (equal all '(16))
2355 (org-table-iterate)
2356 (org-table-get-specials)
2357 (let* ((eqlist (sort (org-table-get-stored-formulas)
2358 (lambda (a b) (string< (car a) (car b)))))
2359 (inhibit-redisplay (not debug-on-error))
2360 (line-re org-table-dataline-regexp)
2361 (thisline (org-current-line))
2362 (thiscol (org-table-current-column))
2363 beg end entry eqlnum eqlname eqlname1 eql (cnt 0) eq a name)
2364 ;; Insert constants in all formulas
2365 (setq eqlist
2366 (mapcar (lambda (x)
2367 (setcdr x (org-table-formula-substitute-names (cdr x)))
2368 x)
2369 eqlist))
2370 ;; Split the equation list
2371 (while (setq eq (pop eqlist))
2372 (if (<= (string-to-char (car eq)) ?9)
2373 (push eq eqlnum)
2374 (push eq eqlname)))
2375 (setq eqlnum (nreverse eqlnum) eqlname (nreverse eqlname))
2376 (if all
2377 (progn
2378 (setq end (move-marker (make-marker) (1+ (org-table-end))))
2379 (goto-char (setq beg (org-table-begin)))
2380 (if (re-search-forward org-table-calculate-mark-regexp end t)
2381 ;; This is a table with marked lines, compute selected lines
2382 (setq line-re org-table-recalculate-regexp)
2383 ;; Move forward to the first non-header line
2384 (if (and (re-search-forward org-table-dataline-regexp end t)
2385 (re-search-forward org-table-hline-regexp end t)
2386 (re-search-forward org-table-dataline-regexp end t))
2387 (setq beg (match-beginning 0))
2388 nil))) ;; just leave beg where it is
2389 (setq beg (point-at-bol)
2390 end (move-marker (make-marker) (1+ (point-at-eol)))))
2391 (goto-char beg)
2392 (and all (message "Re-applying formulas to full table..."))
2393
b349f79f 2394 ;; First find the named fields, and mark them untouchable
20908596
CD
2395 (remove-text-properties beg end '(org-untouchable t))
2396 (while (setq eq (pop eqlname))
2397 (setq name (car eq)
2398 a (assoc name org-table-named-field-locations))
2399 (and (not a)
2400 (string-match "@\\([0-9]+\\)\\$\\([0-9]+\\)" name)
2401 (setq a (list name
b349f79f
CD
2402 (condition-case nil
2403 (aref org-table-dlines
2404 (string-to-number (match-string 1 name)))
2405 (error (error "Invalid row number in %s"
2406 name)))
20908596
CD
2407 (string-to-number (match-string 2 name)))))
2408 (when (and a (or all (equal (nth 1 a) thisline)))
2409 (message "Re-applying formula to field: %s" name)
2410 (goto-line (nth 1 a))
2411 (org-table-goto-column (nth 2 a))
2412 (push (append a (list (cdr eq))) eqlname1)
2413 (org-table-put-field-property :org-untouchable t)))
2414
2415 ;; Now evauluate the column formulas, but skip fields covered by
2416 ;; field formulas
2417 (goto-char beg)
2418 (while (re-search-forward line-re end t)
2419 (unless (string-match "^ *[_^!$/] *$" (org-table-get-field 1))
2420 ;; Unprotected line, recalculate
2421 (and all (message "Re-applying formulas to full table...(line %d)"
2422 (setq cnt (1+ cnt))))
2423 (setq org-last-recalc-line (org-current-line))
2424 (setq eql eqlnum)
2425 (while (setq entry (pop eql))
2426 (goto-line org-last-recalc-line)
2427 (org-table-goto-column (string-to-number (car entry)) nil 'force)
2428 (unless (get-text-property (point) :org-untouchable)
2429 (org-table-eval-formula nil (cdr entry)
2430 'noalign 'nocst 'nostore 'noanalysis)))))
2431
2432 ;; Now evaluate the field formulas
2433 (while (setq eq (pop eqlname1))
2434 (message "Re-applying formula to field: %s" (car eq))
2435 (goto-line (nth 1 eq))
2436 (org-table-goto-column (nth 2 eq))
2437 (org-table-eval-formula nil (nth 3 eq) 'noalign 'nocst
2438 'nostore 'noanalysis))
2439
2440 (goto-line thisline)
2441 (org-table-goto-column thiscol)
2442 (remove-text-properties (point-min) (point-max) '(org-untouchable t))
2443 (or noalign (and org-table-may-need-update (org-table-align))
2444 (and all (message "Re-applying formulas to %d lines...done" cnt)))
2445
2446 ;; back to initial position
2447 (message "Re-applying formulas...done")
2448 (goto-line thisline)
2449 (org-table-goto-column thiscol)
2450 (or noalign (and org-table-may-need-update (org-table-align))
2451 (and all (message "Re-applying formulas...done"))))))
2452
2453(defun org-table-iterate (&optional arg)
2454 "Recalculate the table until it does not change anymore."
2455 (interactive "P")
2456 (let ((imax (if arg (prefix-numeric-value arg) 10))
2457 (i 0)
2458 (lasttbl (buffer-substring (org-table-begin) (org-table-end)))
2459 thistbl)
2460 (catch 'exit
2461 (while (< i imax)
2462 (setq i (1+ i))
2463 (org-table-recalculate 'all)
2464 (setq thistbl (buffer-substring (org-table-begin) (org-table-end)))
2465 (if (not (string= lasttbl thistbl))
2466 (setq lasttbl thistbl)
2467 (if (> i 1)
2468 (message "Convergence after %d iterations" i)
2469 (message "Table was already stable"))
2470 (throw 'exit t)))
2471 (error "No convergence after %d iterations" i))))
2472
2473(defun org-table-formula-substitute-names (f)
2474 "Replace $const with values in string F."
2475 (let ((start 0) a (f1 f) (pp (/= (string-to-char f) ?')))
2476 ;; First, check for column names
2477 (while (setq start (string-match org-table-column-name-regexp f start))
2478 (setq start (1+ start))
2479 (setq a (assoc (match-string 1 f) org-table-column-names))
2480 (setq f (replace-match (concat "$" (cdr a)) t t f)))
2481 ;; Parameters and constants
2482 (setq start 0)
2483 (while (setq start (string-match "\\$\\([a-zA-Z][_a-zA-Z0-9]*\\)" f start))
2484 (setq start (1+ start))
2485 (if (setq a (save-match-data
2486 (org-table-get-constant (match-string 1 f))))
2487 (setq f (replace-match
2488 (concat (if pp "(") a (if pp ")")) t t f))))
2489 (if org-table-formula-debug
2490 (put-text-property 0 (length f) :orig-formula f1 f))
2491 f))
2492
2493(defun org-table-get-constant (const)
2494 "Find the value for a parameter or constant in a formula.
2495Parameters get priority."
2496 (or (cdr (assoc const org-table-local-parameters))
2497 (cdr (assoc const org-table-formula-constants-local))
2498 (cdr (assoc const org-table-formula-constants))
2499 (and (fboundp 'constants-get) (constants-get const))
2500 (and (string= (substring const 0 (min 5 (length const))) "PROP_")
2501 (org-entry-get nil (substring const 5) 'inherit))
2502 "#UNDEFINED_NAME"))
2503
2504(defvar org-table-fedit-map
2505 (let ((map (make-sparse-keymap)))
2506 (org-defkey map "\C-x\C-s" 'org-table-fedit-finish)
2507 (org-defkey map "\C-c\C-s" 'org-table-fedit-finish)
2508 (org-defkey map "\C-c\C-c" 'org-table-fedit-finish)
2509 (org-defkey map "\C-c\C-q" 'org-table-fedit-abort)
2510 (org-defkey map "\C-c?" 'org-table-show-reference)
2511 (org-defkey map [(meta shift up)] 'org-table-fedit-line-up)
2512 (org-defkey map [(meta shift down)] 'org-table-fedit-line-down)
2513 (org-defkey map [(shift up)] 'org-table-fedit-ref-up)
2514 (org-defkey map [(shift down)] 'org-table-fedit-ref-down)
2515 (org-defkey map [(shift left)] 'org-table-fedit-ref-left)
2516 (org-defkey map [(shift right)] 'org-table-fedit-ref-right)
2517 (org-defkey map [(meta up)] 'org-table-fedit-scroll-down)
2518 (org-defkey map [(meta down)] 'org-table-fedit-scroll)
2519 (org-defkey map [(meta tab)] 'lisp-complete-symbol)
2520 (org-defkey map "\M-\C-i" 'lisp-complete-symbol)
2521 (org-defkey map [(tab)] 'org-table-fedit-lisp-indent)
2522 (org-defkey map "\C-i" 'org-table-fedit-lisp-indent)
2523 (org-defkey map "\C-c\C-r" 'org-table-fedit-toggle-ref-type)
2524 (org-defkey map "\C-c}" 'org-table-fedit-toggle-coordinates)
2525 map))
2526
2527(easy-menu-define org-table-fedit-menu org-table-fedit-map "Org Edit Formulas Menu"
2528 '("Edit-Formulas"
2529 ["Finish and Install" org-table-fedit-finish t]
2530 ["Finish, Install, and Apply" (org-table-fedit-finish t) :keys "C-u C-c C-c"]
2531 ["Abort" org-table-fedit-abort t]
2532 "--"
2533 ["Pretty-Print Lisp Formula" org-table-fedit-lisp-indent t]
2534 ["Complete Lisp Symbol" lisp-complete-symbol t]
2535 "--"
2536 "Shift Reference at Point"
2537 ["Up" org-table-fedit-ref-up t]
2538 ["Down" org-table-fedit-ref-down t]
2539 ["Left" org-table-fedit-ref-left t]
2540 ["Right" org-table-fedit-ref-right t]
2541 "-"
2542 "Change Test Row for Column Formulas"
2543 ["Up" org-table-fedit-line-up t]
2544 ["Down" org-table-fedit-line-down t]
2545 "--"
2546 ["Scroll Table Window" org-table-fedit-scroll t]
2547 ["Scroll Table Window down" org-table-fedit-scroll-down t]
2548 ["Show Table Grid" org-table-fedit-toggle-coordinates
2549 :style toggle :selected (with-current-buffer (marker-buffer org-pos)
2550 org-table-overlay-coordinates)]
2551 "--"
2552 ["Standard Refs (B3 instead of @3$2)" org-table-fedit-toggle-ref-type
2553 :style toggle :selected org-table-buffer-is-an]))
2554
2555(defvar org-pos)
2556
2557(defun org-table-edit-formulas ()
2558 "Edit the formulas of the current table in a separate buffer."
2559 (interactive)
2560 (when (save-excursion (beginning-of-line 1) (looking-at "#\\+TBLFM"))
2561 (beginning-of-line 0))
2562 (unless (org-at-table-p) (error "Not at a table"))
2563 (org-table-get-specials)
2564 (let ((key (org-table-current-field-formula 'key 'noerror))
2565 (eql (sort (org-table-get-stored-formulas 'noerror)
2566 'org-table-formula-less-p))
2567 (pos (move-marker (make-marker) (point)))
2568 (startline 1)
2569 (wc (current-window-configuration))
2570 (titles '((column . "# Column Formulas\n")
2571 (field . "# Field Formulas\n")
2572 (named . "# Named Field Formulas\n")))
2573 entry s type title)
2574 (org-switch-to-buffer-other-window "*Edit Formulas*")
2575 (erase-buffer)
2576 ;; Keep global-font-lock-mode from turning on font-lock-mode
2577 (let ((font-lock-global-modes '(not fundamental-mode)))
2578 (fundamental-mode))
2579 (org-set-local 'font-lock-global-modes (list 'not major-mode))
2580 (org-set-local 'org-pos pos)
2581 (org-set-local 'org-window-configuration wc)
2582 (use-local-map org-table-fedit-map)
2583 (org-add-hook 'post-command-hook 'org-table-fedit-post-command t t)
2584 (easy-menu-add org-table-fedit-menu)
2585 (setq startline (org-current-line))
2586 (while (setq entry (pop eql))
2587 (setq type (cond
2588 ((equal (string-to-char (car entry)) ?@) 'field)
2589 ((string-match "^[0-9]" (car entry)) 'column)
2590 (t 'named)))
2591 (when (setq title (assq type titles))
2592 (or (bobp) (insert "\n"))
2593 (insert (org-add-props (cdr title) nil 'face font-lock-comment-face))
2594 (setq titles (delq title titles)))
2595 (if (equal key (car entry)) (setq startline (org-current-line)))
2596 (setq s (concat (if (equal (string-to-char (car entry)) ?@) "" "$")
2597 (car entry) " = " (cdr entry) "\n"))
2598 (remove-text-properties 0 (length s) '(face nil) s)
2599 (insert s))
2600 (if (eq org-table-use-standard-references t)
2601 (org-table-fedit-toggle-ref-type))
2602 (goto-line startline)
2603 (message "Edit formulas and finish with `C-c C-c'. See menu for more commands.")))
2604
2605(defun org-table-fedit-post-command ()
2606 (when (not (memq this-command '(lisp-complete-symbol)))
2607 (let ((win (selected-window)))
2608 (save-excursion
2609 (condition-case nil
2610 (org-table-show-reference)
2611 (error nil))
2612 (select-window win)))))
2613
2614(defun org-table-formula-to-user (s)
2615 "Convert a formula from internal to user representation."
2616 (if (eq org-table-use-standard-references t)
2617 (org-table-convert-refs-to-an s)
2618 s))
2619
2620(defun org-table-formula-from-user (s)
2621 "Convert a formula from user to internal representation."
2622 (if org-table-use-standard-references
2623 (org-table-convert-refs-to-rc s)
2624 s))
2625
2626(defun org-table-convert-refs-to-rc (s)
2627 "Convert spreadsheet references from AB7 to @7$28.
2628Works for single references, but also for entire formulas and even the
2629full TBLFM line."
2630 (let ((start 0))
2631 (while (string-match "\\<\\([a-zA-Z]+\\)\\([0-9]+\\>\\|&\\)\\|\\(;[^\r\n:]+\\)" s start)
2632 (cond
2633 ((match-end 3)
2634 ;; format match, just advance
2635 (setq start (match-end 0)))
2636 ((and (> (match-beginning 0) 0)
2637 (equal ?. (aref s (max (1- (match-beginning 0)) 0)))
2638 (not (equal ?. (aref s (max (- (match-beginning 0) 2) 0)))))
2639 ;; 3.e5 or something like this.
2640 (setq start (match-end 0)))
2641 (t
2642 (setq start (match-beginning 0)
2643 s (replace-match
2644 (if (equal (match-string 2 s) "&")
2645 (format "$%d" (org-letters-to-number (match-string 1 s)))
2646 (format "@%d$%d"
2647 (string-to-number (match-string 2 s))
2648 (org-letters-to-number (match-string 1 s))))
2649 t t s)))))
2650 s))
2651
2652(defun org-table-convert-refs-to-an (s)
2653 "Convert spreadsheet references from to @7$28 to AB7.
2654Works for single references, but also for entire formulas and even the
2655full TBLFM line."
2656 (while (string-match "@\\([0-9]+\\)\\$\\([0-9]+\\)" s)
2657 (setq s (replace-match
2658 (format "%s%d"
2659 (org-number-to-letters
2660 (string-to-number (match-string 2 s)))
2661 (string-to-number (match-string 1 s)))
2662 t t s)))
2663 (while (string-match "\\(^\\|[^0-9a-zA-Z]\\)\\$\\([0-9]+\\)" s)
2664 (setq s (replace-match (concat "\\1"
2665 (org-number-to-letters
2666 (string-to-number (match-string 2 s))) "&")
2667 t nil s)))
2668 s)
2669
2670(defun org-letters-to-number (s)
2671 "Convert a base 26 number represented by letters into an integer.
2672For example: AB -> 28."
2673 (let ((n 0))
2674 (setq s (upcase s))
2675 (while (> (length s) 0)
2676 (setq n (+ (* n 26) (string-to-char s) (- ?A) 1)
2677 s (substring s 1)))
2678 n))
2679
2680(defun org-number-to-letters (n)
2681 "Convert an integer into a base 26 number represented by letters.
2682For example: 28 -> AB."
2683 (let ((s ""))
2684 (while (> n 0)
2685 (setq s (concat (char-to-string (+ (mod (1- n) 26) ?A)) s)
2686 n (/ (1- n) 26)))
2687 s))
2688
2689(defun org-table-fedit-convert-buffer (function)
2690 "Convert all references in this buffer, using FUNTION."
2691 (let ((line (org-current-line)))
2692 (goto-char (point-min))
2693 (while (not (eobp))
2694 (insert (funcall function (buffer-substring (point) (point-at-eol))))
2695 (delete-region (point) (point-at-eol))
2696 (or (eobp) (forward-char 1)))
2697 (goto-line line)))
2698
2699(defun org-table-fedit-toggle-ref-type ()
2700 "Convert all references in the buffer from B3 to @3$2 and back."
2701 (interactive)
2702 (org-set-local 'org-table-buffer-is-an (not org-table-buffer-is-an))
2703 (org-table-fedit-convert-buffer
2704 (if org-table-buffer-is-an
2705 'org-table-convert-refs-to-an 'org-table-convert-refs-to-rc))
2706 (message "Reference type switched to %s"
2707 (if org-table-buffer-is-an "A1 etc" "@row$column")))
2708
2709(defun org-table-fedit-ref-up ()
2710 "Shift the reference at point one row/hline up."
2711 (interactive)
2712 (org-table-fedit-shift-reference 'up))
2713(defun org-table-fedit-ref-down ()
2714 "Shift the reference at point one row/hline down."
2715 (interactive)
2716 (org-table-fedit-shift-reference 'down))
2717(defun org-table-fedit-ref-left ()
2718 "Shift the reference at point one field to the left."
2719 (interactive)
2720 (org-table-fedit-shift-reference 'left))
2721(defun org-table-fedit-ref-right ()
2722 "Shift the reference at point one field to the right."
2723 (interactive)
2724 (org-table-fedit-shift-reference 'right))
2725
2726(defun org-table-fedit-shift-reference (dir)
2727 (cond
2728 ((org-at-regexp-p "\\(\\<[a-zA-Z]\\)&")
2729 (if (memq dir '(left right))
2730 (org-rematch-and-replace 1 (eq dir 'left))
2731 (error "Cannot shift reference in this direction")))
2732 ((org-at-regexp-p "\\(\\<[a-zA-Z]\\{1,2\\}\\)\\([0-9]+\\)")
2733 ;; A B3-like reference
2734 (if (memq dir '(up down))
2735 (org-rematch-and-replace 2 (eq dir 'up))
2736 (org-rematch-and-replace 1 (eq dir 'left))))
2737 ((org-at-regexp-p
2738 "\\(@\\|\\.\\.\\)\\([-+]?\\(I+\\>\\|[0-9]+\\)\\)\\(\\$\\([-+]?[0-9]+\\)\\)?")
2739 ;; An internal reference
2740 (if (memq dir '(up down))
2741 (org-rematch-and-replace 2 (eq dir 'up) (match-end 3))
2742 (org-rematch-and-replace 5 (eq dir 'left))))))
2743
2744(defun org-rematch-and-replace (n &optional decr hline)
2745 "Re-match the group N, and replace it with the shifted refrence."
2746 (or (match-end n) (error "Cannot shift reference in this direction"))
2747 (goto-char (match-beginning n))
2748 (and (looking-at (regexp-quote (match-string n)))
2749 (replace-match (org-shift-refpart (match-string 0) decr hline)
2750 t t)))
2751
2752(defun org-shift-refpart (ref &optional decr hline)
2753 "Shift a refrence part REF.
2754If DECR is set, decrease the references row/column, else increase.
2755If HLINE is set, this may be a hline reference, it certainly is not
2756a translation reference."
2757 (save-match-data
2758 (let* ((sign (string-match "^[-+]" ref)) n)
2759
2760 (if sign (setq sign (substring ref 0 1) ref (substring ref 1)))
2761 (cond
2762 ((and hline (string-match "^I+" ref))
2763 (setq n (string-to-number (concat sign (number-to-string (length ref)))))
2764 (setq n (+ n (if decr -1 1)))
2765 (if (= n 0) (setq n (+ n (if decr -1 1))))
2766 (if sign
2767 (setq sign (if (< n 0) "-" "+") n (abs n))
2768 (setq n (max 1 n)))
2769 (concat sign (make-string n ?I)))
2770
2771 ((string-match "^[0-9]+" ref)
2772 (setq n (string-to-number (concat sign ref)))
2773 (setq n (+ n (if decr -1 1)))
2774 (if sign
2775 (concat (if (< n 0) "-" "+") (number-to-string (abs n)))
2776 (number-to-string (max 1 n))))
2777
2778 ((string-match "^[a-zA-Z]+" ref)
2779 (org-number-to-letters
2780 (max 1 (+ (org-letters-to-number ref) (if decr -1 1)))))
2781
2782 (t (error "Cannot shift reference"))))))
2783
2784(defun org-table-fedit-toggle-coordinates ()
2785 "Toggle the display of coordinates in the refrenced table."
2786 (interactive)
2787 (let ((pos (marker-position org-pos)))
2788 (with-current-buffer (marker-buffer org-pos)
2789 (save-excursion
2790 (goto-char pos)
2791 (org-table-toggle-coordinate-overlays)))))
2792
2793(defun org-table-fedit-finish (&optional arg)
2794 "Parse the buffer for formula definitions and install them.
2795With prefix ARG, apply the new formulas to the table."
2796 (interactive "P")
2797 (org-table-remove-rectangle-highlight)
2798 (if org-table-use-standard-references
2799 (progn
2800 (org-table-fedit-convert-buffer 'org-table-convert-refs-to-rc)
2801 (setq org-table-buffer-is-an nil)))
2802 (let ((pos org-pos) eql var form)
2803 (goto-char (point-min))
2804 (while (re-search-forward
2805 "^\\(@[0-9]+\\$[0-9]+\\|\\$\\([a-zA-Z0-9]+\\)\\) *= *\\(.*\\(\n[ \t]+.*$\\)*\\)"
2806 nil t)
2807 (setq var (if (match-end 2) (match-string 2) (match-string 1))
2808 form (match-string 3))
2809 (setq form (org-trim form))
2810 (when (not (equal form ""))
2811 (while (string-match "[ \t]*\n[ \t]*" form)
2812 (setq form (replace-match " " t t form)))
2813 (when (assoc var eql)
2814 (error "Double formulas for %s" var))
2815 (push (cons var form) eql)))
2816 (setq org-pos nil)
2817 (set-window-configuration org-window-configuration)
2818 (select-window (get-buffer-window (marker-buffer pos)))
2819 (goto-char pos)
2820 (unless (org-at-table-p)
2821 (error "Lost table position - cannot install formulae"))
2822 (org-table-store-formulas eql)
2823 (move-marker pos nil)
2824 (kill-buffer "*Edit Formulas*")
2825 (if arg
2826 (org-table-recalculate 'all)
2827 (message "New formulas installed - press C-u C-c C-c to apply."))))
2828
2829(defun org-table-fedit-abort ()
2830 "Abort editing formulas, without installing the changes."
2831 (interactive)
2832 (org-table-remove-rectangle-highlight)
2833 (let ((pos org-pos))
2834 (set-window-configuration org-window-configuration)
2835 (select-window (get-buffer-window (marker-buffer pos)))
2836 (goto-char pos)
2837 (move-marker pos nil)
2838 (message "Formula editing aborted without installing changes")))
2839
2840(defun org-table-fedit-lisp-indent ()
2841 "Pretty-print and re-indent Lisp expressions in the Formula Editor."
2842 (interactive)
2843 (let ((pos (point)) beg end ind)
2844 (beginning-of-line 1)
2845 (cond
2846 ((looking-at "[ \t]")
2847 (goto-char pos)
2848 (call-interactively 'lisp-indent-line))
2849 ((looking-at "[$&@0-9a-zA-Z]+ *= *[^ \t\n']") (goto-char pos))
2850 ((not (fboundp 'pp-buffer))
2851 (error "Cannot pretty-print. Command `pp-buffer' is not available."))
2852 ((looking-at "[$&@0-9a-zA-Z]+ *= *'(")
2853 (goto-char (- (match-end 0) 2))
2854 (setq beg (point))
2855 (setq ind (make-string (current-column) ?\ ))
2856 (condition-case nil (forward-sexp 1)
2857 (error
2858 (error "Cannot pretty-print Lisp expression: Unbalanced parenthesis")))
2859 (setq end (point))
2860 (save-restriction
2861 (narrow-to-region beg end)
2862 (if (eq last-command this-command)
2863 (progn
2864 (goto-char (point-min))
2865 (setq this-command nil)
2866 (while (re-search-forward "[ \t]*\n[ \t]*" nil t)
2867 (replace-match " ")))
2868 (pp-buffer)
2869 (untabify (point-min) (point-max))
2870 (goto-char (1+ (point-min)))
2871 (while (re-search-forward "^." nil t)
2872 (beginning-of-line 1)
2873 (insert ind))
2874 (goto-char (point-max))
2875 (backward-delete-char 1)))
2876 (goto-char beg))
2877 (t nil))))
2878
2879(defvar org-show-positions nil)
2880
2881(defun org-table-show-reference (&optional local)
2882 "Show the location/value of the $ expression at point."
2883 (interactive)
2884 (org-table-remove-rectangle-highlight)
2885 (catch 'exit
2886 (let ((pos (if local (point) org-pos))
2887 (face2 'highlight)
2888 (org-inhibit-highlight-removal t)
2889 (win (selected-window))
2890 (org-show-positions nil)
2891 var name e what match dest)
2892 (if local (org-table-get-specials))
2893 (setq what (cond
2894 ((or (org-at-regexp-p org-table-range-regexp2)
2895 (org-at-regexp-p org-table-translate-regexp)
2896 (org-at-regexp-p org-table-range-regexp))
2897 (setq match
2898 (save-match-data
2899 (org-table-convert-refs-to-rc (match-string 0))))
2900 'range)
2901 ((org-at-regexp-p "\\$[a-zA-Z][a-zA-Z0-9]*") 'name)
2902 ((org-at-regexp-p "\\$[0-9]+") 'column)
2903 ((not local) nil)
2904 (t (error "No reference at point")))
2905 match (and what (or match (match-string 0))))
2906 (when (and match (not (equal (match-beginning 0) (point-at-bol))))
2907 (org-table-add-rectangle-overlay (match-beginning 0) (match-end 0)
2908 'secondary-selection))
2909 (org-add-hook 'before-change-functions
2910 'org-table-remove-rectangle-highlight)
2911 (if (eq what 'name) (setq var (substring match 1)))
2912 (when (eq what 'range)
2913 (or (equal (string-to-char match) ?@) (setq match (concat "@" match)))
2914 (setq match (org-table-formula-substitute-names match)))
2915 (unless local
2916 (save-excursion
2917 (end-of-line 1)
2918 (re-search-backward "^\\S-" nil t)
2919 (beginning-of-line 1)
2920 (when (looking-at "\\(\\$[0-9a-zA-Z]+\\|@[0-9]+\\$[0-9]+\\|[a-zA-Z]+\\([0-9]+\\|&\\)\\) *=")
2921 (setq dest
2922 (save-match-data
2923 (org-table-convert-refs-to-rc (match-string 1))))
2924 (org-table-add-rectangle-overlay
2925 (match-beginning 1) (match-end 1) face2))))
2926 (if (and (markerp pos) (marker-buffer pos))
2927 (if (get-buffer-window (marker-buffer pos))
2928 (select-window (get-buffer-window (marker-buffer pos)))
2929 (org-switch-to-buffer-other-window (get-buffer-window
2930 (marker-buffer pos)))))
2931 (goto-char pos)
2932 (org-table-force-dataline)
2933 (when dest
2934 (setq name (substring dest 1))
2935 (cond
2936 ((string-match "^\\$[a-zA-Z][a-zA-Z0-9]*" dest)
2937 (setq e (assoc name org-table-named-field-locations))
2938 (goto-line (nth 1 e))
2939 (org-table-goto-column (nth 2 e)))
2940 ((string-match "^@\\([0-9]+\\)\\$\\([0-9]+\\)" dest)
2941 (let ((l (string-to-number (match-string 1 dest)))
2942 (c (string-to-number (match-string 2 dest))))
2943 (goto-line (aref org-table-dlines l))
2944 (org-table-goto-column c)))
2945 (t (org-table-goto-column (string-to-number name))))
2946 (move-marker pos (point))
2947 (org-table-highlight-rectangle nil nil face2))
2948 (cond
2949 ((equal dest match))
2950 ((not match))
2951 ((eq what 'range)
2952 (condition-case nil
2953 (save-excursion
2954 (org-table-get-range match nil nil 'highlight))
2955 (error nil)))
2956 ((setq e (assoc var org-table-named-field-locations))
2957 (goto-line (nth 1 e))
2958 (org-table-goto-column (nth 2 e))
2959 (org-table-highlight-rectangle (point) (point))
2960 (message "Named field, column %d of line %d" (nth 2 e) (nth 1 e)))
2961 ((setq e (assoc var org-table-column-names))
2962 (org-table-goto-column (string-to-number (cdr e)))
2963 (org-table-highlight-rectangle (point) (point))
2964 (goto-char (org-table-begin))
2965 (if (re-search-forward (concat "^[ \t]*| *! *.*?| *\\(" var "\\) *|")
2966 (org-table-end) t)
2967 (progn
2968 (goto-char (match-beginning 1))
2969 (org-table-highlight-rectangle)
2970 (message "Named column (column %s)" (cdr e)))
2971 (error "Column name not found")))
2972 ((eq what 'column)
2973 ;; column number
2974 (org-table-goto-column (string-to-number (substring match 1)))
2975 (org-table-highlight-rectangle (point) (point))
2976 (message "Column %s" (substring match 1)))
2977 ((setq e (assoc var org-table-local-parameters))
2978 (goto-char (org-table-begin))
2979 (if (re-search-forward (concat "^[ \t]*| *\\$ *.*?| *\\(" var "=\\)") nil t)
2980 (progn
2981 (goto-char (match-beginning 1))
2982 (org-table-highlight-rectangle)
2983 (message "Local parameter."))
2984 (error "Parameter not found")))
2985 (t
2986 (cond
2987 ((not var) (error "No reference at point"))
2988 ((setq e (assoc var org-table-formula-constants-local))
2989 (message "Local Constant: $%s=%s in #+CONSTANTS line."
2990 var (cdr e)))
2991 ((setq e (assoc var org-table-formula-constants))
2992 (message "Constant: $%s=%s in `org-table-formula-constants'."
2993 var (cdr e)))
2994 ((setq e (and (fboundp 'constants-get) (constants-get var)))
2995 (message "Constant: $%s=%s, from `constants.el'%s."
2996 var e (format " (%s units)" constants-unit-system)))
2997 (t (error "Undefined name $%s" var)))))
2998 (goto-char pos)
2999 (when (and org-show-positions
3000 (not (memq this-command '(org-table-fedit-scroll
3001 org-table-fedit-scroll-down))))
3002 (push pos org-show-positions)
3003 (push org-table-current-begin-pos org-show-positions)
3004 (let ((min (apply 'min org-show-positions))
3005 (max (apply 'max org-show-positions)))
3006 (goto-char min) (recenter 0)
3007 (goto-char max)
3008 (or (pos-visible-in-window-p max) (recenter -1))))
3009 (select-window win))))
3010
3011(defun org-table-force-dataline ()
3012 "Make sure the cursor is in a dataline in a table."
3013 (unless (save-excursion
3014 (beginning-of-line 1)
3015 (looking-at org-table-dataline-regexp))
3016 (let* ((re org-table-dataline-regexp)
3017 (p1 (save-excursion (re-search-forward re nil 'move)))
3018 (p2 (save-excursion (re-search-backward re nil 'move))))
3019 (cond ((and p1 p2)
3020 (goto-char (if (< (abs (- p1 (point))) (abs (- p2 (point))))
3021 p1 p2)))
3022 ((or p1 p2) (goto-char (or p1 p2)))
3023 (t (error "No table dataline around here"))))))
3024
3025(defun org-table-fedit-line-up ()
3026 "Move cursor one line up in the window showing the table."
3027 (interactive)
3028 (org-table-fedit-move 'previous-line))
3029
3030(defun org-table-fedit-line-down ()
3031 "Move cursor one line down in the window showing the table."
3032 (interactive)
3033 (org-table-fedit-move 'next-line))
3034
3035(defun org-table-fedit-move (command)
3036 "Move the cursor in the window shoinw the table.
3037Use COMMAND to do the motion, repeat if necessary to end up in a data line."
3038 (let ((org-table-allow-automatic-line-recalculation nil)
3039 (pos org-pos) (win (selected-window)) p)
3040 (select-window (get-buffer-window (marker-buffer org-pos)))
3041 (setq p (point))
3042 (call-interactively command)
3043 (while (and (org-at-table-p)
3044 (org-at-table-hline-p))
3045 (call-interactively command))
3046 (or (org-at-table-p) (goto-char p))
3047 (move-marker pos (point))
3048 (select-window win)))
3049
3050(defun org-table-fedit-scroll (N)
3051 (interactive "p")
3052 (let ((other-window-scroll-buffer (marker-buffer org-pos)))
3053 (scroll-other-window N)))
3054
3055(defun org-table-fedit-scroll-down (N)
3056 (interactive "p")
3057 (org-table-fedit-scroll (- N)))
3058
3059(defvar org-table-rectangle-overlays nil)
3060
3061(defun org-table-add-rectangle-overlay (beg end &optional face)
3062 "Add a new overlay."
3063 (let ((ov (org-make-overlay beg end)))
3064 (org-overlay-put ov 'face (or face 'secondary-selection))
3065 (push ov org-table-rectangle-overlays)))
3066
3067(defun org-table-highlight-rectangle (&optional beg end face)
3068 "Highlight rectangular region in a table."
3069 (setq beg (or beg (point)) end (or end (point)))
3070 (let ((b (min beg end))
3071 (e (max beg end))
3072 l1 c1 l2 c2 tmp)
3073 (and (boundp 'org-show-positions)
3074 (setq org-show-positions (cons b (cons e org-show-positions))))
3075 (goto-char (min beg end))
3076 (setq l1 (org-current-line)
3077 c1 (org-table-current-column))
3078 (goto-char (max beg end))
3079 (setq l2 (org-current-line)
3080 c2 (org-table-current-column))
3081 (if (> c1 c2) (setq tmp c1 c1 c2 c2 tmp))
3082 (goto-line l1)
3083 (beginning-of-line 1)
3084 (loop for line from l1 to l2 do
3085 (when (looking-at org-table-dataline-regexp)
3086 (org-table-goto-column c1)
3087 (skip-chars-backward "^|\n") (setq beg (point))
3088 (org-table-goto-column c2)
3089 (skip-chars-forward "^|\n") (setq end (point))
3090 (org-table-add-rectangle-overlay beg end face))
3091 (beginning-of-line 2))
3092 (goto-char b))
3093 (add-hook 'before-change-functions 'org-table-remove-rectangle-highlight))
3094
3095(defun org-table-remove-rectangle-highlight (&rest ignore)
3096 "Remove the rectangle overlays."
3097 (unless org-inhibit-highlight-removal
3098 (remove-hook 'before-change-functions 'org-table-remove-rectangle-highlight)
3099 (mapc 'org-delete-overlay org-table-rectangle-overlays)
3100 (setq org-table-rectangle-overlays nil)))
3101
3102(defvar org-table-coordinate-overlays nil
3103 "Collects the cooordinate grid overlays, so that they can be removed.")
3104(make-variable-buffer-local 'org-table-coordinate-overlays)
3105
3106(defun org-table-overlay-coordinates ()
3107 "Add overlays to the table at point, to show row/column coordinates."
3108 (interactive)
3109 (mapc 'org-delete-overlay org-table-coordinate-overlays)
3110 (setq org-table-coordinate-overlays nil)
3111 (save-excursion
3112 (let ((id 0) (ih 0) hline eol s1 s2 str ic ov beg)
3113 (goto-char (org-table-begin))
3114 (while (org-at-table-p)
3115 (setq eol (point-at-eol))
3116 (setq ov (org-make-overlay (point-at-bol) (1+ (point-at-bol))))
3117 (push ov org-table-coordinate-overlays)
3118 (setq hline (looking-at org-table-hline-regexp))
3119 (setq str (if hline (format "I*%-2d" (setq ih (1+ ih)))
3120 (format "%4d" (setq id (1+ id)))))
3121 (org-overlay-before-string ov str 'org-special-keyword 'evaporate)
3122 (when hline
3123 (setq ic 0)
3124 (while (re-search-forward "[+|]\\(-+\\)" eol t)
3125 (setq beg (1+ (match-beginning 0))
3126 ic (1+ ic)
3127 s1 (concat "$" (int-to-string ic))
3128 s2 (org-number-to-letters ic)
3129 str (if (eq org-table-use-standard-references t) s2 s1))
3130 (setq ov (org-make-overlay beg (+ beg (length str))))
3131 (push ov org-table-coordinate-overlays)
3132 (org-overlay-display ov str 'org-special-keyword 'evaporate)))
3133 (beginning-of-line 2)))))
3134
3135(defun org-table-toggle-coordinate-overlays ()
3136 "Toggle the display of Row/Column numbers in tables."
3137 (interactive)
3138 (setq org-table-overlay-coordinates (not org-table-overlay-coordinates))
3139 (message "Row/Column number display turned %s"
3140 (if org-table-overlay-coordinates "on" "off"))
3141 (if (and (org-at-table-p) org-table-overlay-coordinates)
3142 (org-table-align))
3143 (unless org-table-overlay-coordinates
3144 (mapc 'org-delete-overlay org-table-coordinate-overlays)
3145 (setq org-table-coordinate-overlays nil)))
3146
3147(defun org-table-toggle-formula-debugger ()
3148 "Toggle the formula debugger in tables."
3149 (interactive)
3150 (setq org-table-formula-debug (not org-table-formula-debug))
3151 (message "Formula debugging has been turned %s"
3152 (if org-table-formula-debug "on" "off")))
3153
3154;;; The orgtbl minor mode
3155
3156;; Define a minor mode which can be used in other modes in order to
3157;; integrate the org-mode table editor.
3158
3159;; This is really a hack, because the org-mode table editor uses several
3160;; keys which normally belong to the major mode, for example the TAB and
3161;; RET keys. Here is how it works: The minor mode defines all the keys
3162;; necessary to operate the table editor, but wraps the commands into a
3163;; function which tests if the cursor is currently inside a table. If that
3164;; is the case, the table editor command is executed. However, when any of
3165;; those keys is used outside a table, the function uses `key-binding' to
3166;; look up if the key has an associated command in another currently active
3167;; keymap (minor modes, major mode, global), and executes that command.
3168;; There might be problems if any of the keys used by the table editor is
3169;; otherwise used as a prefix key.
3170
3171;; Another challenge is that the key binding for TAB can be tab or \C-i,
3172;; likewise the binding for RET can be return or \C-m. Orgtbl-mode
3173;; addresses this by checking explicitly for both bindings.
3174
3175;; The optimized version (see variable `orgtbl-optimized') takes over
3176;; all keys which are bound to `self-insert-command' in the *global map*.
3177;; Some modes bind other commands to simple characters, for example
3178;; AUCTeX binds the double quote to `Tex-insert-quote'. With orgtbl-mode
3179;; active, this binding is ignored inside tables and replaced with a
3180;; modified self-insert.
3181
3182(defvar orgtbl-mode nil
3183 "Variable controlling `orgtbl-mode', a minor mode enabling the `org-mode'
3184table editor in arbitrary modes.")
3185(make-variable-buffer-local 'orgtbl-mode)
3186
3187(defvar orgtbl-mode-map (make-keymap)
3188 "Keymap for `orgtbl-mode'.")
3189
3190;;;###autoload
3191(defun turn-on-orgtbl ()
3192 "Unconditionally turn on `orgtbl-mode'."
3193 (orgtbl-mode 1))
3194
3195(defvar org-old-auto-fill-inhibit-regexp nil
3196 "Local variable used by `orgtbl-mode'")
3197
3198(defconst orgtbl-line-start-regexp "[ \t]*\\(|\\|#\\+\\(TBLFM\\|ORGTBL\\):\\)"
3199 "Matches a line belonging to an orgtbl.")
3200
3201(defconst orgtbl-extra-font-lock-keywords
3202 (list (list (concat "^" orgtbl-line-start-regexp ".*")
3203 0 (quote 'org-table) 'prepend))
3204 "Extra font-lock-keywords to be added when orgtbl-mode is active.")
3205
3206;;;###autoload
3207(defun orgtbl-mode (&optional arg)
3208 "The `org-mode' table editor as a minor mode for use in other modes."
3209 (interactive)
3210 (org-load-modules-maybe)
3211 (if (org-mode-p)
3212 ;; Exit without error, in case some hook functions calls this
3213 ;; by accident in org-mode.
3214 (message "Orgtbl-mode is not useful in org-mode, command ignored")
3215 (setq orgtbl-mode
3216 (if arg (> (prefix-numeric-value arg) 0) (not orgtbl-mode)))
3217 (if orgtbl-mode
3218 (progn
3219 (and (orgtbl-setup) (defun orgtbl-setup () nil))
3220 ;; Make sure we are first in minor-mode-map-alist
3221 (let ((c (assq 'orgtbl-mode minor-mode-map-alist)))
3222 (and c (setq minor-mode-map-alist
3223 (cons c (delq c minor-mode-map-alist)))))
3224 (org-set-local (quote org-table-may-need-update) t)
3225 (org-add-hook 'before-change-functions 'org-before-change-function
3226 nil 'local)
3227 (org-set-local 'org-old-auto-fill-inhibit-regexp
3228 auto-fill-inhibit-regexp)
3229 (org-set-local 'auto-fill-inhibit-regexp
3230 (if auto-fill-inhibit-regexp
3231 (concat orgtbl-line-start-regexp "\\|"
3232 auto-fill-inhibit-regexp)
3233 orgtbl-line-start-regexp))
3234 (org-add-to-invisibility-spec '(org-cwidth))
3235 (when (fboundp 'font-lock-add-keywords)
3236 (font-lock-add-keywords nil orgtbl-extra-font-lock-keywords)
3237 (org-restart-font-lock))
3238 (easy-menu-add orgtbl-mode-menu)
3239 (run-hooks 'orgtbl-mode-hook))
3240 (setq auto-fill-inhibit-regexp org-old-auto-fill-inhibit-regexp)
3241 (org-cleanup-narrow-column-properties)
3242 (org-remove-from-invisibility-spec '(org-cwidth))
3243 (remove-hook 'before-change-functions 'org-before-change-function t)
3244 (when (fboundp 'font-lock-remove-keywords)
3245 (font-lock-remove-keywords nil orgtbl-extra-font-lock-keywords)
3246 (org-restart-font-lock))
3247 (easy-menu-remove orgtbl-mode-menu)
3248 (force-mode-line-update 'all))))
3249
3250(defun org-cleanup-narrow-column-properties ()
3251 "Remove all properties related to narrow-column invisibility."
3252 (let ((s 1))
3253 (while (setq s (text-property-any s (point-max)
3254 'display org-narrow-column-arrow))
3255 (remove-text-properties s (1+ s) '(display t)))
3256 (setq s 1)
3257 (while (setq s (text-property-any s (point-max) 'org-cwidth 1))
3258 (remove-text-properties s (1+ s) '(org-cwidth t)))
3259 (setq s 1)
3260 (while (setq s (text-property-any s (point-max) 'invisible 'org-cwidth))
3261 (remove-text-properties s (1+ s) '(invisible t)))))
3262
3263;; Install it as a minor mode.
3264(put 'orgtbl-mode :included t)
3265(put 'orgtbl-mode :menu-tag "Org Table Mode")
3266(add-minor-mode 'orgtbl-mode " OrgTbl" orgtbl-mode-map)
3267
3268(defun orgtbl-make-binding (fun n &rest keys)
3269 "Create a function for binding in the table minor mode.
3270FUN is the command to call inside a table. N is used to create a unique
3271command name. KEYS are keys that should be checked in for a command
3272to execute outside of tables."
3273 (eval
3274 (list 'defun
3275 (intern (concat "orgtbl-hijacker-command-" (int-to-string n)))
3276 '(arg)
3277 (concat "In tables, run `" (symbol-name fun) "'.\n"
3278 "Outside of tables, run the binding of `"
3279 (mapconcat (lambda (x) (format "%s" x)) keys "' or `")
3280 "'.")
3281 '(interactive "p")
3282 (list 'if
3283 '(org-at-table-p)
3284 (list 'call-interactively (list 'quote fun))
3285 (list 'let '(orgtbl-mode)
3286 (list 'call-interactively
3287 (append '(or)
3288 (mapcar (lambda (k)
3289 (list 'key-binding k))
3290 keys)
3291 '('orgtbl-error))))))))
3292
3293(defun orgtbl-error ()
3294 "Error when there is no default binding for a table key."
3295 (interactive)
3296 (error "This key has no function outside tables"))
3297
3298(defun orgtbl-setup ()
3299 "Setup orgtbl keymaps."
3300 (let ((nfunc 0)
3301 (bindings
3302 (list
3303 '([(meta shift left)] org-table-delete-column)
3304 '([(meta left)] org-table-move-column-left)
3305 '([(meta right)] org-table-move-column-right)
3306 '([(meta shift right)] org-table-insert-column)
3307 '([(meta shift up)] org-table-kill-row)
3308 '([(meta shift down)] org-table-insert-row)
3309 '([(meta up)] org-table-move-row-up)
3310 '([(meta down)] org-table-move-row-down)
3311 '("\C-c\C-w" org-table-cut-region)
3312 '("\C-c\M-w" org-table-copy-region)
3313 '("\C-c\C-y" org-table-paste-rectangle)
3314 '("\C-c-" org-table-insert-hline)
3315 '("\C-c}" org-table-toggle-coordinate-overlays)
3316 '("\C-c{" org-table-toggle-formula-debugger)
3317 '("\C-m" org-table-next-row)
3318 '([(shift return)] org-table-copy-down)
20908596
CD
3319 '("\C-c?" org-table-field-info)
3320 '("\C-c " org-table-blank-field)
3321 '("\C-c+" org-table-sum)
3322 '("\C-c=" org-table-eval-formula)
3323 '("\C-c'" org-table-edit-formulas)
3324 '("\C-c`" org-table-edit-field)
3325 '("\C-c*" org-table-recalculate)
3326 '("\C-c|" org-table-create-or-convert-from-region)
3327 '("\C-c^" org-table-sort-lines)
3328 '([(control ?#)] org-table-rotate-recalc-marks)))
3329 elt key fun cmd)
3330 (while (setq elt (pop bindings))
3331 (setq nfunc (1+ nfunc))
3332 (setq key (org-key (car elt))
3333 fun (nth 1 elt)
3334 cmd (orgtbl-make-binding fun nfunc key))
3335 (org-defkey orgtbl-mode-map key cmd))
3336
3337 ;; Special treatment needed for TAB and RET
3338 (org-defkey orgtbl-mode-map [(return)]
3339 (orgtbl-make-binding 'orgtbl-ret 100 [(return)] "\C-m"))
3340 (org-defkey orgtbl-mode-map "\C-m"
3341 (orgtbl-make-binding 'orgtbl-ret 101 "\C-m" [(return)]))
3342
3343 (org-defkey orgtbl-mode-map [(tab)]
3344 (orgtbl-make-binding 'orgtbl-tab 102 [(tab)] "\C-i"))
3345 (org-defkey orgtbl-mode-map "\C-i"
3346 (orgtbl-make-binding 'orgtbl-tab 103 "\C-i" [(tab)]))
3347
3348 (org-defkey orgtbl-mode-map [(shift tab)]
3349 (orgtbl-make-binding 'org-table-previous-field 104
3350 [(shift tab)] [(tab)] "\C-i"))
3351
3352 (org-defkey orgtbl-mode-map "\M-\C-m"
3353 (orgtbl-make-binding 'org-table-wrap-region 105
3354 "\M-\C-m" [(meta return)]))
3355 (org-defkey orgtbl-mode-map [(meta return)]
3356 (orgtbl-make-binding 'org-table-wrap-region 106
3357 [(meta return)] "\M-\C-m"))
3358
3359 (org-defkey orgtbl-mode-map "\C-c\C-c" 'orgtbl-ctrl-c-ctrl-c)
3360 (when orgtbl-optimized
3361 ;; If the user wants maximum table support, we need to hijack
3362 ;; some standard editing functions
3363 (org-remap orgtbl-mode-map
3364 'self-insert-command 'orgtbl-self-insert-command
3365 'delete-char 'org-delete-char
3366 'delete-backward-char 'org-delete-backward-char)
3367 (org-defkey orgtbl-mode-map "|" 'org-force-self-insert))
3368 (easy-menu-define orgtbl-mode-menu orgtbl-mode-map "OrgTbl menu"
3369 '("OrgTbl"
3370 ["Align" org-ctrl-c-ctrl-c :active (org-at-table-p) :keys "C-c C-c"]
3371 ["Next Field" org-cycle :active (org-at-table-p) :keys "TAB"]
3372 ["Previous Field" org-shifttab :active (org-at-table-p) :keys "S-TAB"]
3373 ["Next Row" org-return :active (org-at-table-p) :keys "RET"]
3374 "--"
3375 ["Blank Field" org-table-blank-field :active (org-at-table-p) :keys "C-c SPC"]
3376 ["Edit Field" org-table-edit-field :active (org-at-table-p) :keys "C-c ` "]
3377 ["Copy Field from Above"
3378 org-table-copy-down :active (org-at-table-p) :keys "S-RET"]
3379 "--"
3380 ("Column"
3381 ["Move Column Left" org-metaleft :active (org-at-table-p) :keys "M-<left>"]
3382 ["Move Column Right" org-metaright :active (org-at-table-p) :keys "M-<right>"]
3383 ["Delete Column" org-shiftmetaleft :active (org-at-table-p) :keys "M-S-<left>"]
3384 ["Insert Column" org-shiftmetaright :active (org-at-table-p) :keys "M-S-<right>"])
3385 ("Row"
3386 ["Move Row Up" org-metaup :active (org-at-table-p) :keys "M-<up>"]
3387 ["Move Row Down" org-metadown :active (org-at-table-p) :keys "M-<down>"]
3388 ["Delete Row" org-shiftmetaup :active (org-at-table-p) :keys "M-S-<up>"]
3389 ["Insert Row" org-shiftmetadown :active (org-at-table-p) :keys "M-S-<down>"]
3390 ["Sort lines in region" org-table-sort-lines :active (org-at-table-p) :keys "C-c ^"]
3391 "--"
3392 ["Insert Hline" org-table-insert-hline :active (org-at-table-p) :keys "C-c -"])
3393 ("Rectangle"
3394 ["Copy Rectangle" org-copy-special :active (org-at-table-p)]
3395 ["Cut Rectangle" org-cut-special :active (org-at-table-p)]
3396 ["Paste Rectangle" org-paste-special :active (org-at-table-p)]
3397 ["Fill Rectangle" org-table-wrap-region :active (org-at-table-p)])
3398 "--"
3399 ("Radio tables"
3400 ["Insert table template" orgtbl-insert-radio-table
3401 (assq major-mode orgtbl-radio-table-templates)]
3402 ["Comment/uncomment table" orgtbl-toggle-comment t])
3403 "--"
3404 ["Set Column Formula" org-table-eval-formula :active (org-at-table-p) :keys "C-c ="]
3405 ["Set Field Formula" (org-table-eval-formula '(4)) :active (org-at-table-p) :keys "C-u C-c ="]
3406 ["Edit Formulas" org-table-edit-formulas :active (org-at-table-p) :keys "C-c '"]
3407 ["Recalculate line" org-table-recalculate :active (org-at-table-p) :keys "C-c *"]
3408 ["Recalculate all" (org-table-recalculate '(4)) :active (org-at-table-p) :keys "C-u C-c *"]
3409 ["Iterate all" (org-table-recalculate '(16)) :active (org-at-table-p) :keys "C-u C-u C-c *"]
3410 ["Toggle Recalculate Mark" org-table-rotate-recalc-marks :active (org-at-table-p) :keys "C-c #"]
3411 ["Sum Column/Rectangle" org-table-sum
3412 :active (or (org-at-table-p) (org-region-active-p)) :keys "C-c +"]
3413 ["Which Column?" org-table-current-column :active (org-at-table-p) :keys "C-c ?"]
3414 ["Debug Formulas"
3415 org-table-toggle-formula-debugger :active (org-at-table-p)
3416 :keys "C-c {"
3417 :style toggle :selected org-table-formula-debug]
3418 ["Show Col/Row Numbers"
3419 org-table-toggle-coordinate-overlays :active (org-at-table-p)
3420 :keys "C-c }"
3421 :style toggle :selected org-table-overlay-coordinates]
3422 ))
3423 t))
3424
3425(defun orgtbl-ctrl-c-ctrl-c (arg)
3426 "If the cursor is inside a table, realign the table.
3427It it is a table to be sent away to a receiver, do it.
3428With prefix arg, also recompute table."
3429 (interactive "P")
3430 (let ((pos (point)) action)
3431 (save-excursion
3432 (beginning-of-line 1)
3433 (setq action (cond ((looking-at "#\\+ORGTBL:.*\n[ \t]*|") (match-end 0))
3434 ((looking-at "[ \t]*|") pos)
3435 ((looking-at "#\\+TBLFM:") 'recalc))))
3436 (cond
3437 ((integerp action)
3438 (goto-char action)
3439 (org-table-maybe-eval-formula)
3440 (if arg
3441 (call-interactively 'org-table-recalculate)
3442 (org-table-maybe-recalculate-line))
3443 (call-interactively 'org-table-align)
3444 (orgtbl-send-table 'maybe))
3445 ((eq action 'recalc)
3446 (save-excursion
3447 (beginning-of-line 1)
3448 (skip-chars-backward " \r\n\t")
3449 (if (org-at-table-p)
3450 (org-call-with-arg 'org-table-recalculate t))))
3451 (t (let (orgtbl-mode)
3452 (call-interactively (key-binding "\C-c\C-c")))))))
3453
3454(defun orgtbl-tab (arg)
3455 "Justification and field motion for `orgtbl-mode'."
3456 (interactive "P")
3457 (if arg (org-table-edit-field t)
3458 (org-table-justify-field-maybe)
3459 (org-table-next-field)))
3460
3461(defun orgtbl-ret ()
3462 "Justification and field motion for `orgtbl-mode'."
3463 (interactive)
3464 (org-table-justify-field-maybe)
3465 (org-table-next-row))
3466
3467(defun orgtbl-self-insert-command (N)
3468 "Like `self-insert-command', use overwrite-mode for whitespace in tables.
3469If the cursor is in a table looking at whitespace, the whitespace is
3470overwritten, and the table is not marked as requiring realignment."
3471 (interactive "p")
3472 (if (and (org-at-table-p)
3473 (or
3474 (and org-table-auto-blank-field
3475 (member last-command
3476 '(orgtbl-hijacker-command-100
3477 orgtbl-hijacker-command-101
3478 orgtbl-hijacker-command-102
3479 orgtbl-hijacker-command-103
3480 orgtbl-hijacker-command-104
3481 orgtbl-hijacker-command-105))
3482 (org-table-blank-field))
3483 t)
3484 (eq N 1)
3485 (looking-at "[^|\n]* +|"))
3486 (let (org-table-may-need-update)
3487 (goto-char (1- (match-end 0)))
3488 (delete-backward-char 1)
3489 (goto-char (match-beginning 0))
3490 (self-insert-command N))
3491 (setq org-table-may-need-update t)
621f83e4 3492 (let (orgtbl-mode a)
93b62de8 3493 (call-interactively
621f83e4
CD
3494 (key-binding
3495 (or (and (listp function-key-map)
3496 (setq a (assoc last-input-event function-key-map))
3497 (cdr a))
3498 (vector last-input-event)))))))
20908596
CD
3499
3500(defvar orgtbl-exp-regexp "^\\([-+]?[0-9][0-9.]*\\)[eE]\\([-+]?[0-9]+\\)$"
3501 "Regular expression matching exponentials as produced by calc.")
3502
3503(defun orgtbl-export (table target)
3504 (require 'org-exp)
3505 (let ((func (intern (concat "orgtbl-to-" (symbol-name target))))
3506 (lines (org-split-string table "[ \t]*\n[ \t]*"))
3507 org-table-last-alignment org-table-last-column-widths
3508 maxcol column)
3509 (if (not (fboundp func))
3510 (error "Cannot export orgtbl table to %s" target))
3511 (setq lines (org-table-clean-before-export lines))
3512 (setq table
3513 (mapcar
3514 (lambda (x)
3515 (if (string-match org-table-hline-regexp x)
3516 'hline
3517 (org-split-string (org-trim x) "\\s-*|\\s-*")))
3518 lines))
3519 (setq maxcol (apply 'max (mapcar (lambda (x) (if (listp x) (length x) 0))
3520 table)))
3521 (loop for i from (1- maxcol) downto 0 do
3522 (setq column (mapcar (lambda (x) (if (listp x) (nth i x) nil)) table))
3523 (setq column (delq nil column))
3524 (push (apply 'max (mapcar 'string-width column)) org-table-last-column-widths)
3525 (push (> (/ (apply '+ (mapcar (lambda (x) (if (string-match org-table-number-regexp x) 1 0)) column)) maxcol) org-table-number-fraction) org-table-last-alignment))
3526 (funcall func table nil)))
3527
3528(defun orgtbl-gather-send-defs ()
3529 "Gathers a plist of :name, :transform, :params for each destination before
3530a radio table."
3531 (save-excursion
3532 (goto-char (org-table-begin))
3533 (let (rtn)
3534 (beginning-of-line 0)
b349f79f 3535 (while (looking-at "#\\+ORGTBL[: \t][ \t]*SEND +\\([a-zA-Z0-9_]+\\) +\\([^ \t\r\n]+\\)\\( +.*\\)?")
20908596
CD
3536 (let ((name (org-no-properties (match-string 1)))
3537 (transform (intern (match-string 2)))
3538 (params (if (match-end 3)
3539 (read (concat "(" (match-string 3) ")")))))
3540 (push (list :name name :transform transform :params params)
3541 rtn)
3542 (beginning-of-line 0)))
3543 rtn)))
3544
3545(defun orgtbl-send-replace-tbl (name txt)
3546 "Find and replace table NAME with TXT."
3547 (save-excursion
3548 (goto-char (point-min))
3549 (unless (re-search-forward
3550 (concat "BEGIN RECEIVE ORGTBL +" name "\\([ \t]\\|$\\)") nil t)
3551 (error "Don't know where to insert translated table"))
3552 (goto-char (match-beginning 0))
3553 (beginning-of-line 2)
3554 (save-excursion
3555 (let ((beg (point)))
3556 (unless (re-search-forward
3557 (concat "END RECEIVE ORGTBL +" name) nil t)
3558 (error "Cannot find end of insertion region"))
3559 (beginning-of-line 1)
3560 (delete-region beg (point))))
3561 (insert txt "\n")))
3562
621f83e4 3563;;;###autoload
2c3ad40d
CD
3564(defun org-table-to-lisp (&optional txt)
3565 "Convert the table at point to a Lisp structure.
3566The structure will be a list. Each item is either the symbol `hline'
3567for a horizontal separator line, or a list of field values as strings.
3568The table is taken from the parameter TXT, or from the buffer at point."
3569 (unless txt
3570 (unless (org-at-table-p)
3571 (error "No table at point")))
93b62de8 3572 (let* ((txt (or txt
2c3ad40d
CD
3573 (buffer-substring-no-properties (org-table-begin)
3574 (org-table-end))))
3575 (lines (org-split-string txt "[ \t]*\n[ \t]*")))
3576
3577 (mapcar
3578 (lambda (x)
3579 (if (string-match org-table-hline-regexp x)
3580 'hline
3581 (org-split-string (org-trim x) "\\s-*|\\s-*")))
3582 lines)))
3583
20908596
CD
3584(defun orgtbl-send-table (&optional maybe)
3585 "Send a tranformed version of this table to the receiver position.
3586With argument MAYBE, fail quietly if no transformation is defined for
3587this table."
3588 (interactive)
3589 (catch 'exit
3590 (unless (org-at-table-p) (error "Not at a table"))
3591 ;; when non-interactive, we assume align has just happened.
3592 (when (interactive-p) (org-table-align))
3593 (let ((dests (orgtbl-gather-send-defs))
3594 (txt (buffer-substring-no-properties (org-table-begin)
3595 (org-table-end)))
3596 (ntbl 0))
3597 (unless dests (if maybe (throw 'exit nil)
3598 (error "Don't know how to transform this table.")))
3599 (dolist (dest dests)
3600 (let* ((name (plist-get dest :name))
3601 (transform (plist-get dest :transform))
3602 (params (plist-get dest :params))
3603 (skip (plist-get params :skip))
3604 (skipcols (plist-get params :skipcols))
3605 beg
3606 (lines (org-table-clean-before-export
3607 (nthcdr (or skip 0)
3608 (org-split-string txt "[ \t]*\n[ \t]*"))))
3609 (i0 (if org-table-clean-did-remove-column 2 1))
3610 (table (mapcar
3611 (lambda (x)
3612 (if (string-match org-table-hline-regexp x)
3613 'hline
3614 (org-remove-by-index
3615 (org-split-string (org-trim x) "\\s-*|\\s-*")
3616 skipcols i0)))
3617 lines))
3618 (fun (if (= i0 2) 'cdr 'identity))
3619 (org-table-last-alignment
3620 (org-remove-by-index (funcall fun org-table-last-alignment)
3621 skipcols i0))
3622 (org-table-last-column-widths
3623 (org-remove-by-index (funcall fun org-table-last-column-widths)
3624 skipcols i0))
3625 (txt (if (fboundp transform)
3626 (funcall transform table params)
3627 (error "No such transformation function %s" transform))))
3628 (orgtbl-send-replace-tbl name txt))
3629 (setq ntbl (1+ ntbl)))
3630 (message "Table converted and installed at %d receiver location%s"
3631 ntbl (if (> ntbl 1) "s" "")))))
3632
3633(defun org-remove-by-index (list indices &optional i0)
3634 "Remove the elements in LIST with indices in INDICES.
3635First element has index 0, or I0 if given."
3636 (if (not indices)
3637 list
3638 (if (integerp indices) (setq indices (list indices)))
3639 (setq i0 (1- (or i0 0)))
3640 (delq :rm (mapcar (lambda (x)
3641 (setq i0 (1+ i0))
3642 (if (memq i0 indices) :rm x))
3643 list))))
3644
3645(defun orgtbl-toggle-comment ()
3646 "Comment or uncomment the orgtbl at point."
3647 (interactive)
3648 (let* ((re1 (concat "^" (regexp-quote comment-start) orgtbl-line-start-regexp))
3649 (re2 (concat "^" orgtbl-line-start-regexp))
3650 (commented (save-excursion (beginning-of-line 1)
3651 (cond ((looking-at re1) t)
3652 ((looking-at re2) nil)
3653 (t (error "Not at an org table")))))
3654 (re (if commented re1 re2))
3655 beg end)
3656 (save-excursion
3657 (beginning-of-line 1)
3658 (while (looking-at re) (beginning-of-line 0))
3659 (beginning-of-line 2)
3660 (setq beg (point))
3661 (while (looking-at re) (beginning-of-line 2))
3662 (setq end (point)))
3663 (comment-region beg end (if commented '(4) nil))))
3664
3665(defun orgtbl-insert-radio-table ()
3666 "Insert a radio table template appropriate for this major mode."
3667 (interactive)
3668 (let* ((e (assq major-mode orgtbl-radio-table-templates))
3669 (txt (nth 1 e))
3670 name pos)
3671 (unless e (error "No radio table setup defined for %s" major-mode))
3672 (setq name (read-string "Table name: "))
3673 (while (string-match "%n" txt)
3674 (setq txt (replace-match name t t txt)))
3675 (or (bolp) (insert "\n"))
3676 (setq pos (point))
3677 (insert txt)
3678 (goto-char pos)))
3679
3680;; Dynamically bound input and output for table formatting.
3681(defvar *orgtbl-table* nil
3682 "Carries the current table through formatting routines.")
3683(defvar *orgtbl-rtn* nil
3684 "Formatting routines push the output lines here.")
3685;; Formatting parameters for the current table section.
3686(defvar *orgtbl-hline* nil "Text used for horizontal lines")
3687(defvar *orgtbl-sep* nil "Text used as a column separator")
b349f79f 3688(defvar *orgtbl-default-fmt* nil "Default format for each entry")
20908596
CD
3689(defvar *orgtbl-fmt* nil "Format for each entry")
3690(defvar *orgtbl-efmt* nil "Format for numbers")
3691(defvar *orgtbl-lfmt* nil "Format for an entire line, overrides fmt")
3692(defvar *orgtbl-llfmt* nil "Specializes lfmt for the last row")
3693(defvar *orgtbl-lstart* nil "Text starting a row")
3694(defvar *orgtbl-llstart* nil "Specializes lstart for the last row")
3695(defvar *orgtbl-lend* nil "Text ending a row")
3696(defvar *orgtbl-llend* nil "Specializes lend for the last row")
3697
3698(defsubst orgtbl-get-fmt (fmt i)
3699 "Retrieve the format from FMT corresponding to the Ith column."
3700 (if (and (not (functionp fmt)) (consp fmt))
3701 (plist-get fmt i)
3702 fmt))
3703
3704(defsubst orgtbl-apply-fmt (fmt &rest args)
3705 "Apply format FMT to the arguments. NIL FMTs return the first argument."
3706 (cond ((functionp fmt) (apply fmt args))
3707 (fmt (apply 'format fmt args))
3708 (args (car args))
3709 (t args)))
3710
3711(defsubst orgtbl-eval-str (str)
3712 "If STR is a function, evaluate it with no arguments."
3713 (if (functionp str)
3714 (funcall str)
3715 str))
3716
3717(defun orgtbl-format-line (line)
3718 "Format LINE as a table row."
3719 (if (eq line 'hline) (if *orgtbl-hline* (push *orgtbl-hline* *orgtbl-rtn*))
3720 (let* ((i 0)
3721 (line
3722 (mapcar
3723 (lambda (f)
3724 (setq i (1+ i))
3725 (let* ((efmt (orgtbl-get-fmt *orgtbl-efmt* i))
3726 (f (if (and efmt (string-match orgtbl-exp-regexp f))
3727 (orgtbl-apply-fmt efmt (match-string 1 f)
3728 (match-string 2 f))
3729 f)))
b349f79f
CD
3730 (orgtbl-apply-fmt (or (orgtbl-get-fmt *orgtbl-fmt* i)
3731 *orgtbl-default-fmt*)
3732 f)))
20908596
CD
3733 line)))
3734 (push (if *orgtbl-lfmt*
3735 (orgtbl-apply-fmt *orgtbl-lfmt* line)
3736 (concat (orgtbl-eval-str *orgtbl-lstart*)
3737 (mapconcat 'identity line *orgtbl-sep*)
3738 (orgtbl-eval-str *orgtbl-lend*)))
3739 *orgtbl-rtn*))))
3740
3741(defun orgtbl-format-section (section-stopper)
3742 "Format lines until the first occurrence of SECTION-STOPPER."
3743 (let (prevline)
3744 (progn
3745 (while (not (eq (car *orgtbl-table*) section-stopper))
3746 (if prevline (orgtbl-format-line prevline))
3747 (setq prevline (pop *orgtbl-table*)))
3748 (if prevline (let ((*orgtbl-lstart* *orgtbl-llstart*)
3749 (*orgtbl-lend* *orgtbl-llend*)
3750 (*orgtbl-lfmt* *orgtbl-llfmt*))
3751 (orgtbl-format-line prevline))))))
3752
3753(defun orgtbl-to-generic (table params)
3754 "Convert the orgtbl-mode TABLE to some other format.
3755This generic routine can be used for many standard cases.
3756TABLE is a list, each entry either the symbol `hline' for a horizontal
3757separator line, or a list of fields for that line.
3758PARAMS is a property list of parameters that can influence the conversion.
3759For the generic converter, some parameters are obligatory: You need to
b349f79f 3760specify either :lfmt, or all of (:lstart :lend :sep).
20908596
CD
3761
3762Valid parameters are
3763
3764:splice When set to t, return only table body lines, don't wrap
b349f79f
CD
3765 them into :tstart and :tend. Default is nil. When :splice
3766 is non-nil, this also means that the exporter should not look
3767 for and interpret header and footer sections.
20908596
CD
3768
3769:hline String to be inserted on horizontal separation lines.
3770 May be nil to ignore hlines.
3771
3772:sep Separator between two fields
3773:remove-nil-lines Do not include lines that evaluate to nil.
3774
3775
b349f79f
CD
3776Each in the following group may be either a string or a function
3777of no arguments returning a string:
20908596
CD
3778:tstart String to start the table. Ignored when :splice is t.
3779:tend String to end the table. Ignored when :splice is t.
3780:lstart String to start a new table line.
3781:llstart String to start the last table line, defaults to :lstart.
3782:lend String to end a table line
3783:llend String to end the last table line, defaults to :lend.
3784
b349f79f
CD
3785Each in the following group may be a string, a function of one
3786argument (the field or line) returning a string, or a plist
3787mapping columns to either of the above:
20908596
CD
3788:lfmt Format for entire line, with enough %s to capture all fields.
3789 If this is present, :lstart, :lend, and :sep are ignored.
3790:llfmt Format for the entire last line, defaults to :lfmt.
3791:fmt A format to be used to wrap the field, should contain
3792 %s for the original field value. For example, to wrap
3793 everything in dollars, you could use :fmt \"$%s$\".
3794 This may also be a property list with column numbers and
3795 formats. For example :fmt (2 \"$%s$\" 4 \"%s%%\")
3796
3797:hlstart :hllstart :hlend :hllend :hlsep :hlfmt :hllfmt :hfmt
3798 Same as above, specific for the header lines in the table.
3799 All lines before the first hline are treated as header.
3800 If any of these is not present, the data line value is used.
3801
b349f79f 3802This may be either a string or a function of two arguments:
20908596
CD
3803:efmt Use this format to print numbers with exponentials.
3804 The format should have %s twice for inserting mantissa
3805 and exponent, for example \"%s\\\\times10^{%s}\". This
3806 may also be a property list with column numbers and
3807 formats. :fmt will still be applied after :efmt.
3808
3809In addition to this, the parameters :skip and :skipcols are always handled
3810directly by `orgtbl-send-table'. See manual."
3811 (interactive)
3812
3813 (let* ((splicep (plist-get params :splice))
3814 (hline (plist-get params :hline))
3815 (remove-nil-linesp (plist-get params :remove-nil-lines))
3816 (*orgtbl-hline* hline)
3817 (*orgtbl-table* table)
3818 (*orgtbl-sep* (plist-get params :sep))
3819 (*orgtbl-efmt* (plist-get params :efmt))
3820 (*orgtbl-lstart* (plist-get params :lstart))
3821 (*orgtbl-llstart* (or (plist-get params :llstart) *orgtbl-lstart*))
3822 (*orgtbl-lend* (plist-get params :lend))
3823 (*orgtbl-llend* (or (plist-get params :llend) *orgtbl-lend*))
3824 (*orgtbl-lfmt* (plist-get params :lfmt))
3825 (*orgtbl-llfmt* (or (plist-get params :llfmt) *orgtbl-lfmt*))
3826 (*orgtbl-fmt* (plist-get params :fmt))
3827 *orgtbl-rtn*)
3828
3829 ;; Put header
3830 (unless splicep
b349f79f
CD
3831 (when (plist-member params :tstart)
3832 (let ((tstart (orgtbl-eval-str (plist-get params :tstart))))
3833 (if tstart (push tstart *orgtbl-rtn*)))))
20908596
CD
3834
3835 ;; Do we have a heading section? If so, format it and handle the
3836 ;; trailing hline.
3837 (if (and (not splicep) (listp (car *orgtbl-table*))
3838 (memq 'hline *orgtbl-table*))
3839 (progn
3840 (let* ((*orgtbl-lstart* (or (plist-get params :hlstart)
3841 *orgtbl-lstart*))
3842 (*orgtbl-llstart* (or (plist-get params :hllstart)
3843 *orgtbl-llstart*))
3844 (*orgtbl-lend* (or (plist-get params :hlend) *orgtbl-lend*))
3845 (*orgtbl-llend* (or (plist-get params :hllend)
3846 (plist-get params :hlend) *orgtbl-llend*))
3847 (*orgtbl-lfmt* (or (plist-get params :hlfmt) *orgtbl-lfmt*))
3848 (*orgtbl-llfmt* (or (plist-get params :hllfmt)
3849 (plist-get params :hlfmt) *orgtbl-llfmt*))
3850 (*orgtbl-sep* (or (plist-get params :hlsep) *orgtbl-sep*))
3851 (*orgtbl-fmt* (or (plist-get params :hfmt) *orgtbl-fmt*)))
3852 (orgtbl-format-section 'hline))
3853 (if hline (push hline *orgtbl-rtn*))
3854 (pop *orgtbl-table*)))
3855
3856 ;; Now format the main section.
3857 (orgtbl-format-section nil)
3858
3859 (unless splicep
b349f79f
CD
3860 (when (plist-member params :tend)
3861 (let ((tend (orgtbl-eval-str (plist-get params :tend))))
3862 (if tend (push tend *orgtbl-rtn*)))))
20908596
CD
3863
3864 (mapconcat 'identity (nreverse (if remove-nil-linesp
3865 (remq nil *orgtbl-rtn*)
3866 *orgtbl-rtn*)) "\n")))
3867
b349f79f
CD
3868(defun orgtbl-to-tsv (table params)
3869 "Convert the orgtbl-mode table to TAB separated material."
3870 (orgtbl-to-generic table (org-combine-plists '(:sep "\t") params)))
3871(defun orgtbl-to-csv (table params)
3872 "Convert the orgtbl-mode table to CSV material.
3873This does take care of the proper quoting of fields with comma or quotes."
3874 (orgtbl-to-generic table (org-combine-plists
3875 '(:sep "," :fmt org-quote-csv-field)
3876 params)))
3877
20908596
CD
3878(defun orgtbl-to-latex (table params)
3879 "Convert the orgtbl-mode TABLE to LaTeX.
3880TABLE is a list, each entry either the symbol `hline' for a horizontal
3881separator line, or a list of fields for that line.
3882PARAMS is a property list of parameters that can influence the conversion.
3883Supports all parameters from `orgtbl-to-generic'. Most important for
3884LaTeX are:
3885
3886:splice When set to t, return only table body lines, don't wrap
3887 them into a tabular environment. Default is nil.
3888
3889:fmt A format to be used to wrap the field, should contain %s for the
3890 original field value. For example, to wrap everything in dollars,
3891 use :fmt \"$%s$\". This may also be a property list with column
3892 numbers and formats. For example :fmt (2 \"$%s$\" 4 \"%s%%\")
3893 The format may also be a function that formats its one argument.
3894
3895:efmt Format for transforming numbers with exponentials. The format
3896 should have %s twice for inserting mantissa and exponent, for
3897 example \"%s\\\\times10^{%s}\". LaTeX default is \"%s\\\\,(%s)\".
3898 This may also be a property list with column numbers and formats.
3899 The format may also be a function that formats its two arguments.
3900
3901:llend If you find too much space below the last line of a table,
3902 pass a value of \"\" for :llend to suppress the final \\\\.
3903
3904The general parameters :skip and :skipcols have already been applied when
3905this function is called."
3906 (let* ((alignment (mapconcat (lambda (x) (if x "r" "l"))
3907 org-table-last-alignment ""))
3908 (params2
3909 (list
3910 :tstart (concat "\\begin{tabular}{" alignment "}")
3911 :tend "\\end{tabular}"
3912 :lstart "" :lend " \\\\" :sep " & "
3913 :efmt "%s\\,(%s)" :hline "\\hline")))
3914 (orgtbl-to-generic table (org-combine-plists params2 params))))
3915
3916(defun orgtbl-to-html (table params)
3917 "Convert the orgtbl-mode TABLE to LaTeX.
3918TABLE is a list, each entry either the symbol `hline' for a horizontal
3919separator line, or a list of fields for that line.
3920PARAMS is a property list of parameters that can influence the conversion.
3921Currently this function recognizes the following parameters:
3922
3923:splice When set to t, return only table body lines, don't wrap
3924 them into a <table> environment. Default is nil.
3925
3926The general parameters :skip and :skipcols have already been applied when
3927this function is called. The function does *not* use `orgtbl-to-generic',
3928so you cannot specify parameters for it."
3929 (let* ((splicep (plist-get params :splice))
71d35b24 3930 (html-table-tag org-export-html-table-tag)
20908596
CD
3931 html)
3932 ;; Just call the formatter we already have
3933 ;; We need to make text lines for it, so put the fields back together.
3934 (setq html (org-format-org-table-html
3935 (mapcar
3936 (lambda (x)
3937 (if (eq x 'hline)
3938 "|----+----|"
3939 (concat "| " (mapconcat 'identity x " | ") " |")))
3940 table)
3941 splicep))
3942 (if (string-match "\n+\\'" html)
3943 (setq html (replace-match "" t t html)))
3944 html))
3945
3946(defun orgtbl-to-texinfo (table params)
3947 "Convert the orgtbl-mode TABLE to TeXInfo.
3948TABLE is a list, each entry either the symbol `hline' for a horizontal
3949separator line, or a list of fields for that line.
3950PARAMS is a property list of parameters that can influence the conversion.
3951Supports all parameters from `orgtbl-to-generic'. Most important for
3952TeXInfo are:
3953
3954:splice nil/t When set to t, return only table body lines, don't wrap
3955 them into a multitable environment. Default is nil.
3956
3957:fmt fmt A format to be used to wrap the field, should contain
3958 %s for the original field value. For example, to wrap
3959 everything in @kbd{}, you could use :fmt \"@kbd{%s}\".
3960 This may also be a property list with column numbers and
3961 formats. For example :fmt (2 \"@kbd{%s}\" 4 \"@code{%s}\").
3962 Each format also may be a function that formats its one
3963 argument.
3964
3965:cf \"f1 f2..\" The column fractions for the table. By default these
3966 are computed automatically from the width of the columns
3967 under org-mode.
3968
3969The general parameters :skip and :skipcols have already been applied when
3970this function is called."
3971 (let* ((total (float (apply '+ org-table-last-column-widths)))
3972 (colfrac (or (plist-get params :cf)
3973 (mapconcat
3974 (lambda (x) (format "%.3f" (/ (float x) total)))
3975 org-table-last-column-widths " ")))
3976 (params2
3977 (list
3978 :tstart (concat "@multitable @columnfractions " colfrac)
3979 :tend "@end multitable"
3980 :lstart "@item " :lend "" :sep " @tab "
3981 :hlstart "@headitem ")))
3982 (orgtbl-to-generic table (org-combine-plists params2 params))))
3983
b349f79f
CD
3984(defun orgtbl-to-orgtbl (table params)
3985 "Convert the orgtbl-mode TABLE into another orgtbl-mode table.
3986Useful when slicing one table into many. The :hline, :sep,
3987:lstart, and :lend provide orgtbl framing. The default nil :tstart
3988and :tend suppress strings without splicing; they can be set to
3989provide ORGTBL directives for the generated table."
3990 (let* ((params2
3991 (list
3992 :tstart nil :tend nil
3993 :hline "|---"
3994 :sep " | "
3995 :lstart "| "
3996 :lend " |"))
3997 (params (org-combine-plists params2 params)))
3998 (orgtbl-to-generic table params)))
3999
20908596
CD
4000(provide 'org-table)
4001
88ac7b50 4002;; arch-tag: 4d21cfdd-0268-440a-84b0-09237a0fe0ef
b349f79f 4003
20908596 4004;;; org-table.el ends here