15.15 C字符串转换为Python字符串

问题

怎样将C中的字符串转换为Python字节或一个字符串对象?

解决方案

C字符串使用一对 char *int 来表示,你需要决定字符串到底是用一个原始字节字符串还是一个Unicode字符串来表示。字节对象可以像下面这样使用 Py_BuildValue() 来构建:

  1. char *s; /* Pointer to C string data */
  2. int len; /* Length of data */
  3.  
  4. /* Make a bytes object */
  5. PyObject *obj = Py_BuildValue("y#", s, len);

如果你要创建一个Unicode字符串,并且你知道 s 指向了UTF-8编码的数据,可以使用下面的方式:

  1. PyObject *obj = Py_BuildValue("s#", s, len);

如果 s 使用其他编码方式,那么可以像下面使用 PyUnicode_Decode() 来构建一个字符串:

  1. PyObject *obj = PyUnicode_Decode(s, len, "encoding", "errors");
  2.  
  3. /* Examples /*
  4. obj = PyUnicode_Decode(s, len, "latin-1", "strict");
  5. obj = PyUnicode_Decode(s, len, "ascii", "ignore");

如果你恰好有一个用 wchar_t *, len 对表示的宽字符串,有几种选择性。首先你可以使用 Py_BuildValue()

  1. wchar_t *w; /* Wide character string */
  2. int len; /* Length */
  3.  
  4. PyObject *obj = Py_BuildValue("u#", w, len);

另外,你还可以使用 PyUnicode_FromWideChar() :

  1. PyObject *obj = PyUnicode_FromWideChar(w, len);

对于宽字符串,并没有对字符数据进行解析——它被假定是原始Unicode编码指针,可以被直接转换成Python。

讨论

将C中的字符串转换为Python字符串遵循和I/O同样的原则。也就是说,来自C中的数据必须根据一些解码器被显式的解码为一个字符串。通常编码格式包括ASCII、Latin-1和UTF-8.如果你并不确定编码方式或者数据是二进制的,你最好将字符串编码成字节。当构造一个对象的时候,Python通常会复制你提供的字符串数据。如果有必要的话,你需要在后面去释放C字符串。同时,为了让程序更加健壮,你应该同时使用一个指针和一个大小值,而不是依赖NULL结尾数据来创建字符串。

原文:

http://python3-cookbook.readthedocs.io/zh_CN/latest/c15/p15_converting_c_string_to_python.html