Method __setitem__

tables/table.py:3415–3465

Set a row or a range of rows in a table or nested column. If key argument is an integer, the corresponding row is set to value. If key is a slice, the range of rows determined by it is set to value. Examples -------- :: table.cols[4] = r

(self, key: int | slice, value: Any)

            raise TypeError(f"invalid index or slice: {key!r}")

    def __setitem__(self, key: int | slice, value: Any) -> None:
        """Set a row or a range of rows in a table or nested column.

        If key argument is an integer, the corresponding row is set to
        value. If key is a slice, the range of rows determined by it is set to
        value.

        Examples
        --------
        ::

            table.cols[4] = record
            table.cols.Info[4:1000:2] = recarray

        Those statements are equivalent to::

            table.modify_rows(4, rows=record)
            table.modify_column(4, 1000, 2, colname='Info', column=recarray)

        Here you can see how a mix of natural naming, indexing and slicing
        can be used as shorthands for the :meth:`Table.modify_rows` and
        :meth:`Table.modify_column` methods.

        """
        table = self._v_table
        nrows = table.nrows
        if is_idx(key):
            key = operator.index(key)

            # Index out of range protection
            if key >= nrows:
                raise IndexError("Index out of range")
            if key < 0:
                # To support negative values
                key += nrows
            start, stop, step = table._process_range(key, key + 1, 1)
        elif isinstance(key, slice):
            start, stop, step = table._process_range(
                key.start, key.stop, key.step
            )
        else:
            raise TypeError(f"invalid index or slice: {key!r}")

        # Actually modify the correct columns
        colgroup = self._v_desc._v_pathname
        if colgroup == "":  # The root group
            table.modify_rows(start, stop, step, rows=value)
        else:
            table.modify_column(
                start, stop, step, colname=colgroup, column=value
            )

    def _g_close(self) -> None:
        # First, close the columns (ie possible indices open)