[Python-checkins] CVS: python/dist/src/Doc/api api.tex,1.101,1.102

[M.-A. Lemburg]

Update of /cvsroot/python/python/dist/src/Doc/api
In directory usw-pr-cvs1:/tmp/cvs-serv21826/Doc/api

Modified Files:
	api.tex 
Log Message:
This patch adds a new builtin unistr() which behaves like str()
except that it always returns Unicode objects.

A new C API PyObject_Unicode() is also provided.

This closes patch #101664. 

Written by Marc-Andre Lemburg. Copyright assigned to Guido van Rossum.



Index: api.tex
===================================================================
RCS file: /cvsroot/python/python/dist/src/Doc/api/api.tex,v
retrieving revision 1.101
retrieving revision 1.102
diff -C2 -r1.101 -r1.102
*** api.tex	2001/01/04 05:56:34	1.101
--- api.tex	2001/01/17 17:09:52	1.102
***************
*** 5,9 ****
  \input{boilerplate}
  
! \makeindex			% tell \index to actually write the .idx file
  
  
--- 5,9 ----
  \input{boilerplate}
  
! \makeindex                      % tell \index to actually write the .idx file
  
  
***************
*** 1477,1480 ****
--- 1477,1488 ----
  
  
+ \begin{cfuncdesc}{PyObject*}{PyObject_Unicode}{PyObject *o}
+ Compute a Unicode string representation of object \var{o}.  Returns the
+ Unicode string representation on success, \NULL{} on failure.  This is
+ the equivalent of the Python expression \samp{unistr(\var{o})}.
+ Called by the \function{unistr()}\bifuncindex{unistr} built-in function.
+ \end{cfuncdesc}
+ 
+ 
  \begin{cfuncdesc}{int}{PyCallable_Check}{PyObject *o}
  Determine if the object \var{o} is callable.  Return \code{1} if the
***************
*** 3781,3785 ****
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtr}{void* cobj, 
! 	void (*destr)(void *)}
  Creates a \ctype{PyCObject} from the \code{void *}\var{cobj}.  The
  \var{destr} function will be called when the object is reclaimed, unless
--- 3789,3793 ----
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtr}{void* cobj, 
!         void (*destr)(void *)}
  Creates a \ctype{PyCObject} from the \code{void *}\var{cobj}.  The
  \var{destr} function will be called when the object is reclaimed, unless
***************
*** 3788,3792 ****
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtrAndDesc}{void* cobj,
! 	void* desc, void (*destr)(void *, void *) }
  Creates a \ctype{PyCObject} from the \ctype{void *}\var{cobj}.  The
  \var{destr} function will be called when the object is reclaimed.  The
--- 3796,3800 ----
  
  \begin{cfuncdesc}{PyObject*}{PyCObject_FromVoidPtrAndDesc}{void* cobj,
!         void* desc, void (*destr)(void *, void *) }
  Creates a \ctype{PyCObject} from the \ctype{void *}\var{cobj}.  The
  \var{destr} function will be called when the object is reclaimed.  The
***************
*** 4662,4670 ****
  
  \begin{cfuncdesc}{PyObject*}{PyObject_Init}{PyObject *op,
! 						PyTypeObject *type}
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{PyVarObject*}{PyObject_InitVar}{PyVarObject *op,
! 						PyTypeObject *type, int size}
  \end{cfuncdesc}
  
--- 4670,4678 ----
  
  \begin{cfuncdesc}{PyObject*}{PyObject_Init}{PyObject *op,
!                                                 PyTypeObject *type}
  \end{cfuncdesc}
  
  \begin{cfuncdesc}{PyVarObject*}{PyObject_InitVar}{PyVarObject *op,
!                                                 PyTypeObject *type, int size}
  \end{cfuncdesc}
  
***************
*** 4910,4914 ****
  \input{reportingbugs}
  
! \input{api.ind}			% Index -- must be last
  
  \end{document}
--- 4918,4922 ----
  \input{reportingbugs}
  
! \input{api.ind}                 % Index -- must be last
  
  \end{document}