Scarab  v2.9.1
Project 8 C++ Utility Library
Classes | Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Static Protected Member Functions | Private Member Functions | List of all members
array_t< T, ExtraFlags > Class Template Reference

#include <numpy.h>

Inheritance diagram for array_t< T, ExtraFlags >:
Inheritance graph

Classes

struct  private_ctor
 

Public Types

using value_type = T
 
- Public Types inherited from array
using ShapeContainer = detail::any_container< ssize_t >
 
using StridesContainer = detail::any_container< ssize_t >
 

Public Member Functions

 array_t ()
 
 array_t (handle h, borrowed_t)
 
 array_t (handle h, stolen_t)
 
 __attribute__ ((deprecated("Use array_t<T>::ensure() instead"))) array_t(handle h
 
bool Dims mutable_unchecked () &
 
template<ssize_t Dims = -1>
detail::unchecked_reference< T, Dims > unchecked () const &
 
- Public Member Functions inherited from array
 __attribute__ ((deprecated("Use reinterpret_borrow<""array"">() or reinterpret_steal<""array"">()"))) array(handle h
 
 array ()
 
 array (const pybind11::dtype &dt, ShapeContainer shape, StridesContainer strides, const void *ptr=nullptr, handle base=handle())
 
 array (const pybind11::dtype &dt, ShapeContainer shape, 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, StridesContainer strides, const T *ptr, handle base=handle())
 
template<typename T >
 array (ShapeContainer shape, const T *ptr, handle base=handle())
 
template<typename T >
 array (ssize_t count, const T *ptr, handle base=handle())
 
 array (const buffer_info &info)
 
pybind11::dtype dtype () const
 Array descriptor (dtype) More...
 
ssize_t size () const
 Total number of elements. More...
 
ssize_t itemsize () const
 Byte size of a single element. More...
 
ssize_t nbytes () const
 Total number of bytes. More...
 
ssize_t ndim () const
 Number of dimensions. More...
 
object base () const
 Base object. More...
 
const ssize_tshape () const
 Dimensions of the array. More...
 
ssize_t shape (ssize_t dim) const
 Dimension along a given axis. More...
 
const ssize_tstrides () const
 Strides of the array. More...
 
ssize_t strides (ssize_t dim) const
 Stride along a given axis. More...
 
int flags () const
 Return the NumPy array flags. More...
 
bool writeable () const
 If set, the array is writeable (otherwise the buffer is read-only) More...
 
bool owndata () const
 If set, the array owns the data (will be freed when the array is deleted) More...
 
template<typename... Ix>
const void * data (Ix... index) const
 
template<typename... Ix>
void * mutable_data (Ix... index)
 
template<typename... Ix>
ssize_t offset_at (Ix... index) const
 
ssize_t offset_at () const
 
template<typename... Ix>
ssize_t index_at (Ix... index) const
 
template<typename T , ssize_t Dims = -1>
detail::unchecked_mutable_reference< T, Dims > mutable_unchecked () &
 
template<typename T , ssize_t Dims = -1>
detail::unchecked_reference< T, Dims > unchecked () const &
 
array squeeze ()
 Return a new view with all of the dimensions of length 1 removed. More...
 
void resize (ShapeContainer new_shape, bool refcheck=true)
 
- Public Member Functions inherited from buffer
 __attribute__ ((deprecated("Use reinterpret_borrow<""buffer"">() or reinterpret_steal<""buffer"">()"))) buffer(handle h
 
- Public Member Functions inherited from object
 object ()=default
 
 __attribute__ ((deprecated("Use reinterpret_borrow<object>() or reinterpret_steal<object>()"))) object(handle h
 
 object (const object &o)
 Copy constructor; always increases the reference count. More...
 
 object (object &&other) noexcept
 Move constructor; steals the object from other and preserves its reference count. More...
 
 ~object ()
 Destructor; automatically calls handle::dec_ref() More...
 
handle release ()
 
objectoperator= (const object &other)
 
objectoperator= (object &&other) noexcept
 
template<typename T >
cast () const &
 
template<typename T >
cast () &&
 
 object (handle h, borrowed_t)
 
 object (handle h, stolen_t)
 
template<typename T >
cast () const &
 
template<typename T >
cast () &&
 
template<>
void cast () const &
 
template<>
void cast () &&
 
- Public Member Functions inherited from handle
 handle ()=default
 The default constructor creates a handle with a nullptr-valued pointer. More...
 
 handle (PyObject *ptr)
 Creates a handle from the given raw Python object pointer. More...
 
PyObject * ptr () const
 Return the underlying PyObject * pointer. More...
 
PyObject *& ptr ()
 
const handleinc_ref () const &
 
const handledec_ref () const &
 
template<typename T >
cast () const
 
 operator bool () const
 Return true when the handle wraps a valid Python object. More...
 
 __attribute__ ((deprecated("Use obj1.is(obj2) instead"))) bool operator
 
template<>
void cast () const
 
- Public Member Functions inherited from object_api< handle >
iterator begin () const
 
iterator end () const
 Return a sentinel which ends iteration. More...
 
item_accessor operator[] (handle key) const
 
item_accessor operator[] (const char *key) const
 See above (the only difference is that they key is provided as a string literal) More...
 
obj_attr_accessor attr (handle key) const
 
str_attr_accessor attr (const char *key) const
 See above (the only difference is that they key is provided as a string literal) More...
 
args_proxy operator* () const
 
object operator* (object_api const &other) const
 
bool contains (T &&item) const
 Check if the given item is contained within this object, i.e. item in obj. More...
 
object operator() (Args &&...args) const
 
 __attribute__ ((deprecated("call(...) was deprecated in favor of operator()(...)"))) object call(Args &&... args) const
 Get or set the object's docstring, i.e. obj.__doc__. More...
 
bool is (object_api const &other) const
 Equivalent to obj is other in Python. More...
 
bool is_none () const
 Equivalent to obj is None in Python. More...
 
bool equal (object_api const &other) const
 Equivalent to obj == other in Python. More...
 
bool not_equal (object_api const &other) const
 
bool operator< (object_api const &other) const
 
bool operator<= (object_api const &other) const
 
bool operator> (object_api const &other) const
 
bool operator>= (object_api const &other) const
 
object operator- () const
 
object operator- (object_api const &other) const
 
object operator~ () const
 
object operator+ (object_api const &other) const
 
object operator+= (object_api const &other) const
 
object operator-= (object_api const &other) const
 
object operator*= (object_api const &other) const
 
object operator/ (object_api const &other) const
 
object operator/= (object_api const &other) const
 
object operator| (object_api const &other) const
 
object operator|= (object_api const &other) const
 
object operator& (object_api const &other) const
 
object operator&= (object_api const &other) const
 
object operator^ (object_api const &other) const
 
object operator^= (object_api const &other) const
 
object operator<< (object_api const &other) const
 
object operator<<= (object_api const &other) const
 
object operator>> (object_api const &other) const
 
object operator>>= (object_api const &other) const
 
int ref_count () const
 Return the object's current reference count. More...
 
handle get_type () const
 Return a handle to the Python type object underlying the instance. More...
 

Static Public Member Functions

static array_t ensure (handle h)
 
static bool check_ (handle h)
 
- Static Public Member Functions inherited from array
static array ensure (handle h, int ExtraFlags=0)
 

Public Attributes

bool is_borrowed: array(raw_array_t(h.ptr())
 
bool stolen_t
 
- Public Attributes inherited from array
bool is_borrowed: buffer (is_borrowed ? buffer (h
 
bool borrowed_t
 
- Public Attributes inherited from buffer
bool is_borrowed: object (is_borrowed ? object (h
 
- Public Attributes inherited from object
bool is_borrowed: handle(h) { if (is_borrowed) inc_ref()
 

Static Protected Member Functions

static PyObject * raw_array_t (PyObject *ptr)
 Create array from any object – always returns a new reference. More...
 
- Static Protected Member Functions inherited from array
static std::vector< ssize_tc_strides (const std::vector< ssize_t > &shape, ssize_t itemsize)
 
static std::vector< ssize_tf_strides (const std::vector< ssize_t > &shape, ssize_t itemsize)
 
static PyObject * raw_array (PyObject *ptr, int ExtraFlags=0)
 Create array from any object – always returns a new reference. More...
 

Private Member Functions

 array_t (private_ctor, ShapeContainer &&shape, StridesContainer &&strides, const T *ptr, handle base)
 

Additional Inherited Members

- Protected Member Functions inherited from array
void fail_dim_check (ssize_t dim, const std::string &msg) const
 
template<typename... Ix>
ssize_t byte_offset (Ix... index) const
 
void check_writeable () const
 
template<typename... Ix>
void check_dimensions (Ix... index) const
 
void check_dimensions_impl (ssize_t, const ssize_t *) const
 
template<typename... Ix>
void check_dimensions_impl (ssize_t axis, const ssize_t *shape, ssize_t i, Ix... index) const
 

Detailed Description

template<typename T, int ExtraFlags = array::forcecast>
class pybind11::array_t< T, ExtraFlags >

Definition at line 831 of file numpy.h.

Member Typedef Documentation

◆ value_type

using value_type = T

Definition at line 840 of file numpy.h.

Constructor & Destructor Documentation

◆ array_t() [1/4]

array_t ( private_ctor  ,
ShapeContainer &&  shape,
StridesContainer &&  strides,
const T *  ptr,
handle  base 
)
inlineprivate

Definition at line 835 of file numpy.h.

◆ array_t() [2/4]

array_t ( )
inline

Definition at line 842 of file numpy.h.

◆ array_t() [3/4]

array_t ( handle  h,
borrowed_t   
)
inline

Definition at line 843 of file numpy.h.

◆ array_t() [4/4]

array_t ( handle  h,
stolen_t   
)
inline

Definition at line 844 of file numpy.h.

Member Function Documentation

◆ __attribute__()

__attribute__ ( (deprecated("Use array_t<T>::ensure() instead"))  )

◆ check_()

static bool check_ ( handle  h)
inlinestatic

Definition at line 929 of file numpy.h.

◆ ensure()

static array_t ensure ( handle  h)
inlinestatic

Ensure that the argument is a NumPy array of the correct dtype (and if not, try to convert it). In case of an error, nullptr is returned and the Python error is cleared.

Definition at line 922 of file numpy.h.

◆ mutable_unchecked()

bool Dims mutable_unchecked ( ) &
inline

Definition at line 905 of file numpy.h.

◆ raw_array_t()

static PyObject* raw_array_t ( PyObject *  ptr)
inlinestaticprotected

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

Definition at line 937 of file numpy.h.

◆ unchecked()

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

Returns a proxy object that provides const access to the array's data without bounds or dimensionality checking. Unlike 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 916 of file numpy.h.

Member Data Documentation

◆ is_borrowed

bool is_borrowed

Definition at line 847 of file numpy.h.

◆ stolen_t

bool stolen_t

Definition at line 847 of file numpy.h.


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