elisp

(add-to-list 'listname 'value)

Добавили в список. Добавляет один элемент.

(setq variable-name new-value)

Установили значения переменной

Source blocks in a literate program can serve a variety of purposes—implementation, examples, testing, and so on—so we define a load Org code block header argument to decide whether to read them or not, which accepts the following values -

yes The code block should be loaded normally. This is the default when the header argument load is not provided.

(defun a-function-to-load ()
 (message "this function will be loaded by literate-elisp.~%"))

no The code block should be ignored by the Emacs Lisp reader.

(defun a-function-to-ignore ()
 (message "this function will be ingored by literate-elisp.~%"))

test The code block should be loaded only when the variable literate-elisp-test-p is true.

(defun a-function-to-test ()
 (message "this function will be loaded by literate-elisp only if literate-elisp-test-p is true.~%"))

the name of a variable or function The code block is loaded if the value of the variable or the return value of the function is non-nil.

Список - это атомы и списки в скобках. Атомы - символы (слова и некоторые символы), числа, строки (нечто в двойных кавычках). Несколько пробелов и/или переносов строки - эквивалентны одному пробелу.

Когда перед списком стоит апостроф, это сигнал для Лиспа ничего не делать со списком, а взять его как есть. Но если перед списком нет апостофа, то первый символ в списке имеет особое значение — это команда, которую компьютер должен выполнить.

'(+ 2 3)

(+ 2 3)

(это список перед которым не стоит апостроф)

В минибуффере выдаёт: "progn: Symbol’s function definition is void: это"

если функция, которую анализирует интерпретатор Лиспа, не является особой формой, и если она часть списка, то интерпретатор Лиспа смотрит, есть ли внутри этого списка вложенные списки. Если есть, тогда интерпретатор вначале вычисляет внутренние списки, а затем внешние. Он всегда в первую очередь обрабатывает внутренние списки. Это делается для того, чтобы выяснить, какой они возвращают результат. Этот результат может использоваться в списке верхнего уровня.

(+ 2 (+ 3 3))

Если внутренних списков нет, то интерпретатор вычисляет выражения слева направо, от одного выражения к другому.

вычисление символического выражения обычно заставляет интерпретатор Лиспа возвратить какое-нибудь значение и, возможно, выполнить побочное действие; или прервать выполнение, отобразив соответствующее сообщение об ошибке.

• http://xahlee.info/emacs/emacs/elisp_list.html - операции со списками.
• https://www.emacswiki.org/emacs/ListModification

В Лиспе к любому символу можно прикрепить какое-нибудь значение, точно также как к нему можно прикрепить функцию. С символом одновременно может быть связано и определение функции и какое-нибудь значение. с символом могут быть связаны также список свойств и строка документации.

Если вы попытаетесь вычислить символ, с которым не связано никакое значение, то вы получите сообщение об ошибке.

Типы данных, которые будут передаваться в функцию, зависят от того, какого рода информацию она использует. Аргументы функции, такой как +, должны иметь численные значения, поскольку + складывает числа. Другие функции используют аргументы другого типа.

Например, функция concat связывает вместе, или объединяет две или более строк, чтобы получить одну строку. Ее аргументы строки. Конкатенация двух символьных строк abc, def выдаст в результате строку abcdef. Это можно проверить вычислив следующее:

(concat "abc" "def")

Аргументами функции substring являются и строки, и числа. Эта функция возвращает часть строки, подстроку своего первого аргумента. Функция требует три аргумента. Первый аргумент — строка символов, второй и третий аргументы — это числа, которые отмечают начало и конец строки. Числа — это количество символов (включая пробелы и знаки пунктуации) от начала строки.

(substring "Четыре черненьких чумазеньких чертенка." 7 29)

Вы можете считать функцию substring "разделителем атома" поскольку она извлекает часть из по-другому неделимого атома. Однако substring способна выделить подстроку только из строки, а с другого рода атомами, такими как символы или числа, она не работает.

Аргументом может быть и символ, который возвращает значение, когда его вычислят. Например, когда мы вычисляем символ fill-column, то он возвращает число. Это число может использоваться в сложении.

(+ 2 fill-column)

(ага, у меня безумное fill-column.)

 (defun имя-функции (аргументы...)
"необязательная-документация..."
(interactive как-получить-аргументы)     ; необязательно
тело...)

Как первый пример мы рассмотрим определение функции, которая умножает свой аргумент на 7. (Это пример не интерактивной функции. See section Making a Function Interactive, для получения дополнительной информации).

(defun умножить-на-семь (number)
  "Умножить NUMBER на семь."
  (* 7 number))

(умножить-на-семь 3)

(defun умножить-на-семь (number)       ; Интерактивная версия.
  "Умножить NUMBER на семь."
  (interactive "p") ; передаёт в функцию префикс
  (message "Итог %d" (* 7 number)))

В Emacs более 20 символов, предопределенных для использования с interactive. Почти во всех случаях, та или другая из этих опций позволит вам передать интерактивно в функцию всю необходимую информацию. (See section `Code Characters for interactive' in The GNU Emacs Lisp Reference Manual.)

Например, символ `r' заставляет Emacs передать начало и конец области (текущие значения точки и метки) в функцию как два различных аргумента. Его используют следующим образом:

(interactive "r")

Другой символ `B' — указание для Emacs запросить от вас имя буфера, которое будет передано в функцию. В этом случае Emacs отобразит в мини-буфере подсказку, используя строку, которая следует за `B', например, "BДобавить к буферу: ". Emacs не только отобразит подсказку в мини-буфере, но также позволит воспользоваться функцией автодополнения, что здорово помогает (просто наберите первые несколько символов и нажмите TAB).

Функция, которая требует два и более аргумента, может получить информацию для каждого из них, добавляя к строке за interactive различные части. Когда вы сделаете это, информация передается в каждый аргумент в том же самом порядке как они описаны в списке аргументов interactive. В строке каждая часть отделяется друг от друга `\n' — символом новой строки. Например, если за interactive будет следовать строка "BДобавить к буферу: \nr", то это заставит интерпретатор Лиспа передать в функцию значения точки и метки, а также запросить у вас имя буфера (в целом три аргумента).

(let список_переменных тело…)

Переменные «понятны» только в рамках тела.

Если список переменных состоит из двухэлементных списков, как это часто и случается, то шаблон для выражения let будет таким:

(let ((переменная значение) (переменная значение) …) тело…)

(if (> 5 4) ; if-part (message "5 больше чем 4!")) ; then-part

(if (> 4 5) ; if-часть (message "5 больше чем 4!") ; then-часть (message "4 не больше чем 5!")) ; else-часть

(defun тип-животного (характеристика)
"Напечатать сообщение в эхо-области. В зависимости от ХАРАКТЕРИСТИКИ.
   Если ХАРАКТЕРИСТИКА `свирепость', тогда напечатать предупреждение."
(if (equal характеристика 'свирепость)
    (message "Это тигр!")))

(тип-животного 'пушистость)
(тип-животного 'свирепость)

(cond (test-expression1 then-expression1)
      (test-expression2 then-expression2)
      (t else-expression))

Сохранить место, где был курсор, и буфер. Вернуться туда по завершении действий.

(save-excursion
  тело...)

В программах на Emacs Лиспе выражение save-excursion часто помещают в тело выражения let. Это выглядит следующим образом:

(let список-переменных
  (save-excursion
    тело...))

Macro: save-mark-and-excursion body…

This macro is like save-excursion, but also saves and restores the mark location and mark-active. This macro does what save-excursion did before Emacs 25.1.
(https://www.gnu.org/software/emacs/manual/html_node/elisp/Excursions.html)