15.17小节完成

yidao620c · yidao620c · commit 356c145e4c5e · 2015-12-25T15:41:22.000+08:00
diff --git a/source/c15/p17_pass_filenames_to_c_extensions.rst b/source/c15/p17_pass_filenames_to_c_extensions.rst
@@ -5,64 +5,65 @@
 ----------
 问题
 ----------
-You need to pass filenames to C library functions, but need to make sure the filename
-has been encoded according to the system’s expected filename encoding.
+你需要向C库函数传递文件名，但是需要确保文件名根据系统期望的文件名编码方式编码过。
 
 |
 
 ----------
 解决方案
 ----------
-To write an extension function that receives a filename, use code such as this:
+写一个接受一个文件名为参数的扩展函数，如下这样：
 
-static PyObject *py_get_filename(PyObject *self, PyObject *args) {
-  PyObject *bytes;
-  char *filename;
-  Py_ssize_t len;
-  if (!PyArg_ParseTuple(args,"O&", PyUnicode_FSConverter, &bytes)) {
-    return NULL;
-  }
-  PyBytes_AsStringAndSize(bytes, &filename, &len);
-  /* Use filename */
-  ...
+::
 
-  /* Cleanup and return */
-  Py_DECREF(bytes)
-  Py_RETURN_NONE;
-}
+    static PyObject *py_get_filename(PyObject *self, PyObject *args) {
+      PyObject *bytes;
+      char *filename;
+      Py_ssize_t len;
+      if (!PyArg_ParseTuple(args,"O&", PyUnicode_FSConverter, &bytes)) {
+        return NULL;
+      }
+      PyBytes_AsStringAndSize(bytes, &filename, &len);
+      /* Use filename */
+      ...
 
-If you already have a PyObject * that you want to convert as a filename, use code such
-as the following:
+      /* Cleanup and return */
+      Py_DECREF(bytes)
+      Py_RETURN_NONE;
+    }
 
-PyObject *obj;    /* Object with the filename */
-PyObject *bytes;
-char *filename;
-Py_ssize_t len;
+如果你已经有了一个 ``PyObject *`` ，希望将其转换成一个文件名，可以像下面这样做：
 
-bytes = PyUnicode_EncodeFSDefault(obj);
-PyBytes_AsStringAndSize(bytes, &filename, &len);
-/* Use filename */
-...
+::
 
-/* Cleanup */
-Py_DECREF(bytes);
+    PyObject *obj;    /* Object with the filename */
+    PyObject *bytes;
+    char *filename;
+    Py_ssize_t len;
 
-If you need to return a filename back to Python, use the following code:
+    bytes = PyUnicode_EncodeFSDefault(obj);
+    PyBytes_AsStringAndSize(bytes, &filename, &len);
+    /* Use filename */
+    ...
 
-/* Turn a filename into a Python object */
+    /* Cleanup */
+    Py_DECREF(bytes);
 
-char *filename;       /* Already set */
-int   filename_len;   /* Already set */
+    If you need to return a filename back to Python, use the following code:
 
-PyObject *obj = PyUnicode_DecodeFSDefaultAndSize(filename, filename_len);
+    /* Turn a filename into a Python object */
+
+    char *filename;       /* Already set */
+    int   filename_len;   /* Already set */
+
+    PyObject *obj = PyUnicode_DecodeFSDefaultAndSize(filename, filename_len);
 
 |
 
 ----------
 讨论
 ----------
-Dealing with filenames in a portable way is a tricky problem that is best left to Python.
-If you use this recipe in your extension code, filenames will be handled in a manner that
-is consistent with filename handling in the rest of Python. This includes encoding/
-decoding of bytes, dealing with bad characters, surrogate escapes, and other complica‐
-tions.
+以可移植方式来处理文件名是一个很棘手的问题，最后交由Python来处理。
+如果你在扩展代码中使用本节的技术，文件名的处理方式和和Python中是一致的。
+包括编码/界面字节，处理坏字符，代理转换和其他复杂情况。
+
