Spec-Zone.ru › Elisp

Рассмотрение текста около точки

Предлагается множество функций для просмотра символов вокруг точки. Здесь описаны несколько простых функций. См. также looking-at в Поиске по регулярным выражениям.

В следующих четырёх функциях «начало» или «конец» буфера относятся к началу или концу доступной части.

Функция: char-after &optional position

Эта функция возвращает символ в текущем буфере в (т.е., непосредственно после) позиции position. Если position выходит за пределы диапазона для этой цели, то есть до начала буфера или на конце или за концом, то значение равно nil. По умолчанию для position используется точка.

В следующем примере предположим, что первый символ в буфере — ‘@’:

(string (char-after 1))
     ⇒ "@"
Функция: char-before &optional position

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

Функция: following-char

Эта функция возвращает символ, следующий за точкой в текущем буфере. Это аналогично (char-after (point)). Однако, если точка находится в конце буфера, то following-char возвращает 0.

Помните, что точка всегда находится между символами, и курсор обычно отображается над символом, следующим за точкой. Поэтому символ, возвращаемый following-char, — это символ, над которым находится курсор.

В этом примере точка находится между ‘a’ и ‘c’.

---------- Buffer: foo ----------
Gentlemen may cry ``Pea∗ce! Peace!,''
but there is no peace.
---------- Buffer: foo ----------
(string (preceding-char))
     ⇒ "a"
(string (following-char))
     ⇒ "c"
Функция: preceding-char

Эта функция возвращает символ, предшествующий точке в текущем буфере. См. выше, в разделе following-char, для примера. Если точка находится в начале буфера, preceding-char возвращает 0.

Функция: bobp

Эта функция возвращает t если точка находится в начале буфера. Если сужение активное, это означает начало доступной части текста. См. также point-min в Точка.

Функция: eobp

Эта функция возвращает t если точка находится в конце буфера. Если сужение активное, это означает конец доступной части текста. См. также point-max в Точке.

Функция: bolp

Эта функция возвращает t если точка находится в начале строки. См. Строки текста. Начало буфера (или его доступной части) всегда считается началом строки.

Функция: eolp

Эта функция возвращает t если точка находится в конце строки. Конец буфера (или его доступной части) всегда считается концом строки.

Copyright © 1990-1996, 1998-2022 Free Software Foundation, Inc.
Licensed under the GNU GPL license.
https://www.gnu.org/software/emacs/manual/html_node/elisp/Near-Point.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API