바이트열 객체

이 함수들은 바이트열 매개 변수가 필요할 때 바이트열이 아닌 매개 변수로 호출하면 TypeError를 발생시킵니다.

type PyBytesObject

이 PyObject의 서브 형은 파이썬 바이트열 객체를 나타냅니다.

PyTypeObject PyBytes_Type

Part of the 안정 ABI.

이 PyTypeObject의 인스턴스는 파이썬 바이트열 형을 나타냅니다; 파이썬 계층의 bytes와 같은 객체입니다.

int PyBytes_Check(PyObject *o)

객체 o가 바이트열 객체이거나 바이트열 형의 서브 형의 인스턴스면 참을 반환합니다. 이 함수는 항상 성공합니다.

int PyBytes_CheckExact(PyObject *o)

객체 o가 바이트열 객체이지만, 바이트열 형의 서브 형의 인스턴스는 아니면 참을 반환합니다. 이 함수는 항상 성공합니다.

PyObject *PyBytes_FromString(const char *v)

반환값: 새 참조. Part of the 안정 ABI.

성공하면 값으로 v 문자열의 복사본을 갖는 새 바이트열 객체를 반환하고, 실패하면 NULL을 반환합니다. 매개 변수 v는 NULL이 아니어야 합니다; 검사하지 않습니다.

PyObject *PyBytes_FromStringAndSize(const char *v, Py_ssize_t len)

반환값: 새 참조. Part of the 안정 ABI.

성공하면 값이 v 문자열의 복사본이고 길이가 len인 새 바이트열 객체를 반환하고, 실패하면 NULL을 반환합니다. v가 NULL이면, 바이트열 객체의 내용은 초기화되지 않습니다.

PyObject *PyBytes_FromFormat(const char *format, ...)

반환값: 새 참조. Part of the 안정 ABI.

C printf()-스타일 format 문자열과 가변 개수의 인자를 받아서, 결과 파이썬 바이트열 객체의 크기를 계산하고 그 안에 값이 포맷된 바이트열 객체를 반환합니다. 가변 인자는 C 형이어야 하며 format 문자열에 있는 포맷 문자들과 정확히 대응해야 합니다. 허용되는 포맷 문자는 다음과 같습니다:

포맷 문자	형	주석
%%	n/a	리터럴 % 문자.
%c	int	단일 바이트, C int로 표현됩니다.
%d	int	printf("%d")와 동등합니다. [1]
%u	unsigned int	printf("%u")와 동등합니다. [1]
%ld	long	printf("%ld")와 동등합니다. [1]
%lu	unsigned long	printf("%lu")와 동등합니다. [1]
%zd	Py_ssize_t	printf("%zd")와 동등합니다. [1]
%zu	size_t	printf("%zu")와 동등합니다. [1]
%i	int	printf("%i")와 동등합니다. [1]
%x	int	printf("%x")와 동등합니다. [1]
%s	const char*	널-종료 C 문자 배열.
%p	const void*	C 포인터의 16진수 표현. 플랫폼의 printf가 어떤 결과를 내는지에 상관없이 리터럴 0x로 시작함이 보장된다는 점을 제외하고는 거의 printf("%p")와 동등합니다.

인식할 수 없는 포맷 문자는 포맷 문자열의 나머지 부분이 모두 결과 객체에 그대로 복사되게 만들고, 추가 인자는 무시됩니다.

[1] (1,2,3,4,5,6,7,8)

정수 지정자 (d, u, ld, lu, zd, zu, i, x)에서: 0-변환 플래그는 정밀도를 지정해도 영향을 미칩니다.

PyObject *PyBytes_FromFormatV(const char *format, va_list vargs)

반환값: 새 참조. Part of the 안정 ABI.

정확히 두 개의 인자를 취한다는 것을 제외하고는 PyBytes_FromFormat()과 같습니다.

PyObject *PyBytes_FromObject(PyObject *o)

반환값: 새 참조. Part of the 안정 ABI.

버퍼 프로토콜을 구현하는 객체 o의 바이트열 표현을 반환합니다.

Py_ssize_t PyBytes_Size(PyObject *o)

Part of the 안정 ABI.

바이트열 객체 o의 길이를 반환합니다.

Py_ssize_t PyBytes_GET_SIZE(PyObject *o)

PyBytes_Size()와 유사하지만, 에러 검사가 없습니다.

char *PyBytes_AsString(PyObject *o)

Part of the 안정 ABI.

o의 내용에 대한 포인터를 반환합니다. 포인터는 len(o) + 1 바이트로 구성된 o의 내부 버퍼를 가리킵니다. 버퍼의 마지막 바이트는 다른 널(null) 바이트가 있는지에 관계없이 항상 널입니다. 객체가 PyBytes_FromStringAndSize(NULL, size)를 사용하여 방금 만들어진 경우가 아니면 데이터를 수정해서는 안 됩니다. 할당을 해제해서는 안 됩니다. o가 바이트열 객체가 아니면, PyBytes_AsString()은 NULL을 반환하고 TypeError를 발생시킵니다.

char *PyBytes_AS_STRING(PyObject *string)

PyBytes_AsString()와 유사하지만, 에러 검사가 없습니다.

int PyBytes_AsStringAndSize(PyObject *obj, char **buffer, Py_ssize_t *length)

Part of the 안정 ABI.

출력 변수 buffer와 length로 객체 obj의 널-종료 내용을 반환합니다. 성공하면 0을 반환합니다.

length가 NULL이면, 바이트열 객체는 내장된 널 바이트를 포함할 수 없습니다; 만약 그렇다면 함수는 -1을 반환하고 ValueError를 발생시킵니다.

buffer는 obj의 내부 버퍼를 가리키게 되는데, 끝에 추가 널 바이트가 포함됩니다 (length에는 포함되지 않습니다). 객체가 PyBytes_FromStringAndSize(NULL, size)를 사용하여 방금 만들어진 경우가 아니면 데이터를 수정해서는 안 됩니다. 할당을 해제해서는 안 됩니다. obj가 바이트열 객체가 아니면 PyBytes_AsStringAndSize()는 -1을 반환하고 TypeError를 발생시킵니다.

버전 3.5에서 변경: 이전에는, 바이트열 객체에 널 바이트가 포함되어 있으면 TypeError가 발생했습니다.

void PyBytes_Concat(PyObject **bytes, PyObject *newpart)

Part of the 안정 ABI.

bytes에 newpart의 내용을 덧붙인 새 바이트열 객체를 *bytes에 만듭니다; 호출자가 새 참조를 소유합니다. bytes의 예전 값에 대한 참조를 훔칩니다. 새 객체가 만들어질 수 없으면, bytes에 대한 예전 참조는 여전히 버려지고 *bytes의 값은 NULL로 설정됩니다; 적절한 예외가 설정됩니다.

void PyBytes_ConcatAndDel(PyObject **bytes, PyObject *newpart)

Part of the 안정 ABI.

bytes에 newpart의 내용을 덧붙인 새 바이트열 객체를 *bytes에 만듭니다. 이 버전은 newpart로의 강한 참조를 해제합니다 (즉 참조 횟수를 감소시킵니다).

PyObject *PyBytes_Join(PyObject *sep, PyObject *iterable)

Similar to sep.join(iterable) in Python.

sep must be Python bytes object. (Note that PyUnicode_Join() accepts NULL separator and treats it as a space, whereas PyBytes_Join() doesn’t accept NULL separator.)

iterable must be an iterable object yielding objects that implement the buffer protocol.

On success, return a new bytes object. On error, set an exception and return NULL.

Added in version 3.14.

int _PyBytes_Resize(PyObject **bytes, Py_ssize_t newsize)

바이트열 객체의 크기를 변경합니다. newsize는 바이트열 객체의 새 길이가 됩니다. 새 바이트열 객체를 생성하고 이전 객체를 파괴한다고 생각할 수 있습니다. 단지 더 효율적으로 수행합니다. 기존 바이트열 객체의 주소를 lvalue(내용을 기록할 수 있습니다)로 전달하고, 원하는 새 크기를 전달합니다. 성공하면, *bytes는 크기가 변경된 바이트열 객체를 갖게 되고 0이 반환됩니다; *bytes의 주소는 입력값과 다를 수 있습니다. 재할당이 실패하면, *bytes에 있는 원래 바이트열 객체는 할당 해제되고, *bytes가 NULL로 설정되고, MemoryError가 설정되며 -1이 반환됩니다.

PyObject *PyBytes_Repr(PyObject *bytes, int smartquotes)

Part of the 안정 ABI.

Get the string representation of bytes. This function is currently used to implement bytes.__repr__() in Python.

This function does not do type checking; it is undefined behavior to pass bytes as a non-bytes object or NULL.

If smartquotes is true, the representation will use a double-quoted string instead of single-quoted string when single-quotes are present in bytes. For example, the byte string 'Python' would be represented as b"'Python'" when smartquotes is true, or b'\'Python\'' when it is false.

On success, this function returns a strong reference to a str object containing the representation. On failure, this returns NULL with an exception set.

PyObject *PyBytes_DecodeEscape(const char *s, Py_ssize_t len, const char *errors, Py_ssize_t unicode, const char *recode_encoding)

Part of the 안정 ABI.

Unescape a backslash-escaped string s. s must not be NULL. len must be the size of s.

errors must be one of "strict", "replace", or "ignore". If errors is NULL, then "strict" is used by default.

On success, this function returns a strong reference to a Python bytes object containing the unescaped string. On failure, this function returns NULL with an exception set.

버전 3.9에서 변경: unicode and recode_encoding are now unused.