diff --git a/pandas/core/frame.py b/pandas/core/frame.py index f710660d6ad8e..2f5736be8f604 100644 --- a/pandas/core/frame.py +++ b/pandas/core/frame.py @@ -3752,6 +3752,28 @@ def insert(self, loc, column, value, allow_duplicates=False) -> None: Label of the inserted column. value : int, Series, or array-like allow_duplicates : bool, optional + + See Also + -------- + Index.insert : Insert new item by index. + + Examples + -------- + >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]}) + >>> df + col1 col2 + 0 1 3 + 1 2 4 + >>> df.insert(1, "newcol", [99, 99]) + >>> df + col1 newcol col2 + 0 1 99 3 + 1 2 99 4 + >>> df.insert(0, "col1", [100, 100], allow_duplicates=True) + >>> df + col1 col1 newcol col2 + 0 100 1 99 3 + 1 100 2 99 4 """ if allow_duplicates and not self.flags.allows_duplicate_labels: raise ValueError(