Insert values along the given axis before the given indices and return a new ~astropy.table.MaskedColumn object.

Parameters¶

objint, slice or sequence of int

Object that defines the index or indices before which values is inserted.

valuesarray-like

Value(s) to insert. If the type of values is different from that of the column, values is converted to the matching type. values should be shaped so that it can be broadcast appropriately.

maskbool or array-like

Mask value(s) to insert. If not supplied, and values does not have a mask either, then False is used.

axisint, optional

Axis along which to insert values. If axis is None then the column array is flattened before insertion. Default is 0, which will insert a row.

Returns¶

out~astropy.table.MaskedColumn

A copy of column with values and mask inserted. Note that the insertion does not occur in-place: a new masked column is returned.