/*[clinic input]

preserve

[clinic start generated code]*/

#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

#  include "pycore_gc.h"          // PyGC_Head

#  include "pycore_runtime.h"     // _Py_ID()

#endif

#include "pycore_abstract.h"      // _PyNumber_Index()

#include "pycore_modsupport.h"    // _PyArg_UnpackKeywords()

#include "pycore_unicodeobject.h" // _PyUnicode_AsUTF8NoNUL()

PyDoc_STRVAR(memoryview__doc__,

"memoryview(object)\n"

"--\n"

"\n"

"Create a new memoryview object which references the given object.");

static PyObject *

memoryview_impl(PyTypeObject *type, PyObject *object);

static PyObject *

memoryview(PyTypeObject *type, PyObject *args, PyObject *kwargs)

{

    PyObject *return_value = NULL;

    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

    #define NUM_KEYWORDS 1

    static struct {

        PyGC_Head _this_is_not_used;

        PyObject_VAR_HEAD

        Py_hash_t ob_hash;

        PyObject *ob_item[NUM_KEYWORDS];

    } _kwtuple = {

        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)

        .ob_hash = -1,

        .ob_item = { &_Py_ID(object), },

    };

    #undef NUM_KEYWORDS

    #define KWTUPLE (&_kwtuple.ob_base.ob_base)

    #else  // !Py_BUILD_CORE

    #  define KWTUPLE NULL

    #endif  // !Py_BUILD_CORE

    static const char * const _keywords[] = {"object", NULL};

    static _PyArg_Parser _parser = {

        .keywords = _keywords,

        .fname = "memoryview",

        .kwtuple = KWTUPLE,

    };

    #undef KWTUPLE

    PyObject *argsbuf[1];

    PyObject * const *fastargs;

    Py_ssize_t nargs = PyTuple_GET_SIZE(args);

    PyObject *object;

    fastargs = _PyArg_UnpackKeywords(_PyTuple_CAST(args)->ob_item, nargs, kwargs, NULL, &_parser,

            /*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);

    if (!fastargs) {

        goto exit;

    }

    object = fastargs[0];

    return_value = memoryview_impl(type, object);

exit:

    return return_value;

}

PyDoc_STRVAR(memoryview__from_flags__doc__,

"_from_flags($type, /, object, flags)\n"

"--\n"

"\n"

"Create a new memoryview object which references the given object.");

#define MEMORYVIEW__FROM_FLAGS_METHODDEF    \

    {"_from_flags", _PyCFunction_CAST(memoryview__from_flags), METH_FASTCALL|METH_KEYWORDS|METH_CLASS, memoryview__from_flags__doc__},

static PyObject *

memoryview__from_flags_impl(PyTypeObject *type, PyObject *object, int flags);

static PyObject *

memoryview__from_flags(PyObject *type, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)

{

    PyObject *return_value = NULL;

    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

    #define NUM_KEYWORDS 2

    static struct {

        PyGC_Head _this_is_not_used;

        PyObject_VAR_HEAD

        Py_hash_t ob_hash;

        PyObject *ob_item[NUM_KEYWORDS];

    } _kwtuple = {

        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)

        .ob_hash = -1,

        .ob_item = { &_Py_ID(object), &_Py_ID(flags), },

    };

    #undef NUM_KEYWORDS

    #define KWTUPLE (&_kwtuple.ob_base.ob_base)

    #else  // !Py_BUILD_CORE

    #  define KWTUPLE NULL

    #endif  // !Py_BUILD_CORE

    static const char * const _keywords[] = {"object", "flags", NULL};

    static _PyArg_Parser _parser = {

        .keywords = _keywords,

        .fname = "_from_flags",

        .kwtuple = KWTUPLE,

    };

    #undef KWTUPLE

    PyObject *argsbuf[2];

    PyObject *object;

    int flags;

    args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,

            /*minpos*/ 2, /*maxpos*/ 2, /*minkw*/ 0, /*varpos*/ 0, argsbuf);

    if (!args) {

        goto exit;

    }

    object = args[0];

    flags = PyLong_AsInt(args[1]);

    if (flags == -1 && PyErr_Occurred()) {

        goto exit;

    }

    return_value = memoryview__from_flags_impl((PyTypeObject *)type, object, flags);

exit:

    return return_value;

}

PyDoc_STRVAR(memoryview_release__doc__,

"release($self, /)\n"

"--\n"

"\n"

"Release the underlying buffer exposed by the memoryview object.");

#define MEMORYVIEW_RELEASE_METHODDEF    \

    {"release", (PyCFunction)memoryview_release, METH_NOARGS, memoryview_release__doc__},

static PyObject *

memoryview_release_impl(PyMemoryViewObject *self);

static PyObject *

memoryview_release(PyObject *self, PyObject *Py_UNUSED(ignored))

{

    return memoryview_release_impl((PyMemoryViewObject *)self);

}

PyDoc_STRVAR(memoryview___exit____doc__,

"__exit__($self, /, *exc_info)\n"

"--\n"

"\n"

"Release the underlying buffer exposed by the memoryview object.");

#define MEMORYVIEW___EXIT___METHODDEF    \

    {"__exit__", _PyCFunction_CAST(memoryview___exit__), METH_FASTCALL, memoryview___exit____doc__},

static PyObject *

memoryview___exit___impl(PyMemoryViewObject *self,

                         PyObject * const *exc_info,

                         Py_ssize_t exc_info_length);

static PyObject *

memoryview___exit__(PyObject *self, PyObject *const *args, Py_ssize_t nargs)

{

    PyObject *return_value = NULL;

    PyObject * const *exc_info;

    Py_ssize_t exc_info_length;

    exc_info = args;

    exc_info_length = nargs;

    return_value = memoryview___exit___impl((PyMemoryViewObject *)self, exc_info, exc_info_length);

    return return_value;

}

PyDoc_STRVAR(memoryview_cast__doc__,

"cast($self, /, format, shape=<unrepresentable>, *, order=\'C\')\n"

"--\n"

"\n"

"Cast a memoryview to a new format or shape.\n"

"\n"

"With a multidimensional *shape*, *order* selects the result\n"

"layout: \'C\' for C-contiguous (row-major, the default) or \'F\'\n"

"for Fortran-contiguous (column-major).");

#define MEMORYVIEW_CAST_METHODDEF    \

    {"cast", _PyCFunction_CAST(memoryview_cast), METH_FASTCALL|METH_KEYWORDS, memoryview_cast__doc__},

static PyObject *

memoryview_cast_impl(PyMemoryViewObject *self, PyObject *format,

                     PyObject *shape, int order);

static PyObject *

memoryview_cast(PyObject *self, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)

{

    PyObject *return_value = NULL;

    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

    #define NUM_KEYWORDS 3

    static struct {

        PyGC_Head _this_is_not_used;

        PyObject_VAR_HEAD

        Py_hash_t ob_hash;

        PyObject *ob_item[NUM_KEYWORDS];

    } _kwtuple = {

        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)

        .ob_hash = -1,

        .ob_item = { &_Py_ID(format), &_Py_ID(shape), &_Py_ID(order), },

    };

    #undef NUM_KEYWORDS

    #define KWTUPLE (&_kwtuple.ob_base.ob_base)

    #else  // !Py_BUILD_CORE

    #  define KWTUPLE NULL

    #endif  // !Py_BUILD_CORE

    static const char * const _keywords[] = {"format", "shape", "order", NULL};

    static _PyArg_Parser _parser = {

        .keywords = _keywords,

        .fname = "cast",

        .kwtuple = KWTUPLE,

    };

    #undef KWTUPLE

    PyObject *argsbuf[3];

    Py_ssize_t noptargs = nargs + (kwnames ? PyTuple_GET_SIZE(kwnames) : 0) - 1;

    PyObject *format;

    PyObject *shape = NULL;

    int order = 'C';

    args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,

            /*minpos*/ 1, /*maxpos*/ 2, /*minkw*/ 0, /*varpos*/ 0, argsbuf);

    if (!args) {

        goto exit;

    }

    if (!PyUnicode_Check(args[0])) {

        _PyArg_BadArgument("cast", "argument 'format'", "str", args[0]);

        goto exit;

    }

    format = args[0];

    if (!noptargs) {

        goto skip_optional_pos;

    }

    if (args[1]) {

        shape = args[1];

        if (!--noptargs) {

            goto skip_optional_pos;

        }

    }

skip_optional_pos:

    if (!noptargs) {

        goto skip_optional_kwonly;

    }

    if (!PyUnicode_Check(args[2])) {

        _PyArg_BadArgument("cast", "argument 'order'", "a unicode character", args[2]);

        goto exit;

    }

    if (PyUnicode_GET_LENGTH(args[2]) != 1) {

        PyErr_Format(PyExc_TypeError,

            "cast(): argument 'order' must be a unicode character, "

            "not a string of length %zd",

            PyUnicode_GET_LENGTH(args[2]));

        goto exit;

    }

    order = PyUnicode_READ_CHAR(args[2], 0);

skip_optional_kwonly:

    return_value = memoryview_cast_impl((PyMemoryViewObject *)self, format, shape, order);

exit:

    return return_value;

}

PyDoc_STRVAR(memoryview_toreadonly__doc__,

"toreadonly($self, /)\n"

"--\n"

"\n"

"Return a readonly version of the memoryview.");

#define MEMORYVIEW_TOREADONLY_METHODDEF    \

    {"toreadonly", (PyCFunction)memoryview_toreadonly, METH_NOARGS, memoryview_toreadonly__doc__},

static PyObject *

memoryview_toreadonly_impl(PyMemoryViewObject *self);

static PyObject *

memoryview_toreadonly(PyObject *self, PyObject *Py_UNUSED(ignored))

{

    return memoryview_toreadonly_impl((PyMemoryViewObject *)self);

}

PyDoc_STRVAR(memoryview_tolist__doc__,

"tolist($self, /)\n"

"--\n"

"\n"

"Return the data in the buffer as a list of elements.");

#define MEMORYVIEW_TOLIST_METHODDEF    \

    {"tolist", (PyCFunction)memoryview_tolist, METH_NOARGS, memoryview_tolist__doc__},

static PyObject *

memoryview_tolist_impl(PyMemoryViewObject *self);

static PyObject *

memoryview_tolist(PyObject *self, PyObject *Py_UNUSED(ignored))

{

    return memoryview_tolist_impl((PyMemoryViewObject *)self);

}

PyDoc_STRVAR(memoryview_tobytes__doc__,

"tobytes($self, /, order=\'C\')\n"

"--\n"

"\n"

"Return the data in the buffer as a byte string.\n"

"\n"

"Order can be {\'C\', \'F\', \'A\'}.  When order is \'C\' or \'F\', the data of\n"

"the original array is converted to C or Fortran order.  For\n"

"contiguous views, \'A\' returns an exact copy of the physical memory.\n"

"In particular, in-memory Fortran order is preserved.  For\n"

"non-contiguous views, the data is converted to C first.  order=None\n"

"is the same as order=\'C\'.");

#define MEMORYVIEW_TOBYTES_METHODDEF    \

    {"tobytes", _PyCFunction_CAST(memoryview_tobytes), METH_FASTCALL|METH_KEYWORDS, memoryview_tobytes__doc__},

static PyObject *

memoryview_tobytes_impl(PyMemoryViewObject *self, const char *order);

static PyObject *

memoryview_tobytes(PyObject *self, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)

{

    PyObject *return_value = NULL;

    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

    #define NUM_KEYWORDS 1

    static struct {

        PyGC_Head _this_is_not_used;

        PyObject_VAR_HEAD

        Py_hash_t ob_hash;

        PyObject *ob_item[NUM_KEYWORDS];

    } _kwtuple = {

        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)

        .ob_hash = -1,

        .ob_item = { &_Py_ID(order), },

    };

    #undef NUM_KEYWORDS

    #define KWTUPLE (&_kwtuple.ob_base.ob_base)

    #else  // !Py_BUILD_CORE

    #  define KWTUPLE NULL

    #endif  // !Py_BUILD_CORE

    static const char * const _keywords[] = {"order", NULL};

    static _PyArg_Parser _parser = {

        .keywords = _keywords,

        .fname = "tobytes",

        .kwtuple = KWTUPLE,

    };

    #undef KWTUPLE

    PyObject *argsbuf[1];

    Py_ssize_t noptargs = nargs + (kwnames ? PyTuple_GET_SIZE(kwnames) : 0) - 0;

    const char *order = NULL;

    args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,

            /*minpos*/ 0, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);

    if (!args) {

        goto exit;

    }

    if (!noptargs) {

        goto skip_optional_pos;

    }

    if (args[0] == Py_None) {

        order = NULL;

    }

    else if (PyUnicode_Check(args[0])) {

        order = _PyUnicode_AsUTF8NoNUL(args[0]);

        if (order == NULL) {

            goto exit;

        }

    }

    else {

        _PyArg_BadArgument("tobytes", "argument 'order'", "str or None", args[0]);

        goto exit;

    }

skip_optional_pos:

    return_value = memoryview_tobytes_impl((PyMemoryViewObject *)self, order);

exit:

    return return_value;

}

PyDoc_STRVAR(memoryview_hex__doc__,

"hex($self, /, sep=<unrepresentable>, bytes_per_sep=1)\n"

"--\n"

"\n"

"Return the data in the buffer as a str of hexadecimal numbers.\n"

"\n"

"  sep\n"

"    An optional single character or byte to separate hex bytes.\n"

"  bytes_per_sep\n"

"    How many bytes between separators.  Positive values count from\n"

"    the right, negative values count from the left.\n"

"\n"

"Example:\n"

">>> value = memoryview(b\'\\xb9\\x01\\xef\')\n"

">>> value.hex()\n"

"\'b901ef\'\n"

">>> value.hex(\':\')\n"

"\'b9:01:ef\'\n"

">>> value.hex(\':\', 2)\n"

"\'b9:01ef\'\n"

">>> value.hex(\':\', -2)\n"

"\'b901:ef\'");

#define MEMORYVIEW_HEX_METHODDEF    \

    {"hex", _PyCFunction_CAST(memoryview_hex), METH_FASTCALL|METH_KEYWORDS, memoryview_hex__doc__},

static PyObject *

memoryview_hex_impl(PyMemoryViewObject *self, PyObject *sep,

                    Py_ssize_t bytes_per_sep);

static PyObject *

memoryview_hex(PyObject *self, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)

{

    PyObject *return_value = NULL;

    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)

    #define NUM_KEYWORDS 2

    static struct {

        PyGC_Head _this_is_not_used;

        PyObject_VAR_HEAD

        Py_hash_t ob_hash;

        PyObject *ob_item[NUM_KEYWORDS];

    } _kwtuple = {

        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)

        .ob_hash = -1,

        .ob_item = { &_Py_ID(sep), &_Py_ID(bytes_per_sep), },

    };

    #undef NUM_KEYWORDS

    #define KWTUPLE (&_kwtuple.ob_base.ob_base)

    #else  // !Py_BUILD_CORE

    #  define KWTUPLE NULL

    #endif  // !Py_BUILD_CORE

    static const char * const _keywords[] = {"sep", "bytes_per_sep", NULL};

    static _PyArg_Parser _parser = {

        .keywords = _keywords,

        .fname = "hex",

        .kwtuple = KWTUPLE,

    };

    #undef KWTUPLE

    PyObject *argsbuf[2];

    Py_ssize_t noptargs = nargs + (kwnames ? PyTuple_GET_SIZE(kwnames) : 0) - 0;

    PyObject *sep = NULL;

    Py_ssize_t bytes_per_sep = 1;

    args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser,

            /*minpos*/ 0, /*maxpos*/ 2, /*minkw*/ 0, /*varpos*/ 0, argsbuf);

    if (!args) {

        goto exit;

    }

    if (!noptargs) {

        goto skip_optional_pos;

    }

    if (args[0]) {

        sep = args[0];

        if (!--noptargs) {

            goto skip_optional_pos;

        }

    }

    {

        Py_ssize_t ival = -1;

        PyObject *iobj = _PyNumber_Index(args[1]);

        if (iobj != NULL) {

            ival = PyLong_AsSsize_t(iobj);

            Py_DECREF(iobj);

        }

        if (ival == -1 && PyErr_Occurred()) {

            goto exit;

        }

        bytes_per_sep = ival;

    }

skip_optional_pos:

    return_value = memoryview_hex_impl((PyMemoryViewObject *)self, sep, bytes_per_sep);

exit:

    return return_value;

}

PyDoc_STRVAR(memoryview_count__doc__,

"count($self, value, /)\n"

"--\n"

"\n"

"Count the number of occurrences of a value.");

#define MEMORYVIEW_COUNT_METHODDEF    \

    {"count", (PyCFunction)memoryview_count, METH_O, memoryview_count__doc__},

static PyObject *

memoryview_count_impl(PyMemoryViewObject *self, PyObject *value);

static PyObject *

memoryview_count(PyObject *self, PyObject *value)

{

    PyObject *return_value = NULL;

    return_value = memoryview_count_impl((PyMemoryViewObject *)self, value);

    return return_value;

}

PyDoc_STRVAR(memoryview_index__doc__,

"index($self, value, start=0, stop=sys.maxsize, /)\n"

"--\n"

"\n"

"Return the index of the first occurrence of a value.\n"

"\n"

"Raises ValueError if the value is not present.");

#define MEMORYVIEW_INDEX_METHODDEF    \

    {"index", _PyCFunction_CAST(memoryview_index), METH_FASTCALL, memoryview_index__doc__},

static PyObject *

memoryview_index_impl(PyMemoryViewObject *self, PyObject *value,

                      Py_ssize_t start, Py_ssize_t stop);

static PyObject *

memoryview_index(PyObject *self, PyObject *const *args, Py_ssize_t nargs)

{

    PyObject *return_value = NULL;

    PyObject *value;

    Py_ssize_t start = 0;

    Py_ssize_t stop = PY_SSIZE_T_MAX;

    if (!_PyArg_CheckPositional("index", nargs, 1, 3)) {

        goto exit;

    }

    value = args[0];

    if (nargs < 2) {

        goto skip_optional;

    }

    if (!_PyEval_SliceIndexNotNone(args[1], &start)) {

        goto exit;

    }

    if (nargs < 3) {

        goto skip_optional;

    }

    if (!_PyEval_SliceIndexNotNone(args[2], &stop)) {

        goto exit;

    }

skip_optional:

    return_value = memoryview_index_impl((PyMemoryViewObject *)self, value, start, stop);

exit:

    return return_value;

}

/*[clinic end generated code: output=889b7cc1a94bfc9b input=a9049054013a1b77]*/