summaryrefslogtreecommitdiffstats
path: root/Doc/api
diff options
context:
space:
mode:
authorWalter Dörwald <walter@livinglogic.de>2007-05-25 14:14:31 (GMT)
committerWalter Dörwald <walter@livinglogic.de>2007-05-25 14:14:31 (GMT)
commite65c86cca02a6cc5698ecf846d6340319e5fd803 (patch)
treef1abcd8e5b0981a36895c0c620fb2bec03da35b4 /Doc/api
parent1680713e524016d93a94114c4a874ad71a090b95 (diff)
downloadcpython-e65c86cca02a6cc5698ecf846d6340319e5fd803.zip
cpython-e65c86cca02a6cc5698ecf846d6340319e5fd803.tar.gz
cpython-e65c86cca02a6cc5698ecf846d6340319e5fd803.tar.bz2
Document the existence of PyUnicode_InternInPlace() and
PyUnicode_InternFromString().
Diffstat (limited to 'Doc/api')
-rw-r--r--Doc/api/concrete.tex21
1 files changed, 21 insertions, 0 deletions
diff --git a/Doc/api/concrete.tex b/Doc/api/concrete.tex
index 9e0c5bb..e0664b5 100644
--- a/Doc/api/concrete.tex
+++ b/Doc/api/concrete.tex
@@ -1611,6 +1611,27 @@ They all return \NULL{} or \code{-1} if an exception occurs.
string. \code{-1} is returned if there was an error.
\end{cfuncdesc}
+\begin{cfuncdesc}{void}{PyUnicode_InternInPlace}{PyObject **string}
+ Intern the argument \var{*string} in place. The argument must be
+ the address of a pointer variable pointing to a Python unicode string
+ object. If there is an existing interned string that is the same as
+ \var{*string}, it sets \var{*string} to it (decrementing the
+ reference count of the old string object and incrementing the
+ reference count of the interned string object), otherwise it leaves
+ \var{*string} alone and interns it (incrementing its reference
+ count). (Clarification: even though there is a lot of talk about
+ reference counts, think of this function as reference-count-neutral;
+ you own the object after the call if and only if you owned it before
+ the call.)
+\end{cfuncdesc}
+
+\begin{cfuncdesc}{PyObject*}{PyUnicode_InternFromString}{const char *v}
+ A combination of \cfunction{PyUnicode_FromString()} and
+ \cfunction{PyUnicode_InternInPlace()}, returning either a new unicode
+ string object that has been interned, or a new (``owned'') reference to
+ an earlier interned string object with the same value.
+\end{cfuncdesc}
+
\subsection{Buffer Objects \label{bufferObjects}}
\sectionauthor{Greg Stein}{gstein@lyra.org}