Objek File
**********

These APIs are a minimal emulation of the Python 2 C API for built-in
file objects, which used to rely on the buffered I/O ("FILE*") support
from the C standard library.  In Python 3, files and streams use the
new "io" module, which defines several layers over the low-level
unbuffered I/O of the operating system.  The functions described below
are convenience C wrappers over these new APIs, and meant mostly for
internal error reporting in the interpreter; third-party code is
advised to access the "io" APIs instead.

PyObject *PyFile_FromFd(int fd, const char *name, const char *mode, int buffering, const char *encoding, const char *errors, const char *newline, int closefd)
    *Return value: New reference.** Part of the Stable ABI.*

   Membuat objek file Python dari deskriptor file dari file yang sudah
   dibuka *fd*. Argumen *name*, *encoding*, *errors* dan * newline*
   bisa "NULL" untuk menggunakan nilai default; *buffering* bisa *-1*
   untuk menggunakan default. *name* diabaikan dan disimpan untuk
   kompatibilitas ke belakang. Mengembalikan "NULL" jika gagal. Untuk
   penjelasan yang lebih lengkap tentang argumen, silakan merujuk ke
   dokumentasi fungsi  "io.open()".

   Peringatan:

     Karena aliran Python memiliki lapisan penyangga sendiri,
     mencampurnya dengan deskriptor file tingkat OS dapat menghasilkan
     berbagai masalah (seperti pengurutan data yang tidak terduga).

   Berubah pada versi 3.2: Abaikan atribut *name*.

int PyObject_AsFileDescriptor(PyObject *p)
    * Part of the Stable ABI.*

   Return the file descriptor associated with *p* as an "int".  If the
   object is an integer, its value is returned.  If not, the object's
   "fileno()" method is called if it exists; the method must return an
   integer, which is returned as the file descriptor value.  Sets an
   exception and returns "-1" on failure.

PyObject *PyFile_GetLine(PyObject *p, int n)
    *Return value: New reference.** Part of the Stable ABI.*

   Setara dengan "p.readline([n])", fungsi ini membaca satu baris dari
   objek *p*. *p* dapat berupa objek file atau objek apa pun dengan
   metode "readline()". Jika *n* adalah "0", tepat satu baris terbaca,
   berapa pun panjang barisnya. Jika *n* lebih besar dari "0", tidak
   lebih dari *n* byte yang akan dibaca dari file; garis parsial dapat
   dikembalikan. Dalam kedua kasus, string kosong dikembalikan jika
   akhir file dicapai dengan segera. Jika *n* lebih kecil dari "0",
   bagaimanapun, satu baris dibaca berapa pun panjangnya, tapi
   "EOFError" dimunculkan jika akhir file dicapai dengan segera.

int PyFile_SetOpenCodeHook(Py_OpenCodeHookFunction handler)

   Mengganti perilaku normal "io.open_code()" untuk meneruskan
   parameternya melalui penangan yang disediakan.

   The handler is a function of type "PyObject *(*)(PyObject *path,
   void *userData)", where *path* is guaranteed to be
   "PyUnicodeObject".

   Pointer *userData* diteruskan ke fungsi hook. Karena fungsi hook
   dapat dipanggil dari runtime yang berbeda, pointer ini tidak boleh
   merujuk langsung ke status Python.

   Karena hook ini sengaja digunakan selama impor, hindari mengimpor
   modul baru selama eksekusinya kecuali jika mereka diketahui telah
   dibekukan atau tersedia di "sys.modules".

   Setelah hook diatur, hook tidak dapat dilepas atau diganti, dan
   panggilan ke "PyFile_SetOpenCodeHook()" akan gagal. Jika gagal,
   fungsi mengembalikan -1 dan mengatur pengecualian jika interpreter
   telah diinisialisasi.

   Fungsi ini aman untuk dipanggil sebelum "Py_Initialize()".

   Raises an auditing event "setopencodehook" with no arguments.

   Baru pada versi 3.8.

int PyFile_WriteObject(PyObject *obj, PyObject *p, int flags)
    * Part of the Stable ABI.*

   Menulis objek *obj* ke file objek *p*. Satu-satunya tanda yang
   didukung untuk *flags* adalah "Py_PRINT_RAW"; jika diberikan,
   fungsi "str()" dari objek akan dituliskan sebagai pengganti
   "repr()". Mengembalikan "0" saat sukses atau "-1" saat gagal;
   pengecualian yang sesuai akan ditetapkan.

int PyFile_WriteString(const char *s, PyObject *p)
    * Part of the Stable ABI.*

   Menulis string *s* ke file objek *p*. Mengembalikan "0" saat sukses
   atau "-1" saat gagal; pengecualian yang sesuai akan ditetapkan.
