4.2 codecs--Codec注册管理和基类

本模块定义了Python标准codecs（编码和解码）的基类，也提供了对Python内部codec的注册，管理和数据处理过程。大部分标准的codecs都是文本编解码器，主要是用来把文本怎么样编码成字节方式。不过也有一些codecs是用来从文本到文本的编码方式，或者从字节到字节的编码方式。当然也可以根据基类来定制codecs，可以任意间的数据类型进行转换，只要注意在某些codecs是限制在文本编解码，某些是限制在字节之间编解码的。
对于任何的编解码器codec都有下面的函数：
codecs.encode(obj[, encoding[, errors]]) 
使用已经注册的编码器encoding来对对象obj进行编码，如果有出错按errors方式处理。默认编码器是utf-8。错误处理参数errors可以使用预定的，也可以按后面方法进行自定义。默认是strict方式处理，当出现错误时抛出异常ValueError。
例子：
#python 3.4.3
import codecs

en = codecs.encode('把深圳建设成世界软件中心', 'utf_8', 'strict')
print(en)
结果输出如下：
b'\xe6\x8a\x8a\xe6\xb7\xb1\xe5\x9c\xb3\xe5\xbb\xba\xe8\xae\xbe\xe6\x88\x90\xe4\xb8\x96\xe7\x95\x8c\xe8\xbd\xaf\xe4\xbb\xb6\xe4\xb8\xad\xe5\xbf\x83'
 
codecs.decode(obj[, encoding[, errors]]) 
使用已经注册的编码器encoding把对象obj进行解码，如果有出错按出错机制errors处理。默认编码器是utf-8。错误处理参数errors可以使用预定的，也可以按后面方法进行自定义。默认是strict方式处理，当出现错误时抛出异常ValueError。
例子：#python 3.4.3
import codecs

en = codecs.encode('把深圳建设成世界软件中心', 'utf_8', 'strict')
print(en)

de = codecs.decode(en, 'utf_8', 'strict')
print(de)

结果输出如下：
b'\xe6\x8a\x8a\xe6\xb7\xb1\xe5\x9c\xb3\xe5\xbb\xba\xe8\xae\xbe\xe6\x88\x90\xe4\xb8\x96\xe7\x95\x8c\xe8\xbd\xaf\xe4\xbb\xb6\xe4\xb8\xad\xe5\xbf\x83'
把深圳建设成世界软件中心

codecs.lookup(encoding)
通过编解码器的名称encoding来查找编解码器，如果成功找到返回CodecInfo对象，否则抛出异常LookupError。
例子：

#python 3.4.3
import codecs

cinfo = codecs.lookup('utf_8')
print(cinfo)

cinfo = codecs.lookup('gb2312')
print(cinfo)

cinfo = codecs.lookup('test')
print(cinfo)

结果输出如下：
<codecs.CodecInfo object for encoding utf-8 at 0x29a6500>
<codecs.CodecInfo object for encoding gb2312 at 0x29bf420>
Traceback (most recent call last):
  File "E:/pywin/codecs1.py", line 10, in <module>
    cinfo = codecs.lookup('test')
LookupError: unknown encoding: test
 
codecs.getencoder(encoding) 
通过encoding获取编码器的编码函数，简化对编码的重复调用。如果找不到抛出异常LookupError。
例子：#python 3.4.3
import codecs

cinfo = codecs.getencoder('utf_8')
print(cinfo)
en = cinfo('深圳软件')
print(en)

cinfo = codecs.getencoder('gb2312')
print(cinfo)
结果输出如下：
<built-in function utf_8_encode>
(b'\xe6\xb7\xb1\xe5\x9c\xb3\xe8\xbd\xaf\xe4\xbb\xb6', 4)
<built-in method encode of MultibyteCodec object at 0x029FB150>
 
codecs.getdecoder(encoding)
通过encoding获取解码器的函数。简化对解码的重复调用。如果找不到抛出异常LookupError。
例子：
#python 3.4.3
import codecs
 
cinfo = codecs.getdecoder('utf_8')
print(cinfo)
 
de = cinfo(b'\xe6\xb7\xb1\xe5\x9c\xb3\xe8\xbd\xaf\xe4\xbb\xb6')
print(de)
结果输出如下：
<function decode at 0x00261E88>
('深圳软件', 12)
 
codecs.getincrementalencoder(encoding) 
返回一个encoding编码的增量编码器。如果没有找到抛出异常LookupError。
例子：
#python 3.4.3
import codecs
 
encoder = codecs.getincrementalencoder('idna')()
print(encoder)
 
encoder.reset()
en = encoder.encode(u"\xe4x")
en = encoder.encode(u"ample.org")
en = encoder.encode(u"", True)
print(en)
结果输出如下：
<encodings.idna.IncrementalEncoder object at 0x029BB4B0>
b'org'
 
codecs.getincrementaldecoder(encoding) 
返回一个encoding编码的增量解码器。如果没有找到抛出异常LookupError。
例子：
#python 3.4.3
import codecs
 
d = codecs.getincrementaldecoder("utf-8-sig")()
s = u"spam"
print(d.decode(s.encode("utf-8-sig")))
结果输出如下：
spam
 
codecs.getreader(encoding) 
返回一个encoding编码的流读取对象StreamReader，如果查找不到抛出异常 LookupError。
例子：
#python 3.4.3
import codecs
import urllib.request, json
 
f = urllib.request.urlopen("https://pypi.python.org/pypi/{}/{}/json".
                        format('jsonpatch', '1.11' or ''))
reader = codecs.getreader("utf-8")
pkg_data = json.load(reader(f))
f.close()
 
d = {}
d['name'] = pkg_data['info']['name']
d['homepage'] = pkg_data['info'].get('home_page', '')
        
print(d)
结果输出如下：
{'homepage': 'https://github.com/stefankoegl/python-json-patch', 'name': 'jsonpatch'}
 
codecs.getwriter(encoding) 
返回一个encoding解码的流写入对象StreamWriter，如果查找不到抛出异常 LookupError。
例子：
#python 3.4.3
import io, codecs
 
s = io.BytesIO()
c = codecs.getwriter('gb18030')(s)
c.write('test')
print(s.getvalue())
结果输出如下：
b'test'