리스트 객체¶
-
PyTypeObject
PyList_Type
¶ 이
PyTypeObject
인스턴스는 파이썬 리스트 형을 나타냅니다. 이것은 파이썬 계층의list
와 같은 객체입니다.
-
PyObject*
PyList_New
(Py_ssize_t len)¶ - Return value: New reference.
성공하면 길이 len 인 새 리스트를, 실패하면
NULL
을 반환합니다.참고
len이 0보다 크면, 반환된 리스트 객체의 항목은
NULL
로 설정됩니다. 따라서 모든 항목을PyList_SetItem()
로 실제 객체로 설정하기 전에PySequence_SetItem()
와 같은 추상 API 함수를 사용하거나 파이썬 코드에 객체를 노출할 수 없습니다.
-
Py_ssize_t
PyList_GET_SIZE
(PyObject *list)¶ 에러 검사 없는
PyList_Size()
의 매크로 형식.
-
PyObject*
PyList_GetItem
(PyObject *list, Py_ssize_t index)¶ - Return value: Borrowed reference.
list가 가리키는 리스트에서 index 위치의 객체를 반환합니다. 위치는 음수가 아니어야 합니다; 리스트의 끝에서부터의 인덱싱은 지원되지 않습니다. index가 범위를 벗어나면 (<0 또는 >=len(list)),
NULL
을 반환하고IndexError
예외를 설정합니다.
-
PyObject*
PyList_GET_ITEM
(PyObject *list, Py_ssize_t i)¶ - Return value: Borrowed reference.
에러 검사 없는
PyList_GetItem()
의 매크로 형식.
-
int
PyList_SetItem
(PyObject *list, Py_ssize_t index, PyObject *item)¶ 리스트의 인덱스 index에 있는 항목을 item으로 설정합니다. 성공하면
0
을 반환합니다. index가 범위를 벗어나면,-1
을 반환하고IndexError
예외를 설정합니다.참고
이 함수는 item에 대한 참조를 “훔치고” 영향을 받는 위치의 리스트에 이미 있는 항목에 대한 참조를 버립니다.
-
void
PyList_SET_ITEM
(PyObject *list, Py_ssize_t i, PyObject *o)¶ 에러 검사 없는
PyList_SetItem()
의 매크로 형식. 일반적으로 이전 내용이 없는 새 리스트를 채우는 데 사용됩니다.참고
이 매크로는 item에 대한 참조를 “훔치고”,
PyList_SetItem()
과는 달리 대체되는 항목에 대한 참조를 버리지 않습니다; list 의 i 위치에 있는 참조는 누수를 일으킵니다.
-
int
PyList_Insert
(PyObject *list, Py_ssize_t index, PyObject *item)¶ 항목 item을 리스트 list의 인덱스 index 앞에 삽입합니다. 성공하면
0
을 반환합니다; 실패하면-1
을 반환하고 예외를 설정합니다.list.insert(index, item)
에 해당합니다.
-
int
PyList_Append
(PyObject *list, PyObject *item)¶ 리스트 list의 끝에 객체 item을 추가합니다. 성공하면
0
을 반환합니다; 실패하면-1
을 반환하고 예외를 설정합니다.list.append(item)
에 해당합니다.
-
PyObject*
PyList_GetSlice
(PyObject *list, Py_ssize_t low, Py_ssize_t high)¶ - Return value: New reference.
list에서 low 와 high 사이에있는 객체들을 포함하는 리스트를 반환합니다. 실패하면
NULL
을 반환하고 예외를 설정합니다.list[low:high]
에 해당합니다. 리스트 끝에서부터의 인덱싱은 지원되지 않습니다.
-
int
PyList_SetSlice
(PyObject *list, Py_ssize_t low, Py_ssize_t high, PyObject *itemlist)¶ low와 high 사이의 list슬라이스를 itemlist의 내용으로 설정합니다.
list[low:high] = itemlist
에 해당합니다. itemlist는NULL
일 수 있는데, 빈 리스트의 대입을 나타냅니다 (슬라이스 삭제). 성공하면0
을, 실패하면-1
을 반환합니다. 리스트 끝에서부터의 인덱싱은 지원되지 않습니다.
-
int
PyList_Sort
(PyObject *list)¶ list 항목을 제자리에서 정렬합니다. 성공하면
0
을, 실패하면-1
을 반환합니다. 이것은list.sort()
와 동등합니다.
-
int
PyList_Reverse
(PyObject *list)¶ list의 항목을 제자리에서 뒤집습니다. 성공하면
0
을, 실패하면-1
을 반환합니다. 이것은list.reverse()
와 동등합니다.
-
PyObject*
PyList_AsTuple
(PyObject *list)¶ - Return value: New reference.
list의 내용을 포함하는 새 튜플 객체를 반환합니다;
tuple(list)
와 동등합니다.
-
int
PyList_ClearFreeList
()¶ 자유 목록(free list)을 비웁니다. 해제된 항목의 총수를 반환합니다.
버전 3.3에 추가.