# 切片物件

PyTypeObject PySlice_Type
  為 穩定 ABI 的一部分.

  slice 物件的型別物件。這與 Python 層中的 `slice` 相同。

int PySlice_Check( PyObject *ob)

  如果 ob 是 slice 物件，則回傳 true；ob 不能是 `NULL` 。此函式永遠成功。

PyObject *PySlice_New( PyObject *start, PyObject *stop, PyObject *step)
  回傳值：新的參照。 為 穩定 ABI 的一部分.

  以指定的值回傳一個新的切片物件。start、stop 及 step 參數會被用為同名的 slice 物件屬性值。任何值都可能是 `NULL`，在這種情況下，`None` 將用於相對應的屬性。

  如果無法分配新物件，則回傳 `NULL` 並設定例外。

int PySlice_GetIndices( PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)
  為 穩定 ABI 的一部分.

  從 slice 物件 slice 讀取開始、停止和步進索引，假設序列長度為 length。將大於 length 的索引視為錯誤。

  成功時回傳 `0`，錯誤時回傳 `-1`，並無例外設定（除非其中一個索引不是 `None` 並且未能轉換成整數，在這種情況下會回傳 `-1` ，並有設定例外）。

  你可能不想使用此功能。

  在 3.2 版的變更: 之前 slice 的參數型別是 `PySliceObject*` 。

int PySlice_GetIndicesEx( PyObject *slice, Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step, Py_ssize_t *slicelength)
  為 穩定 ABI 的一部分.

  可用來取代 `PySlice_GetIndices()`。從假設序列長度為 length 的 slice 物件 slice 擷取開始、停止和步長索引，並將 slice 的長度存入 slicelength。超出範圍的索引會被剪切，剪切方式與一般切片的處理方式一致。

  成功時回傳 `0` ，在失敗時回傳 `-1` 並設定例外。

  備註

  這個函式對於可調整大小的序列並不安全。它的呼叫應該被 `PySlice_Unpack()` 和 `PySlice_AdjustIndices()` 的組合取代，其中：

      if (PySlice_GetIndicesEx(slice, length, &start, &stop, &step, &slicelength) < 0) {
          // return error
      }

  被更換為：

      if (PySlice_Unpack(slice, &start, &stop, &step) < 0) {
          // return error
      }
      slicelength = PySlice_AdjustIndices(length, &start, &stop, step);

  在 3.2 版的變更: 之前 slice 的參數型別是 `PySliceObject*` 。

  在 3.6.1 版的變更: 如果 `Py_LIMITED_API` 沒有設定或設定為 `0x03050400` 和 `0x03060000` (不包括) 或 `0x03060100` 或更高的值 `PySlice_GetIndicesEx()` 是使用 `PySlice_Unpack()` 和 `PySlice_AdjustIndices()` 來實作一個巨集。引數 start、stop 和 step 會被計算多次。

  在 3.6.1 版之後被棄用: 如果 `Py_LIMITED_API` 設定為小於 `0x03050400` 或介於 `0x03060000` 和 `0x03060100` 之間 (不包括邊界值) `PySlice_GetIndicesEx()` 是一個已廢棄的函式。

int PySlice_Unpack( PyObject *slice, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t *step)
  為 穩定 ABI 的一部分 自 3.7 版本開始.

  以 C 整數的形式從 slice 物件中抽取 start、stop 及 step 資料成員。將大於 `PY_SSIZE_T_MAX` 的值靜默減少為 `PY_SSIZE_T_MAX`，將小於 `PY_SSIZE_T_MIN` 的 start 和 stop 值靜默提升為 `PY_SSIZE_T_MIN`，將小於 `-PY_SSIZE_T_MAX` 的 step 值靜默提升為 `-PY_SSIZE_T_MAX`。

  成功時回傳 `0`，在失敗時回傳 `-1` 並設定例外。

  在 3.6.1 版被加入.

Py_ssize_t PySlice_AdjustIndices( Py_ssize_t length, Py_ssize_t *start, Py_ssize_t *stop, Py_ssize_t step)
  為 穩定 ABI 的一部分 自 3.7 版本開始.

  假設序列長度為指定長度，調整開始/結束切片索引。超出範圍的索引會以與處理正常切片一致的方式切除。

  回傳切片的長度。永遠成功。不呼叫 Python 程式碼。

  在 3.6.1 版被加入.

## Ellipsis 物件

PyTypeObject PyEllipsis_Type
  為 穩定 ABI 的一部分.

  Python `Ellipsis` 物件的型別。與 Python 層中的 `types.EllipsisType` 相同。

PyObject *Py_Ellipsis

  Python `Ellipsis` 物件。這個物件沒有方法。就像 `Py_None` 一樣，它是一個 immortal 單一物件。

  在 3.12 版的變更: `Py_Ellipsis` 為不滅的 (immortal)。