Update of /cvsroot/pywin32/pywin32/win32/src
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv24745/win32/src
Modified Files:
PyUnicode.cpp
Log Message:
Update autoduck comments on Unicode objects to the present day reality.
Index: PyUnicode.cpp
===================================================================
RCS file: /cvsroot/pywin32/pywin32/win32/src/PyUnicode.cpp,v
retrieving revision 1.20
retrieving revision 1.21
diff -C2 -d -r1.20 -r1.21
*** PyUnicode.cpp 26 May 2004 08:51:33 -0000 1.20
--- PyUnicode.cpp 4 Jul 2005 05:39:03 -0000 1.21
***************
*** 13,16 ****
--- 13,23 ----
#endif
+ // @object PyUnicode|A Python object, representing a Unicode string.
+ // @comm pywin32 uses the builtin Python Unicode object
+ // <nl>In general, any pywin32/COM function documented as taking a
+ // PyUnicode parameter will also accept a Python string object, which will
+ // be automatically encoded using the MBCS encoding before being passed to the function.
+ // Note that the reverse is generally *not* true - a function documented as accepting
+ // a string must be passed a string.
#ifndef MS_WINCE
***************
*** 409,418 ****
}
-
- // @object PyUnicode|A Python object, representing a Unicode string.
- // @comm A PyUnicode object is used primarily when exchanging string
- // information across a COM interface.
-
-
static PySequenceMethods PyUnicode_SequenceMethods = {
(inquiry)PyUnicode::lengthFunc, /*sq_length*/
--- 416,419 ----
***************
*** 433,451 ****
0,
PyUnicode::deallocFunc, /* tp_dealloc */
- // @pymeth __print__|Used when the object is printed.
PyUnicode::printFunc, /* tp_print */
PyUnicode::getattrFunc, /* tp_getattr */
0, /* tp_setattr */
- // @pymeth __cmp__|Used when Unicode objects are compared.
PyUnicode::compareFunc, /* tp_compare */
- // @pymeth __repr__|Used when repr(object) is used.
PyUnicode::reprFunc, /* tp_repr */
0, /* tp_as_number */
&PyUnicode_SequenceMethods, /* tp_as_sequence */
0, /* tp_as_mapping */
- // @pymeth __hash__|Used when the hash value of an object is required
PyUnicode::hashFunc, /* tp_hash */
0, /* tp_call */
- // @pymeth __str__|Used when an (8-bit) string representation is required
PyUnicode::strFunc, /* tp_str */
};
--- 434,447 ----
|
