데이터 마샬링 지원
******************

이러한 루틴은 C 코드가 "marshal" 모듈과 같은 데이터 형식을 사용하여 직
렬화된 객체로 작업 할 수 있도록 합니다. 직렬화 형식으로 데이터를 쓰는
함수와 데이터를 다시 읽는 데 사용할 수 있는 추가 함수가 있습니다. 마샬
링 된 데이터를 저장하는 데 사용되는 파일은 바이너리 모드로 열어야 합니
다.

숫자 값은 최하위 바이트가 먼저 저장됩니다.

이 모듈은 두 가지 버전의 데이터 형식을 지원합니다: 버전 0은 역사적인
버전이고, 버전 1은 파일에서와 역 마샬링할 때 인턴(intern) 된 문자열을
공유합니다. 버전 2는 부동 소수점 숫자에 대해 바이너리 형식을 사용합니
다. "Py_MARSHAL_VERSION"은 현재 파일 형식을 나타냅니다 (현재 2).

void PyMarshal_WriteLongToFile(long value, FILE *file, int version)

   long 정수 *value*를 *file*로 마샬합니다. *value*의 최하위 32비트 만
   기록합니다; 기본 long 형의 크기와 관계없이. *version*은 파일 형식을
   나타냅니다.

   This function can fail, in which case it sets the error indicator.
   Use "PyErr_Occurred()" to check for that.

void PyMarshal_WriteObjectToFile(PyObject *value, FILE *file, int version)

   파이썬 객체 *value*를 *file*로 마샬합니다. *version*은 파일 형식을
   나타냅니다.

   This function can fail, in which case it sets the error indicator.
   Use "PyErr_Occurred()" to check for that.

PyObject *PyMarshal_WriteObjectToString(PyObject *value, int version)
    *반환값: 새 참조.*

   마샬된 *value* 표현을 포함한 바이트열 객체를 반환합니다. *version*
   은 파일 형식을 나타냅니다.

다음 함수를 사용하면 마샬된 값을 다시 읽을 수 있습니다.

long PyMarshal_ReadLongFromFile(FILE *file)

   읽기 위해 열린 FILE*의 데이터 스트림에서 C long을 반환합니다. 이 함
   수를 사용하면 long의 기본 크기와 관계없이 32비트 값만 읽을 수 있습
   니다.

   에러 시, 적절한 예외("EOFError")를 설정하고 "-1"을 반환합니다.

int PyMarshal_ReadShortFromFile(FILE *file)

   읽기 위해 열린 FILE*의 데이터 스트림에서 C short를 반환합니다. 이
   함수를 사용하면 short의 기본 크기와 관계없이 16비트 값만 읽을 수 있
   습니다.

   에러 시, 적절한 예외("EOFError")를 설정하고 "-1"을 반환합니다.

PyObject *PyMarshal_ReadObjectFromFile(FILE *file)
    *반환값: 새 참조.*

   읽기 위해 열린 FILE*의 데이터 스트림에서 파이썬 객체를 반환합니다.

   에러 시, 적절한 예외("EOFError", "ValueError" 또는 "TypeError")를
   설정하고 "NULL"을 반환합니다.

PyObject *PyMarshal_ReadLastObjectFromFile(FILE *file)
    *반환값: 새 참조.*

   읽기 위해 열린 FILE*의 데이터 스트림에서 파이썬 객체를 반환합니다.
   "PyMarshal_ReadObjectFromFile()"와 달리, 이 함수는 더는 파일에서 객
   체를 읽지 않을 것이라고 가정함으로써, 파일 데이터를 메모리에 적극적
   으로 로드 할 수 있고, 파일에서 한 바이트씩 읽는 대신 메모리에 있는
   데이터에서 역 직렬화가 작동할 수 있습니다. 파일에서 어떤 것도 읽지
   않을 것이라는 확신이 들 경우에만 이 변형을 사용하십시오.

   에러 시, 적절한 예외("EOFError", "ValueError" 또는 "TypeError")를
   설정하고 "NULL"을 반환합니다.

PyObject *PyMarshal_ReadObjectFromString(const char *data, Py_ssize_t len)
    *반환값: 새 참조.*

   *data*가 가리키는 *len* 바이트를 포함하는 바이트 버퍼의 데이터 스트
   림에서 파이썬 객체를 반환합니다.

   에러 시, 적절한 예외("EOFError", "ValueError" 또는 "TypeError")를
   설정하고 "NULL"을 반환합니다.
