pandas.api.extensions.ExtensionArray.repeat — pandas 2.2.3 documentation (original) (raw)

ExtensionArray.repeat(repeats, axis=None)[source]#

Repeat elements of a ExtensionArray.

Returns a new ExtensionArray where each element of the current ExtensionArray is repeated consecutively a given number of times.

Parameters:

repeatsint or array of ints

The number of repetitions for each element. This should be a non-negative integer. Repeating 0 times will return an empty ExtensionArray.

axisNone

Must be None. Has no effect but is accepted for compatibility with numpy.

Returns:

ExtensionArray

Newly created ExtensionArray with repeated elements.

Examples

cat = pd.Categorical(['a', 'b', 'c']) cat ['a', 'b', 'c'] Categories (3, object): ['a', 'b', 'c'] cat.repeat(2) ['a', 'a', 'b', 'b', 'c', 'c'] Categories (3, object): ['a', 'b', 'c'] cat.repeat([1, 2, 3]) ['a', 'b', 'b', 'c', 'c', 'c'] Categories (3, object): ['a', 'b', 'c']