#include <numpy.h>

Inheritance diagram for array:

[legend]

Public Types
enum	{ c_style = detail::npy_api::NPY_ARRAY_C_CONTIGUOUS_, f_style = detail::npy_api::NPY_ARRAY_F_CONTIGUOUS_, forcecast = detail::npy_api::NPY_ARRAY_FORCECAST_ }

using	ShapeContainer = detail::any_container< ssize_t >

using	StridesContainer = detail::any_container< ssize_t >

Public Member Functions
	array ()

	array (const buffer_info &info, handle base=handle())

	array (const pybind11::dtype &dt, ShapeContainer shape, const void *ptr=nullptr, handle base=handle())

	array (const pybind11::dtype &dt, ShapeContainer shape, StridesContainer strides, const void *ptr=nullptr, handle base=handle())

template<typename T , typename = detail::enable_if_t<std::is_integral<T>::value && !std::is_same<bool, T>::value>>
	array (const pybind11::dtype &dt, T count, const void *ptr=nullptr, handle base=handle())

template<typename T >
	array (ShapeContainer shape, const T *ptr, handle base=handle())

template<typename T >
	array (ShapeContainer shape, StridesContainer strides, const T *ptr, handle base=handle())

template<typename T >
	array (ssize_t count, const T *ptr, handle base=handle())

object	base () const
	Base object. More...

template<typename... Ix>
const void *	data (Ix... index) const

pybind11::dtype	dtype () const
	Array descriptor (dtype) More...

int	flags () const
	Return the NumPy array flags. More...

template<typename... Ix>
ssize_t	index_at (Ix... index) const

ssize_t	itemsize () const
	Byte size of a single element. More...

template<typename... Ix>
void *	mutable_data (Ix... index)

template<typename T , ssize_t Dims = -1>
detail::unchecked_mutable_reference< T, Dims >	mutable_unchecked () &

ssize_t	nbytes () const
	Total number of bytes. More...

ssize_t	ndim () const
	Number of dimensions. More...

ssize_t	offset_at () const

template<typename... Ix>
ssize_t	offset_at (Ix... index) const

bool	owndata () const
	If set, the array owns the data (will be freed when the array is deleted) More...

array	reshape (ShapeContainer new_shape)
	Optional `order` parameter omitted, to be added as needed. More...

void	resize (ShapeContainer new_shape, bool refcheck=true)

const ssize_t *	shape () const
	Dimensions of the array. More...

ssize_t	shape (ssize_t dim) const
	Dimension along a given axis. More...

ssize_t	size () const
	Total number of elements. More...

array	squeeze ()
	Return a new view with all of the dimensions of length 1 removed. More...

const ssize_t *	strides () const
	Strides of the array. More...

ssize_t	strides (ssize_t dim) const
	Stride along a given axis. More...

template<typename T , ssize_t Dims = -1>
detail::unchecked_reference< T, Dims >	unchecked () const &

array	view (const std::string &dtype)

bool	writeable () const
	If set, the array is writeable (otherwise the buffer is read-only) More...

Public Member Functions inherited from buffer
buffer_info	request (bool writable=false) const

Public Member Functions inherited from object
template<typename T >
T	cast () &&

template<typename T >
T	cast () const &

template<>
void	cast () const &

	object ()=default

	object (const object &o)
	Copy constructor; always increases the reference count. More...

	object (handle h, borrowed_t)

	object (handle h, stolen_t)

	object (object &&other) noexcept
	Move constructor; steals the object from `other` and preserves its reference count. More...

object &	operator= (const object &other)

object &	operator= (object &&other) noexcept

	PYBIND11_DEPRECATED ("Use reinterpret_borrow<object>() or reinterpret_steal<object>()") object(handle h

handle	release ()

	~object ()
	Destructor; automatically calls `handle::dec_ref()` More...

Public Member Functions inherited from handle
template<typename T >
T	cast () const

template<>
void	cast () const

bool	check () const

const handle &	dec_ref () const &

	handle ()=default
	The default constructor creates a handle with a `nullptr`-valued pointer. More...

template<typename T , detail::enable_if_t< detail::all_of< detail::none_of< std::is_base_of< handle, T >, detail::is_pyobj_ptr_or_nullptr_t< T >>, std::is_convertible< T, PyObject * >>::value, int > = 0>
	handle (T &obj)
	Enable implicit conversion through `T::operator PyObject *()`. More...

template<typename T , detail::enable_if_t< detail::is_pyobj_ptr_or_nullptr_t< T >::value, int > = 0>
	handle (T ptr)

const handle &	inc_ref () const &

	operator bool () const
	Return `true` when the `handle` wraps a valid Python object. More...

bool	operator!= (const handle &h) const

bool	operator== (const handle &h) const

PyObject *&	ptr ()

PyObject *	ptr () const
	Return the underlying `PyObject *` pointer. More...

Static Public Member Functions
static array	ensure (handle h, int ExtraFlags=0)

Static Public Member Functions inherited from handle
static std::size_t	inc_ref_counter ()

Protected Member Functions
template<typename... Ix>
ssize_t	byte_offset (Ix... index) const

template<typename... Ix>
void	check_dimensions (Ix... index) const

template<typename... Ix>
void	check_dimensions_impl (ssize_t axis, const ssize_t *shape, ssize_t i, Ix... index) const

void	check_dimensions_impl (ssize_t, const ssize_t *) const

void	check_writeable () const

void	fail_dim_check (ssize_t dim, const std::string &msg) const

Static Protected Member Functions
static PyObject *	raw_array (PyObject *ptr, int ExtraFlags=0)
	Create array from any object – always returns a new reference. More...

Friends
template<typename , typename >
struct	detail::npy_format_descriptor

Additional Inherited Members
Public Attributes inherited from object
bool	is_borrowed: handle(h) { if (is_borrowed) { inc_ref()

Protected Attributes inherited from handle
PyObject *	m_ptr = nullptr

Detailed Description

Definition at line 684 of file numpy.h.

Member Typedef Documentation

◆ ShapeContainer

using array::ShapeContainer = detail::any_container<ssize_t>

Definition at line 696 of file numpy.h.

◆ StridesContainer

using array::StridesContainer = detail::any_container<ssize_t>

Definition at line 697 of file numpy.h.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
c_style
f_style
forcecast

Definition at line 688 of file numpy.h.

Constructor & Destructor Documentation

◆ array() [1/8]

array::array ( )

inline

Definition at line 694 of file numpy.h.

◆ array() [2/8]

array::array	(	const pybind11::dtype &	dt,
		ShapeContainer	shape,
		StridesContainer	strides,
		const void *	ptr = `nullptr`,
		handle	base = `handle()`
	)

inline

Definition at line 700 of file numpy.h.

◆ array() [3/8]

array::array	(	const pybind11::dtype &	dt,
		ShapeContainer	shape,
		const void *	ptr = `nullptr`,
		handle	base = `handle()`
	)

inline

Definition at line 753 of file numpy.h.

◆ array() [4/8]

template<typename T , typename = detail::enable_if_t<std::is_integral<T>::value && !std::is_same<bool, T>::value>>

array::array	(	const pybind11::dtype &	dt,
		T	count,
		const void *	ptr = `nullptr`,
		handle	base = `handle()`
	)

inline

Definition at line 762 of file numpy.h.

◆ array() [5/8]

template<typename T >

array::array	(	ShapeContainer	shape,
		StridesContainer	strides,
		const T *	ptr,
		handle	base = `handle()`
	)

inline

Definition at line 766 of file numpy.h.

◆ array() [6/8]

template<typename T >

array::array	(	ShapeContainer	shape,
		const T *	ptr,
		handle	base = `handle()`
	)

inline

Definition at line 770 of file numpy.h.

◆ array() [7/8]

template<typename T >

array::array	(	ssize_t	count,
		const T *	ptr,
		handle	base = `handle()`
	)

inlineexplicit

Definition at line 774 of file numpy.h.

◆ array() [8/8]

array::array	(	const buffer_info &	info,
		handle	base = `handle()`
	)

inlineexplicit

Definition at line 777 of file numpy.h.

Member Function Documentation

◆ base()

object array::base ( ) const

inline

Base object.

Definition at line 802 of file numpy.h.

◆ byte_offset()

template<typename... Ix>

ssize_t array::byte_offset ( Ix... index ) const

inlineprotected

Definition at line 980 of file numpy.h.

◆ check_dimensions()

template<typename... Ix>

void array::check_dimensions ( Ix... index ) const

inlineprotected

Definition at line 992 of file numpy.h.

◆ check_dimensions_impl() [1/2]

template<typename... Ix>

void array::check_dimensions_impl	(	ssize_t	axis,
		const ssize_t *	shape,
		ssize_t	i,
		Ix...	index
	)		const

inlineprotected

Definition at line 999 of file numpy.h.

◆ check_dimensions_impl() [2/2]

void array::check_dimensions_impl	(	ssize_t	,
		const ssize_t *
	)		const

inlineprotected

Definition at line 996 of file numpy.h.

◆ check_writeable()

void array::check_writeable ( ) const

inlineprotected

Definition at line 985 of file numpy.h.

◆ data()

template<typename... Ix>

const void* array::data ( Ix... index ) const

inline

Pointer to the contained data. If index is not provided, points to the beginning of the buffer. May throw if the index would lead to out of bounds access.

Definition at line 842 of file numpy.h.

◆ dtype()

pybind11::dtype array::dtype ( ) const

inline

Array descriptor (dtype)

Definition at line 781 of file numpy.h.

◆ ensure()

static array array::ensure	(	handle	h,
		int	ExtraFlags = `0`
	)

inlinestatic

Ensure that the argument is a NumPy array In case of an error, nullptr is returned and the Python error is cleared.

Definition at line 962 of file numpy.h.

◆ fail_dim_check()

void array::fail_dim_check	(	ssize_t	dim,
		const std::string &	msg
	)		const

inlineprotected

Definition at line 974 of file numpy.h.

◆ flags()

int array::flags ( ) const

inline

Return the NumPy array flags.

Definition at line 827 of file numpy.h.

◆ index_at()

template<typename... Ix>

ssize_t array::index_at ( Ix... index ) const

inline

Item count from beginning of the array to a given index (full or partial). May throw if the index would lead to out of bounds access.

Definition at line 870 of file numpy.h.

◆ itemsize()

ssize_t array::itemsize ( ) const

inline

Byte size of a single element.

Definition at line 791 of file numpy.h.

◆ mutable_data()

template<typename... Ix>

void* array::mutable_data ( Ix... index )

inline

Mutable pointer to the contained data. If index is not provided, points to the beginning of the buffer. May throw if the index would lead to out of bounds access. May throw if the array is not writeable.

Definition at line 850 of file numpy.h.

◆ mutable_unchecked()

template<typename T , ssize_t Dims = -1>

detail::unchecked_mutable_reference<T, Dims> array::mutable_unchecked ( ) &

inline

Returns a proxy object that provides access to the array's data without bounds or dimensionality checking. Will throw if the array is missing the writeable flag. Use with care: the array must not be destroyed or reshaped for the duration of the returned object, and the caller must take care not to access invalid dimensions or dimension indices.

Definition at line 881 of file numpy.h.

◆ nbytes()

ssize_t array::nbytes ( ) const

inline

Total number of bytes.

Definition at line 796 of file numpy.h.

◆ ndim()

ssize_t array::ndim ( ) const

inline

Number of dimensions.

Definition at line 799 of file numpy.h.

◆ offset_at() [1/2]

ssize_t array::offset_at ( ) const

inline

Definition at line 865 of file numpy.h.

◆ offset_at() [2/2]

template<typename... Ix>

ssize_t array::offset_at ( Ix... index ) const

inline

Byte offset from beginning of the array to a given index (full or partial). May throw if the index would lead to out of bounds access.

Definition at line 858 of file numpy.h.

◆ owndata()

bool array::owndata ( ) const

inline

If set, the array owns the data (will be freed when the array is deleted)

Definition at line 835 of file numpy.h.

◆ raw_array()

static PyObject* array::raw_array	(	PyObject *	ptr,
		int	ExtraFlags = `0`
	)

inlinestaticprotected

Create array from any object – always returns a new reference.

Definition at line 1009 of file numpy.h.

◆ reshape()

array array::reshape ( ShapeContainer new_shape )

inline

Optional order parameter omitted, to be added as needed.

Definition at line 934 of file numpy.h.

◆ resize()

void array::resize	(	ShapeContainer	new_shape,
		bool	refcheck = `true`
	)

inline

Resize array to given shape If refcheck is true and more that one reference exist to this array then resize will succeed only if it makes a reshape, i.e. original size doesn't change

Definition at line 917 of file numpy.h.

◆ shape() [1/2]

const ssize_t* array::shape ( ) const

inline

Dimensions of the array.

Definition at line 805 of file numpy.h.

◆ shape() [2/2]

ssize_t array::shape ( ssize_t dim ) const

inline

Dimension along a given axis.

Definition at line 808 of file numpy.h.

◆ size()

ssize_t array::size ( ) const

inline

Total number of elements.

Definition at line 786 of file numpy.h.

◆ squeeze()

array array::squeeze ( )

inline

Return a new view with all of the dimensions of length 1 removed.

Definition at line 909 of file numpy.h.

◆ strides() [1/2]

const ssize_t* array::strides ( ) const

inline

Strides of the array.

Definition at line 816 of file numpy.h.

◆ strides() [2/2]

ssize_t array::strides ( ssize_t dim ) const

inline

Stride along a given axis.

Definition at line 819 of file numpy.h.

◆ unchecked()

template<typename T , ssize_t Dims = -1>

detail::unchecked_reference<T, Dims> array::unchecked ( ) const &

inline

Returns a proxy object that provides const access to the array's data without bounds or dimensionality checking. Unlike mutable_unchecked(), this does not require that the underlying array have the writable flag. Use with care: the array must not be destroyed or reshaped for the duration of the returned object, and the caller must take care not to access invalid dimensions or dimension indices.

Definition at line 899 of file numpy.h.

◆ view()

array array::view ( const std::string & dtype )

inline

Create a view of an array in a different data type. This function may fundamentally reinterpret the data in the array. It is the responsibility of the caller to ensure that this is safe. Only supports the dtype argument, the type argument is omitted, to be added as needed.

Definition at line 950 of file numpy.h.

◆ writeable()

bool array::writeable ( ) const

inline

If set, the array is writeable (otherwise the buffer is read-only)

Definition at line 830 of file numpy.h.

Friends And Related Function Documentation

◆ detail::npy_format_descriptor

template<typename , typename >

friend struct detail::npy_format_descriptor

friend

Definition at line 972 of file numpy.h.

The documentation for this class was generated from the following file:

numpy.h

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Static Protected Member Functions

Friends

Additional Inherited Members

Detailed Description

Member Typedef Documentation

◆ ShapeContainer

◆ StridesContainer

Member Enumeration Documentation

◆ anonymous enum

Constructor & Destructor Documentation

◆ array() [1/8]

◆ array() [2/8]

◆ array() [3/8]

◆ array() [4/8]

◆ array() [5/8]

◆ array() [6/8]

◆ array() [7/8]

◆ array() [8/8]

Member Function Documentation

◆ base()

◆ byte_offset()

◆ check_dimensions()

◆ check_dimensions_impl() [1/2]

◆ check_dimensions_impl() [2/2]

◆ check_writeable()

◆ data()

◆ dtype()

◆ ensure()

◆ fail_dim_check()

◆ flags()

◆ index_at()

◆ itemsize()

◆ mutable_data()

◆ mutable_unchecked()

◆ nbytes()

◆ ndim()

◆ offset_at() [1/2]

◆ offset_at() [2/2]

◆ owndata()

◆ raw_array()

◆ reshape()

◆ resize()

◆ shape() [1/2]

◆ shape() [2/2]

◆ size()

◆ squeeze()

◆ strides() [1/2]

◆ strides() [2/2]

◆ unchecked()

◆ view()

◆ writeable()

Friends And Related Function Documentation

◆ detail::npy_format_descriptor