numpy.full#
- numpy.full(shape, fill_value, dtype=None, order='C', *, device=None, like=None)[source]#
Return a new array of given shape and type, filled with fill_value.
- Parameters:
- shapeint or sequence of ints
Shape of the new array, e.g.,
(2, 3)
or2
.- fill_valuescalar or array_like
Fill value.
- dtypedata-type, optional
- The desired data-type for the array The default, None, means
np.array(fill_value).dtype
.
- order{‘C’, ‘F’}, optional
Whether to store multidimensional data in C- or Fortran-contiguous (row- or column-wise) order in memory.
- devicestr, optional
The device on which to place the created array. Default: None. For Array-API interoperability only, so must be
"cpu"
if passed.New in version 2.0.0.
- likearray_like, optional
Reference object to allow the creation of arrays which are not NumPy arrays. If an array-like passed in as
like
supports the__array_function__
protocol, the result will be defined by it. In this case, it ensures the creation of an array object compatible with that passed in via this argument.New in version 1.20.0.
- Returns:
- outndarray
Array of fill_value with the given shape, dtype, and order.
See also
Examples
>>> np.full((2, 2), np.inf) array([[inf, inf], [inf, inf]]) >>> np.full((2, 2), 10) array([[10, 10], [10, 10]])
>>> np.full((2, 2), [1, 2]) array([[1, 2], [1, 2]])