Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

Added a note that objects which emulate built-in types should only 

implement as many of the relevant methods as make sense for the particular
information being modelled.
This commit is contained in:
Fred Drake 2000-12-07 04:49:34 +00:00
parent 16942f2224
commit 0c47559352
1 changed files with 7 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
Doc/ref/ref3.tex
View File

@ -841,6 +841,13 @@ a list object, \code{x.__getitem__(i)} is not equivalent to
operation raise an exception when no appropriate method is defined.
\withsubitem{(mapping object method)}{\ttindex{__getitem__()}}
When implementing a class that emulates any built-in type, it is
important that the emulation only be implemented to the degree that it
makes sense for the object being modelled. For example, some
sequences may work well with retrieval of individual elements, but
extracting a slice may not make sense. (One example of this is the
\class{NodeList} interface in the W3C's Document Object Model.)
\subsection{Basic customization\label{customization}}