38414
|
1 ;;; select.el --- lisp portion of standard selection support
|
2234
|
2
|
45078
|
3 ;; Maintainer: FSF
|
2234
|
4 ;; Keywords: internal
|
|
5
|
74442
|
6 ;; Copyright (C) 1993, 1994, 2001, 2002, 2003, 2004,
|
75347
|
7 ;; 2005, 2006, 2007 Free Software Foundation, Inc.
|
2234
|
8 ;; Based partially on earlier release by Lucid.
|
|
9
|
|
10 ;; This file is part of GNU Emacs.
|
|
11
|
|
12 ;; GNU Emacs is free software; you can redistribute it and/or modify
|
|
13 ;; it under the terms of the GNU General Public License as published by
|
78236
|
14 ;; the Free Software Foundation; either version 3, or (at your option)
|
2234
|
15 ;; any later version.
|
|
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
|
14169
|
23 ;; along with GNU Emacs; see the file COPYING. If not, write to the
|
64091
|
24 ;; Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
|
|
25 ;; Boston, MA 02110-1301, USA.
|
2234
|
26
|
38414
|
27 ;;; Commentary:
|
|
28
|
2234
|
29 ;;; Code:
|
|
30
|
91103
|
31 (defvar selection-coding-system nil
|
|
32 "Coding system for communicating with other X clients.
|
|
33
|
|
34 When sending text via selection and clipboard, if the target
|
|
35 data-type matches with the type of this coding system, it is used
|
|
36 for encoding the text. Otherwise (including the case that this
|
|
37 variable is nil), a proper coding system is used as below:
|
|
38
|
|
39 data-type coding system
|
|
40 --------- -------------
|
|
41 UTF8_STRING utf-8
|
|
42 COMPOUND_TEXT compound-text-with-extensions
|
|
43 STRING iso-latin-1
|
|
44 C_STRING no-conversion
|
|
45
|
|
46 When receiving text, if this coding system is non-nil, it is used
|
|
47 for decoding regardless of the data-type. If this is nil, a
|
|
48 proper coding system is used according to the data-type as above.
|
|
49
|
|
50 See also the documentation of the variable `x-select-request-type' how
|
|
51 to control which data-type to request for receiving text.
|
|
52
|
|
53 The default value is nil.")
|
|
54
|
|
55 (defvar next-selection-coding-system nil
|
|
56 "Coding system for the next communication with other X clients.
|
|
57 Usually, `selection-coding-system' is used for communicating with
|
|
58 other X clients. But, if this variable is set, it is used for
|
|
59 the next communication only. After the communication, this
|
|
60 variable is set to nil.")
|
|
61
|
2234
|
62 ;; This is for temporary compatibility with pre-release Emacs 19.
|
2571
|
63 (defalias 'x-selection 'x-get-selection)
|
2234
|
64 (defun x-get-selection (&optional type data-type)
|
|
65 "Return the value of an X Windows selection.
|
49514
10a6fd9d8e9c
(x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
66 The argument TYPE (default `PRIMARY') says which selection,
|
19142
|
67 and the argument DATA-TYPE (default `STRING') says
|
33914
|
68 how to convert the data.
|
|
69
|
56531
|
70 TYPE may be any symbol \(but nil stands for `PRIMARY'). However,
|
|
71 only a few symbols are commonly used. They conventionally have
|
|
72 all upper-case names. The most often used ones, in addition to
|
|
73 `PRIMARY', are `SECONDARY' and `CLIPBOARD'.
|
|
74
|
33914
|
75 DATA-TYPE is usually `STRING', but can also be one of the symbols
|
|
76 in `selection-converter-alist', which see."
|
51600
|
77 (let ((data (x-get-selection-internal (or type 'PRIMARY)
|
|
78 (or data-type 'STRING)))
|
|
79 coding)
|
|
80 (when (and (stringp data)
|
|
81 (setq data-type (get-text-property 0 'foreign-selection data)))
|
91103
|
82 (setq coding (or next-selection-coding-system
|
|
83 selection-coding-system
|
|
84 (cond ((eq data-type 'UTF8_STRING)
|
|
85 'utf-8)
|
|
86 ((eq data-type 'COMPOUND-TEXT)
|
|
87 'compound-text-with-extensions)
|
|
88 ((eq data-type 'C_STRING)
|
|
89 nil)
|
|
90 ((eq data-type 'STRING)
|
|
91 'iso-8859-1)
|
|
92 (t
|
|
93 (error "Unknow selection data type: %S" type))))
|
|
94 data (if coding (decode-coding-string data coding)
|
|
95 (string-to-multibyte data)))
|
|
96 (setq next-selection-coding-system nil)
|
51600
|
97 (put-text-property 0 (length data) 'foreign-selection data-type data))
|
|
98 data))
|
2234
|
99
|
|
100 (defun x-get-clipboard ()
|
|
101 "Return text pasted to the clipboard."
|
|
102 (x-get-selection-internal 'CLIPBOARD 'STRING))
|
|
103
|
|
104 (defun x-set-selection (type data)
|
|
105 "Make an X Windows selection of type TYPE and value DATA.
|
56531
|
106 The argument TYPE (nil means `PRIMARY') says which selection, and
|
|
107 DATA specifies the contents. TYPE must be a symbol. \(It can also
|
|
108 be a string, which stands for the symbol with that name, but this
|
|
109 is considered obsolete.) DATA may be a string, a symbol, an
|
|
110 integer (or a cons of two integers or list of two integers).
|
11406
|
111
|
|
112 The selection may also be a cons of two markers pointing to the same buffer,
|
49514
10a6fd9d8e9c
(x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
113 or an overlay. In these cases, the selection is considered to be the text
|
11406
|
114 between the markers *at whatever time the selection is examined*.
|
|
115 Thus, editing done in the buffer after you specify the selection
|
|
116 can alter the effective value of the selection.
|
|
117
|
|
118 The data may also be a vector of valid non-vector selection values.
|
|
119
|
56531
|
120 The return value is DATA.
|
|
121
|
|
122 Interactively, this command sets the primary selection. Without
|
|
123 prefix argument, it reads the selection in the minibuffer. With
|
|
124 prefix argument, it uses the text of the region as the selection value ."
|
2234
|
125 (interactive (if (not current-prefix-arg)
|
11406
|
126 (list 'PRIMARY (read-string "Set text for pasting: "))
|
26423
|
127 (list 'PRIMARY (buffer-substring (region-beginning) (region-end)))))
|
2234
|
128 ;; This is for temporary compatibility with pre-release Emacs 19.
|
|
129 (if (stringp type)
|
|
130 (setq type (intern type)))
|
|
131 (or (x-valid-simple-selection-p data)
|
|
132 (and (vectorp data)
|
|
133 (let ((valid t)
|
|
134 (i (1- (length data))))
|
|
135 (while (>= i 0)
|
|
136 (or (x-valid-simple-selection-p (aref data i))
|
|
137 (setq valid nil))
|
|
138 (setq i (1- i)))
|
|
139 valid))
|
|
140 (signal 'error (list "invalid selection" data)))
|
|
141 (or type (setq type 'PRIMARY))
|
|
142 (if data
|
|
143 (x-own-selection-internal type data)
|
|
144 (x-disown-selection-internal type))
|
|
145 data)
|
|
146
|
|
147 (defun x-valid-simple-selection-p (data)
|
|
148 (or (stringp data)
|
|
149 (symbolp data)
|
|
150 (integerp data)
|
|
151 (and (consp data)
|
|
152 (integerp (car data))
|
|
153 (or (integerp (cdr data))
|
|
154 (and (consp (cdr data))
|
|
155 (integerp (car (cdr data))))))
|
6442
|
156 (overlayp data)
|
2234
|
157 (and (consp data)
|
|
158 (markerp (car data))
|
|
159 (markerp (cdr data))
|
|
160 (marker-buffer (car data))
|
|
161 (marker-buffer (cdr data))
|
|
162 (eq (marker-buffer (car data))
|
|
163 (marker-buffer (cdr data)))
|
|
164 (buffer-name (marker-buffer (car data)))
|
|
165 (buffer-name (marker-buffer (cdr data))))))
|
|
166
|
|
167 ;;; Cut Buffer support
|
|
168
|
|
169 (defun x-get-cut-buffer (&optional which-one)
|
41989
|
170 "Returns the value of one of the 8 X server cut-buffers.
|
|
171 Optional arg WHICH-ONE should be a number from 0 to 7, defaulting to 0.
|
2234
|
172 Cut buffers are considered obsolete; you should use selections instead."
|
|
173 (x-get-cut-buffer-internal
|
|
174 (if which-one
|
|
175 (aref [CUT_BUFFER0 CUT_BUFFER1 CUT_BUFFER2 CUT_BUFFER3
|
|
176 CUT_BUFFER4 CUT_BUFFER5 CUT_BUFFER6 CUT_BUFFER7]
|
|
177 which-one)
|
|
178 'CUT_BUFFER0)))
|
|
179
|
3035
|
180 (defun x-set-cut-buffer (string &optional push)
|
2234
|
181 "Store STRING into the X server's primary cut buffer.
|
3035
|
182 If PUSH is non-nil, also rotate the cut buffers:
|
49514
10a6fd9d8e9c
(x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
183 this means the previous value of the primary cut buffer moves to the second
|
2234
|
184 cut buffer, and the second to the third, and so on (there are 8 buffers.)
|
|
185 Cut buffers are considered obsolete; you should use selections instead."
|
49514
10a6fd9d8e9c
(x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
186 (or (stringp string) (signal 'wrong-type-argument (list 'string string)))
|
3035
|
187 (if push
|
|
188 (x-rotate-cut-buffers-internal 1))
|
2234
|
189 (x-store-cut-buffer-internal 'CUT_BUFFER0 string))
|
|
190
|
|
191
|
|
192 ;;; Functions to convert the selection into various other selection types.
|
|
193 ;;; Every selection type that Emacs handles is implemented this way, except
|
|
194 ;;; for TIMESTAMP, which is a special case.
|
|
195
|
|
196 (defun xselect-convert-to-string (selection type value)
|
46879
|
197 (let (str coding)
|
|
198 ;; Get the actual string from VALUE.
|
|
199 (cond ((stringp value)
|
|
200 (setq str value))
|
|
201
|
|
202 ((overlayp value)
|
|
203 (save-excursion
|
|
204 (or (buffer-name (overlay-buffer value))
|
|
205 (error "selection is in a killed buffer"))
|
|
206 (set-buffer (overlay-buffer value))
|
|
207 (setq str (buffer-substring (overlay-start value)
|
|
208 (overlay-end value)))))
|
|
209 ((and (consp value)
|
|
210 (markerp (car value))
|
|
211 (markerp (cdr value)))
|
|
212 (or (eq (marker-buffer (car value)) (marker-buffer (cdr value)))
|
|
213 (signal 'error
|
|
214 (list "markers must be in the same buffer"
|
|
215 (car value) (cdr value))))
|
|
216 (save-excursion
|
|
217 (set-buffer (or (marker-buffer (car value))
|
|
218 (error "selection is in a killed buffer")))
|
|
219 (setq str (buffer-substring (car value) (cdr value))))))
|
|
220
|
|
221 (when str
|
|
222 ;; If TYPE is nil, this is a local request, thus return STR as
|
|
223 ;; is. Otherwise, encode STR.
|
|
224 (if (not type)
|
|
225 str
|
|
226 (setq coding (or next-selection-coding-system selection-coding-system))
|
|
227 (if coding
|
91103
|
228 (setq coding (coding-system-base coding)))
|
55331
|
229 (let ((inhibit-read-only t))
|
55344
|
230 ;; Suppress producing escape sequences for compositions.
|
55331
|
231 (remove-text-properties 0 (length str) '(composition nil) str)
|
91103
|
232 (if (not (multibyte-string-p str))
|
|
233 ;; Don't have to encode unibyte string.
|
|
234 (setq type 'C_STRING)
|
|
235 (if (eq type 'TEXT)
|
|
236 ;; TEXT is a polimorphic target. We must select the
|
|
237 ;; actual type from `UTF8_STRING', `COMPOUND_TEXT',
|
|
238 ;; `STRING', and `C_STRING'.
|
|
239 (let (non-latin-1 non-unicode eight-bit)
|
|
240 (mapc #'(lambda (x)
|
|
241 (if (>= x #x100)
|
|
242 (if (< x #x110000)
|
|
243 (setq non-latin-1 t)
|
|
244 (if (< x #x3FFF80)
|
|
245 (setq non-unicode t)
|
|
246 (setq eight-bit t)))))
|
|
247 str)
|
|
248 (setq type (if non-unicode 'COMPOUND_TEXT
|
|
249 (if non-latin-1 'UTF8_STRING
|
|
250 (if eight-bit 'C_STRING 'STRING))))))
|
|
251 (cond
|
|
252 ((eq type 'UTF8_STRING)
|
|
253 (if (or (not coding)
|
|
254 (not (eq (coding-system-type coding) 'utf-8)))
|
|
255 (setq coding 'utf-8))
|
|
256 (setq str (encode-coding-string str coding)))
|
49514
10a6fd9d8e9c
(x-set-cut-buffer): Fix docstring. Check type with `stringp' instead of
Juanma Barranquero <lekktu@gmail.com>
diff
changeset
|
257
|
91103
|
258 ((eq type 'STRING)
|
|
259 (if (or (not coding)
|
|
260 (not (eq (coding-system-type coding) 'charset)))
|
|
261 (setq coding 'iso-8859-1))
|
|
262 (setq str (encode-coding-string str coding)))
|
46879
|
263
|
91103
|
264 ((eq type 'COMPOUND_TEXT)
|
|
265 (if (or (not coding)
|
|
266 (not (eq (coding-system-type coding) 'iso-2022)))
|
|
267 (setq coding 'compound-text-with-extensions))
|
|
268 (setq str (encode-coding-string str coding)))
|
|
269
|
|
270 ((eq type 'C_STRING)
|
|
271 (setq str (string-make-unibyte str)))
|
|
272
|
|
273 (t
|
|
274 (error "Unknow selection type: %S" type))
|
|
275 ))))
|
46879
|
276
|
|
277 (setq next-selection-coding-system nil)
|
|
278 (cons type str))))
|
|
279
|
2234
|
280
|
|
281 (defun xselect-convert-to-length (selection type value)
|
|
282 (let ((value
|
|
283 (cond ((stringp value)
|
|
284 (length value))
|
6442
|
285 ((overlayp value)
|
|
286 (abs (- (overlay-end value) (overlay-start value))))
|
2234
|
287 ((and (consp value)
|
|
288 (markerp (car value))
|
|
289 (markerp (cdr value)))
|
|
290 (or (eq (marker-buffer (car value))
|
|
291 (marker-buffer (cdr value)))
|
|
292 (signal 'error
|
|
293 (list "markers must be in the same buffer"
|
|
294 (car value) (cdr value))))
|
|
295 (abs (- (car value) (cdr value)))))))
|
|
296 (if value ; force it to be in 32-bit format.
|
|
297 (cons (ash value -16) (logand value 65535))
|
|
298 nil)))
|
|
299
|
|
300 (defun xselect-convert-to-targets (selection type value)
|
|
301 ;; return a vector of atoms, but remove duplicates first.
|
|
302 (let* ((all (cons 'TIMESTAMP (mapcar 'car selection-converter-alist)))
|
|
303 (rest all))
|
|
304 (while rest
|
|
305 (cond ((memq (car rest) (cdr rest))
|
|
306 (setcdr rest (delq (car rest) (cdr rest))))
|
|
307 ((eq (car (cdr rest)) '_EMACS_INTERNAL) ; shh, it's a secret
|
|
308 (setcdr rest (cdr (cdr rest))))
|
|
309 (t
|
|
310 (setq rest (cdr rest)))))
|
|
311 (apply 'vector all)))
|
|
312
|
|
313 (defun xselect-convert-to-delete (selection type value)
|
|
314 (x-disown-selection-internal selection)
|
|
315 ;; A return value of nil means that we do not know how to do this conversion,
|
|
316 ;; and replies with an "error". A return value of NULL means that we have
|
|
317 ;; done the conversion (and any side-effects) but have no value to return.
|
|
318 'NULL)
|
|
319
|
|
320 (defun xselect-convert-to-filename (selection type value)
|
6442
|
321 (cond ((overlayp value)
|
|
322 (buffer-file-name (or (overlay-buffer value)
|
|
323 (error "selection is in a killed buffer"))))
|
2234
|
324 ((and (consp value)
|
|
325 (markerp (car value))
|
|
326 (markerp (cdr value)))
|
|
327 (buffer-file-name (or (marker-buffer (car value))
|
|
328 (error "selection is in a killed buffer"))))
|
|
329 (t nil)))
|
|
330
|
|
331 (defun xselect-convert-to-charpos (selection type value)
|
|
332 (let (a b tmp)
|
6442
|
333 (cond ((cond ((overlayp value)
|
|
334 (setq a (overlay-start value)
|
|
335 b (overlay-end value)))
|
2234
|
336 ((and (consp value)
|
|
337 (markerp (car value))
|
|
338 (markerp (cdr value)))
|
|
339 (setq a (car value)
|
|
340 b (cdr value))))
|
|
341 (setq a (1- a) b (1- b)) ; zero-based
|
|
342 (if (< b a) (setq tmp a a b b tmp))
|
|
343 (cons 'SPAN
|
|
344 (vector (cons (ash a -16) (logand a 65535))
|
|
345 (cons (ash b -16) (logand b 65535))))))))
|
|
346
|
|
347 (defun xselect-convert-to-lineno (selection type value)
|
|
348 (let (a b buf tmp)
|
|
349 (cond ((cond ((and (consp value)
|
|
350 (markerp (car value))
|
|
351 (markerp (cdr value)))
|
|
352 (setq a (marker-position (car value))
|
|
353 b (marker-position (cdr value))
|
|
354 buf (marker-buffer (car value))))
|
6442
|
355 ((overlayp value)
|
|
356 (setq buf (overlay-buffer value)
|
|
357 a (overlay-start value)
|
|
358 b (overlay-end value)))
|
2234
|
359 )
|
|
360 (save-excursion
|
|
361 (set-buffer buf)
|
|
362 (setq a (count-lines 1 a)
|
|
363 b (count-lines 1 b)))
|
|
364 (if (< b a) (setq tmp a a b b tmp))
|
|
365 (cons 'SPAN
|
|
366 (vector (cons (ash a -16) (logand a 65535))
|
|
367 (cons (ash b -16) (logand b 65535))))))))
|
|
368
|
|
369 (defun xselect-convert-to-colno (selection type value)
|
|
370 (let (a b buf tmp)
|
|
371 (cond ((cond ((and (consp value)
|
|
372 (markerp (car value))
|
|
373 (markerp (cdr value)))
|
|
374 (setq a (car value)
|
|
375 b (cdr value)
|
|
376 buf (marker-buffer a)))
|
6442
|
377 ((overlayp value)
|
|
378 (setq buf (overlay-buffer value)
|
|
379 a (overlay-start value)
|
|
380 b (overlay-end value)))
|
2234
|
381 )
|
|
382 (save-excursion
|
|
383 (set-buffer buf)
|
|
384 (goto-char a)
|
|
385 (setq a (current-column))
|
|
386 (goto-char b)
|
|
387 (setq b (current-column)))
|
|
388 (if (< b a) (setq tmp a a b b tmp))
|
|
389 (cons 'SPAN
|
|
390 (vector (cons (ash a -16) (logand a 65535))
|
|
391 (cons (ash b -16) (logand b 65535))))))))
|
|
392
|
|
393 (defun xselect-convert-to-os (selection type size)
|
|
394 (symbol-name system-type))
|
|
395
|
|
396 (defun xselect-convert-to-host (selection type size)
|
|
397 (system-name))
|
|
398
|
|
399 (defun xselect-convert-to-user (selection type size)
|
|
400 (user-full-name))
|
|
401
|
|
402 (defun xselect-convert-to-class (selection type size)
|
42028
|
403 "Convert selection to class.
|
|
404 This function returns the string \"Emacs\"."
|
2879
|
405 "Emacs")
|
2234
|
406
|
|
407 ;; We do not try to determine the name Emacs was invoked with,
|
|
408 ;; because it is not clean for a program's behavior to depend on that.
|
|
409 (defun xselect-convert-to-name (selection type size)
|
42028
|
410 "Convert selection to name.
|
|
411 This function returns the string \"emacs\"."
|
2234
|
412 "emacs")
|
|
413
|
|
414 (defun xselect-convert-to-integer (selection type value)
|
|
415 (and (integerp value)
|
|
416 (cons (ash value -16) (logand value 65535))))
|
|
417
|
|
418 (defun xselect-convert-to-atom (selection type value)
|
|
419 (and (symbolp value) value))
|
|
420
|
|
421 (defun xselect-convert-to-identity (selection type value) ; used internally
|
|
422 (vector value))
|
|
423
|
|
424 (setq selection-converter-alist
|
|
425 '((TEXT . xselect-convert-to-string)
|
17012
|
426 (COMPOUND_TEXT . xselect-convert-to-string)
|
2234
|
427 (STRING . xselect-convert-to-string)
|
46879
|
428 (UTF8_STRING . xselect-convert-to-string)
|
2234
|
429 (TARGETS . xselect-convert-to-targets)
|
|
430 (LENGTH . xselect-convert-to-length)
|
|
431 (DELETE . xselect-convert-to-delete)
|
|
432 (FILE_NAME . xselect-convert-to-filename)
|
|
433 (CHARACTER_POSITION . xselect-convert-to-charpos)
|
|
434 (LINE_NUMBER . xselect-convert-to-lineno)
|
|
435 (COLUMN_NUMBER . xselect-convert-to-colno)
|
|
436 (OWNER_OS . xselect-convert-to-os)
|
|
437 (HOST_NAME . xselect-convert-to-host)
|
|
438 (USER . xselect-convert-to-user)
|
|
439 (CLASS . xselect-convert-to-class)
|
|
440 (NAME . xselect-convert-to-name)
|
|
441 (ATOM . xselect-convert-to-atom)
|
|
442 (INTEGER . xselect-convert-to-integer)
|
|
443 (_EMACS_INTERNAL . xselect-convert-to-identity)
|
|
444 ))
|
|
445
|
|
446 (provide 'select)
|
|
447
|
52401
|
448 ;;; arch-tag: bb634f97-8a3b-4b0a-b940-f6e09982328c
|
38414
|
449 ;;; select.el ends here
|