comparison lispref/text.texi @ 39528:ed97ba5c9ba8

(Property Search): Correct descriptions of `next-char-property-change' and `previous-char-property-change'. Add entries for `next-single-char-property-change' and `previous-single-char-property-change'. Make operand names a bit more consistent.
author Miles Bader <miles@gnu.org>
date Tue, 02 Oct 2001 02:11:10 +0000
parents ad4839873265
children 6d1ba806f659
comparison
equal deleted inserted replaced
39527:30754f5e9665 39528:ed97ba5c9ba8
1 @c -*-texinfo-*- 1 @c -*-texinfo-*-
2 @c This is part of the GNU Emacs Lisp Reference Manual. 2 @c This is part of the GNU Emacs Lisp Reference Manual.
3 @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000 3 @c Copyright (C) 1990, 1991, 1992, 1993, 1994, 1995, 1998, 1999, 2000, 2001
4 @c Free Software Foundation, Inc. 4 @c Free Software Foundation, Inc.
5 @c See the file elisp.texi for copying conditions. 5 @c See the file elisp.texi for copying conditions.
6 @setfilename ../info/text 6 @setfilename ../info/text
7 @node Text, Non-ASCII Characters, Markers, Top 7 @node Text, Non-ASCII Characters, Markers, Top
8 @chapter Text 8 @chapter Text
2548 @var{pos} instead of forward. If the value is non-@code{nil}, it is a 2548 @var{pos} instead of forward. If the value is non-@code{nil}, it is a
2549 position less than or equal to @var{pos}; it equals @var{pos} only if 2549 position less than or equal to @var{pos}; it equals @var{pos} only if
2550 @var{limit} equals @var{pos}. 2550 @var{limit} equals @var{pos}.
2551 @end defun 2551 @end defun
2552 2552
2553 @defun next-char-property-change position &optional limit 2553 @defun next-char-property-change pos &optional limit
2554 This is like @code{next-property-change} except that it considers 2554 This is like @code{next-property-change} except that it considers
2555 overlay properties as well as text properties. There is no @var{object} 2555 overlay properties as well as text properties, and if no change is
2556 operand because this function operates only on the current buffer. It 2556 found before the end of the buffer, it returns the maximum buffer
2557 returns the next address at which either kind of property changes. 2557 position rather than @code{nil} (in this sense, it resembles the
2558 @end defun 2558 corresponding overlay function @code{next-overlay-change}, rather than
2559 2559 @code{next-property-change}). There is no @var{object} operand
2560 @defun previous-char-property-change position &optional limit 2560 because this function operates only on the current buffer. It returns
2561 the next address at which either kind of property changes.
2562 @end defun
2563
2564 @defun previous-char-property-change pos &optional limit
2561 This is like @code{next-char-property-change}, but scans back from 2565 This is like @code{next-char-property-change}, but scans back from
2562 @var{position} instead of forward. 2566 @var{pos} instead of forward, and returns the minimum buffer
2567 position if no change is found.
2568 @end defun
2569
2570 @defun next-single-char-property-change pos prop &optional object limit
2571 This is like @code{next-single-property-change} except that it
2572 considers overlay properties as well as text properties, and if no
2573 change is found before the end of the @var{object}, it returns the
2574 maximum valid position in @var{object} rather than @code{nil}. Unlike
2575 @code{next-char-property-change}, this function @emph{does} have an
2576 @var{object} operand; if @var{object} is not a buffer, only
2577 text-properties are considered.
2578 @end defun
2579
2580 @defun previous-single-char-property-change pos prop &optional object limit
2581 This is like @code{next-single-char-property-change}, but scans back
2582 from @var{pos} instead of forward, and returns the minimum valid
2583 position in @var{object} if no change is found.
2563 @end defun 2584 @end defun
2564 2585
2565 @defun text-property-any start end prop value &optional object 2586 @defun text-property-any start end prop value &optional object
2566 This function returns non-@code{nil} if at least one character between 2587 This function returns non-@code{nil} if at least one character between
2567 @var{start} and @var{end} has a property @var{prop} whose value is 2588 @var{start} and @var{end} has a property @var{prop} whose value is