DOC: Add DataFrame.isetitem method (#57614)

* Add DataFrame.isetitem method * Add See-Also and Examples * Fix orfer * Update pandas/core/frame.py Co-authored-by: Matthew Roeschke <10647082+mroeschke@users.noreply.github.com> --------- Co-authored-by: Matthew Roeschke <10647082+mroeschke@users.noreply.github.com>

Author: luke396

doc/source/reference/frame.rst

@@ -74,6 +74,7 @@ Indexing, iteration
  DataFrame.where
  DataFrame.mask
  DataFrame.query
+ DataFrame.isetitem
 
 For more information on ``.at``, ``.iat``, ``.loc``, and
 ``.iloc``, see the :ref:`indexing documentation <indexing>`.

pandas/core/frame.py

@@ -4018,6 +4018,11 @@ def isetitem(self, loc, value) -> None:
  value : scalar or arraylike
  Value(s) for the column.
 
+ See Also
+ --------
+ DataFrame.iloc : Purely integer-location based indexing for selection by
+ position.
+
  Notes
  -----
  ``frame.isetitem(loc, value)`` is an in-place method as it will
@@ -4028,6 +4033,15 @@ def isetitem(self, loc, value) -> None:
 
  In cases where ``frame.columns`` is unique, this is equivalent to
  ``frame[frame.columns[i]] = value``.
+
+ Examples
+ --------
+ >>> df = pd.DataFrame({"A": [1, 2], "B": [3, 4]})
+ >>> df.isetitem(1, [5, 6])
+ >>> df
+ A B
+ 0 1 5
+ 1 2 6
  """
  if isinstance(value, DataFrame):
  if is_integer(loc):