From: Guido van Rossum <guido@python.org>
Date: Wed, 26 Jun 1996 19:24:22 +0000 (+0000)
Subject: Added thread unsafety warning.  Added optional retain arg to split.
X-Git-Tag: v1.4b1~29
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6076ea51e2a04eaba105440cb12f25e0cb770f24;p=python

Added thread unsafety warning.  Added optional retain arg to split.
---

diff --git a/Doc/lib/libregsub.tex b/Doc/lib/libregsub.tex
index 5747e4f99b..bbb7671678 100644
--- a/Doc/lib/libregsub.tex
+++ b/Doc/lib/libregsub.tex
@@ -4,6 +4,8 @@
 This module defines a number of functions useful for working with
 regular expressions (see built-in module \code{regex}).
 
+Warning: these functions are not thread-safe.
+
 \renewcommand{\indexsubitem}{(in module regsub)}
 \begin{funcdesc}{sub}{pat\, repl\, str}
 Replace the first occurrence of pattern \var{pat} in string
@@ -21,10 +23,13 @@ when not adjacent to a previous match, so e.g.
 \code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}.
 \end{funcdesc}
 
-\begin{funcdesc}{split}{str\, pat}
+\begin{funcdesc}{split}{str\, pat\optional{\, retain}}
 Split the string \var{str} in fields separated by delimiters matching
 the pattern \var{pat}, and return a list containing the fields.  Only
 non-empty matches for the pattern are considered, so e.g.
 \code{split('a:b', ':*')} returns \code{['a', 'b']} and
 \code{split('abc', '')} returns \code{['abc']}.
+If the optional \var{retain} argument is true, the separators are also
+inserted in the list, so e.g. \code{split('a:::b', ':*', 1)} returns
+\code{['a', ':::', 'b']}.
 \end{funcdesc}
diff --git a/Doc/libregsub.tex b/Doc/libregsub.tex
index 5747e4f99b..bbb7671678 100644
--- a/Doc/libregsub.tex
+++ b/Doc/libregsub.tex
@@ -4,6 +4,8 @@
 This module defines a number of functions useful for working with
 regular expressions (see built-in module \code{regex}).
 
+Warning: these functions are not thread-safe.
+
 \renewcommand{\indexsubitem}{(in module regsub)}
 \begin{funcdesc}{sub}{pat\, repl\, str}
 Replace the first occurrence of pattern \var{pat} in string
@@ -21,10 +23,13 @@ when not adjacent to a previous match, so e.g.
 \code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}.
 \end{funcdesc}
 
-\begin{funcdesc}{split}{str\, pat}
+\begin{funcdesc}{split}{str\, pat\optional{\, retain}}
 Split the string \var{str} in fields separated by delimiters matching
 the pattern \var{pat}, and return a list containing the fields.  Only
 non-empty matches for the pattern are considered, so e.g.
 \code{split('a:b', ':*')} returns \code{['a', 'b']} and
 \code{split('abc', '')} returns \code{['abc']}.
+If the optional \var{retain} argument is true, the separators are also
+inserted in the list, so e.g. \code{split('a:::b', ':*', 1)} returns
+\code{['a', ':::', 'b']}.
 \end{funcdesc}