Skip to content

C
cpython
Kaydet (Commit) 0b3f9512 authored tarafından Guido van Rossum's avatar Guido van Rossum
Dosyalara gözat
Seçenekler

Added capwords, splitx, and optional 3rd argument to split/splitx.

üst 7a7d5d8f
Hide whitespace changes
Inline Side-by-side
Showing with 42 additions and 10 deletions
Doc/lib/libregsub.tex
Dosyayı görüntüle @ 0b3f9512
...@@ -7,6 +7,7 @@ regular expressions (see built-in module \code{regex}). ...@@ -7,6 +7,7 @@ regular expressions (see built-in module \code{regex}).
Warning: these functions are not thread-safe. Warning: these functions are not thread-safe.
\renewcommand{\indexsubitem}{(in module regsub)} \renewcommand{\indexsubitem}{(in module regsub)}
\begin{funcdesc}{sub}{pat\, repl\, str} \begin{funcdesc}{sub}{pat\, repl\, str}
Replace the first occurrence of pattern \var{pat} in string Replace the first occurrence of pattern \var{pat} in string
\var{str} by replacement \var{repl}. If the pattern isn't found, \var{str} by replacement \var{repl}. If the pattern isn't found,
...@@ -23,13 +24,28 @@ when not adjacent to a previous match, so e.g. ...@@ -23,13 +24,28 @@ when not adjacent to a previous match, so e.g.
\code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}. \code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{split}{str\, pat\optional{\, retain}} \begin{funcdesc}{split}{str\, pat\optional{\, maxsplit}}
Split the string \var{str} in fields separated by delimiters matching Split the string \var{str} in fields separated by delimiters matching
the pattern \var{pat}, and return a list containing the fields. Only the pattern \var{pat}, and return a list containing the fields. Only
non-empty matches for the pattern are considered, so e.g. non-empty matches for the pattern are considered, so e.g.
\code{split('a:b', ':*')} returns \code{['a', 'b']} and \code{split('a:b', ':*')} returns \code{['a', 'b']} and
\code{split('abc', '')} returns \code{['abc']}. \code{split('abc', '')} returns \code{['abc']}. The \var{maxsplit}
If the optional \var{retain} argument is true, the separators are also defaults to 0. If it is nonzero, only \var{maxsplit} number of splits
inserted in the list, so e.g. \code{split('a:::b', ':*', 1)} returns occur, and the remainder of the string is returned as the final
\code{['a', ':::', 'b']}. element of the list.
\end{funcdesc}
\begin{funcdesc}{splitx}{str\, pat\optional{\, maxsplit}}
Split the string \var{str} in fields separated by delimiters matching
the pattern \var{pat}, and return a list containing the fields as well
as the separators. For example, \code{splitx('a:::b', ':*')} returns
\code{['a', ':::', 'b']}. Otherwise, this function behaves the same
as \code{split}.
\end{funcdesc}
\begin{funcdesc}{capwords}{s\optional{\, pat}}
Capitalize words separated by optional pattern \var{pat}. The default
pattern uses any characters except letters, digits and underscores as
word delimiters. Capitalization is done by changing the first
character of each word to upper case.
\end{funcdesc} \end{funcdesc}
Doc/libregsub.tex
Dosyayı görüntüle @ 0b3f9512
...@@ -7,6 +7,7 @@ regular expressions (see built-in module \code{regex}). ...@@ -7,6 +7,7 @@ regular expressions (see built-in module \code{regex}).
Warning: these functions are not thread-safe. Warning: these functions are not thread-safe.
\renewcommand{\indexsubitem}{(in module regsub)} \renewcommand{\indexsubitem}{(in module regsub)}
\begin{funcdesc}{sub}{pat\, repl\, str} \begin{funcdesc}{sub}{pat\, repl\, str}
Replace the first occurrence of pattern \var{pat} in string Replace the first occurrence of pattern \var{pat} in string
\var{str} by replacement \var{repl}. If the pattern isn't found, \var{str} by replacement \var{repl}. If the pattern isn't found,
...@@ -23,13 +24,28 @@ when not adjacent to a previous match, so e.g. ...@@ -23,13 +24,28 @@ when not adjacent to a previous match, so e.g.
\code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}. \code{gsub('', '-', 'abc')} returns \code{'-a-b-c-'}.
\end{funcdesc} \end{funcdesc}
\begin{funcdesc}{split}{str\, pat\optional{\, retain}} \begin{funcdesc}{split}{str\, pat\optional{\, maxsplit}}
Split the string \var{str} in fields separated by delimiters matching Split the string \var{str} in fields separated by delimiters matching
the pattern \var{pat}, and return a list containing the fields. Only the pattern \var{pat}, and return a list containing the fields. Only
non-empty matches for the pattern are considered, so e.g. non-empty matches for the pattern are considered, so e.g.
\code{split('a:b', ':*')} returns \code{['a', 'b']} and \code{split('a:b', ':*')} returns \code{['a', 'b']} and
\code{split('abc', '')} returns \code{['abc']}. \code{split('abc', '')} returns \code{['abc']}. The \var{maxsplit}
If the optional \var{retain} argument is true, the separators are also defaults to 0. If it is nonzero, only \var{maxsplit} number of splits
inserted in the list, so e.g. \code{split('a:::b', ':*', 1)} returns occur, and the remainder of the string is returned as the final
\code{['a', ':::', 'b']}. element of the list.
\end{funcdesc}
\begin{funcdesc}{splitx}{str\, pat\optional{\, maxsplit}}
Split the string \var{str} in fields separated by delimiters matching
the pattern \var{pat}, and return a list containing the fields as well
as the separators. For example, \code{splitx('a:::b', ':*')} returns
\code{['a', ':::', 'b']}. Otherwise, this function behaves the same
as \code{split}.
\end{funcdesc}
\begin{funcdesc}{capwords}{s\optional{\, pat}}
Capitalize words separated by optional pattern \var{pat}. The default
pattern uses any characters except letters, digits and underscores as
word delimiters. Capitalization is done by changing the first
character of each word to upper case.
\end{funcdesc} \end{funcdesc}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment