850 |
|
|
851 |
If @var{repeat} is supplied, it must be a positive number; the search |
If @var{repeat} is supplied, it must be a positive number; the search |
852 |
is repeated that many times; each repetition starts at the end of the |
is repeated that many times; each repetition starts at the end of the |
853 |
previous match. If all these successive searches succeed, the |
previous match. If all these successive searches succeed, the search |
854 |
function succeeds, moving point and returning its new value. |
succeeds, moving point and returning its new value. Otherwise the |
855 |
Otherwise the function fails. |
search fails. What @code{re-search-forward} does when the search |
856 |
|
fails depends on the value of @var{noerror}: |
857 |
|
|
858 |
What happens when the function fails depends on the value of |
@table @asis |
859 |
@var{noerror}. If @var{noerror} is @code{nil}, a @code{search-failed} |
@item @code{nil} |
860 |
error is signaled. If @var{noerror} is @code{t}, |
Signal a @code{search-failed} error. |
861 |
@code{re-search-forward} does nothing and returns @code{nil}. If |
@item @code{t} |
862 |
@var{noerror} is neither @code{nil} nor @code{t}, then |
Do nothing and return @code{nil}. |
863 |
@code{re-search-forward} moves point to @var{limit} (or the end of the |
@item anything else |
864 |
accessible portion of the buffer) and returns @code{nil}. |
Move point to @var{limit} (or the end of the accessible portion of the |
865 |
|
buffer) and return @code{nil}. |
866 |
|
@end table |
867 |
|
|
868 |
In the following example, point is initially before the @samp{T}. |
In the following example, point is initially before the @samp{T}. |
869 |
Evaluating the search call moves point to the end of that line (between |
Evaluating the search call moves point to the end of that line (between |