Diff for "StreamWriter"

Differences between revisions 1 and 6 (spanning 5 versions)

As of Python2.5, StreamWriter wraps (contains) a stream. It defines write and other respective methods to "encode" the data and pass the result to the stream. It exposes all other methods of the stream instance.

Pseudocode of the codecs.StreamWriter definition:

   1 class StreamWriter(Codec):
   2     def __init__(self, stream):
   3         ....
   4 
   5     def write(self, data):
   6         return stream.write(self.encode(data))

The encode method normally converts values of type unicode to strs.

Codec modules will attach the encode method to the class definition derived from StreamWriter during the initialization. An excerpt from encodings.utf_8.StreamWriter:

   1 class StreamWriter(codecs.StreamWriter):
   2     encode = codecs.utf_8_encode

-  ⇤ ← Revision 1 as of 2007-04-02 21:03:15 → 
  Size: 661
  Editor: cscfpc15
  Comment:
+   ← Revision 6 as of 2007-04-02 21:40:23 → ⇥
  Size: 911
  Editor: cscfpc15
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 1:
+As of Python2.5, {{{StreamWriter}}} wraps (contains) a stream.  It defines {{{write}}} and other respective methods to "encode" the data and pass the result to the stream.  It exposes all other methods of the stream instance.
-Line 2:
+Line 3:
-StreamWriter wraps (contains) a stream.  Its {{{write}}} overrides will "encode" the data and pass the result to the stream.

Pseudocode of the {{{codecs.StreamWriter}}} definition in Python2.5:
+Pseudocode of the {{{codecs.StreamWriter}}} definition:
-Line 12:
+Line 11:
-    def write(data):
+    def write(self, data):
-Line 16:
+Line 15:
-The {{{StreamWriter.encode}}} method is attached to the derived codec-specific class definitions at the time of the codec initialization.  An excerpt from {{{encodings.utf_8.StreamWriter}}}:
+The {{{encode}}} method normally converts values of type {{{unicode}}}  to {{{str}}}s.

Codec modules will attach the {{{encode}}} method to the class definition derived from {{{StreamWriter}}} during the initialization.  An excerpt from {{{encodings.utf_8.StreamWriter}}}:
-Line 23:
+Line 25:
+----
See also: StreamReader, StreamRecoder.
----
CategoryUnicode

Page

User