mirrors/emacs
1
Fork 0
mirror of git://git.sv.gnu.org/emacs.git synced 2026-01-30 04:10:54 -08:00
Code Issues Projects Releases Wiki Activity

(Creating Strings): Clarify split-string.

Browse source
This commit is contained in:
Richard M. Stallman 2003-05-28 11:35:48 +00:00
parent 8b4703c468
commit a730d07b4f
1 changed files with 12 additions and 6 deletions
Download patch file Download diff file Expand all files Collapse all files

18
lispref/strings.texi
View file

@ -260,12 +260,18 @@ Lists}.
@end defun
@defun split-string string separators omit-nulls
This function splits @var{string} into substrings at matches for the regular
expression @var{separators}. Each match for @var{separators} defines a
splitting point; the substrings between the splitting points are made
into a list, which is the value returned by @code{split-string}. If
@var{omit-nulls} is @code{t}, null strings will be removed from the
result list. Otherwise, null strings are left in the result.
This function splits @var{string} into substrings at matches for the
regular expression @var{separators}. Each match for @var{separators}
defines a splitting point; the substrings between the splitting points
are made into a list, which is the value returned by
@code{split-string}.
If @var{omit-nulls} is @code{nil}, the result contains null strings
whenever there are two consecutive matches for @var{separators}, or a
match is adjacent to the beginning or end of @var{string}. If
@var{omit-nulls} is @code{t}, these null strings are omitted from the
result list.
If @var{separators} is @code{nil} (or omitted),
the default is the value of @code{split-string-default-separators}.