Интерфейс внешних функций C-типов (numpy.ctypeslib)
-
numpy.ctypeslib.as_array(obj, shape=None)[source] -
Создаёт массив NumPy из массива ctypes или указателя ctypes. Массив NumPy разделяет память с объектом ctypes.
Параметр
sizeдолжен быть указан при преобразовании из указателя ctypes. Параметрsizeигнорируется при преобразовании из массива ctypes.
-
numpy.ctypeslib.as_ctypes(obj)[source] -
Создаёт и возвращает объект ctypes из массива NumPy. На самом деле принимается всё, что предоставляет __array_interface__.
-
numpy.ctypeslib.ctypes_load_library(*args, **kwds)[source] -
ctypes_load_libraryустарело, используйтеload_libraryвместо него!Библиотеку можно загрузить, используя >>> lib = ctypes.cdll[<полный_путь_к_файлу>]
Однако существуют платформенные соображения, такие как расширения файлов библиотек, а также тот факт, что Windows загрузит первую библиотеку с таким именем. NumPy предоставляет функцию
load_libraryдля удобства.Параметры: libname : str
Имя библиотеки, которое может иметь префикс ‘lib’, но без расширения.
loader_path : str
Расположение библиотеки.
Возвращает: ctypes.cdll[libpath] : объект библиотеки
Объект библиотеки ctypes
Возможные исключения: OSError
Если библиотека с ожидаемым расширением отсутствует или библиотека некорректна и не может быть загружена.
-
numpy.ctypeslib.load_library(libname, loader_path)[source] -
Библиотеку можно загрузить, используя >>> lib = ctypes.cdll[<полный_путь_к_файлу>]
Однако существуют платформенные соображения, такие как расширения файлов библиотек, а также тот факт, что Windows загрузит первую библиотеку с таким именем. NumPy предоставляет функцию
load_libraryдля удобства.Параметры: libname : str
Имя библиотеки, которое может иметь префикс ‘lib’, но без расширения.
loader_path : str
Расположение библиотеки.
Возвращает: ctypes.cdll[libpath] : объект библиотеки
Объект библиотеки ctypes
Возможные исключения: OSError
Если библиотека с ожидаемым расширением отсутствует или библиотека некорректна и не может быть загружена.
-
numpy.ctypeslib.ndpointer(dtype=None, ndim=None, shape=None, flags=None)[source] -
Проверка массивов для restype/argtypes.
Экземпляр
ndpointerиспользуется для описания ndarray в спецификацияхrestypesиargtypes. Этот подход более гибкий, чем, например,POINTER(c_double), так как можно указать несколько ограничений, которые проверяются при вызове функции ctypes. Это включает тип данных, количество измерений, форму и флаги. Если заданный массив не удовлетворяет указанным ограничениям, генерируетсяTypeError.Параметры: dtype : тип данных, необязательно
Тип данных массива.
ndim : int, необязательно
Количество измерений массива.
shape : кортеж целых чисел, необязательно
Форма массива.
flags : строка или кортеж строк
Флаги массива; могут быть одним или несколькими из следующих:
- C_CONTIGUOUS / C / CONTIGUOUS
- F_CONTIGUOUS / F / FORTRAN
- OWNDATA / O
- WRITEABLE / W
- ALIGNED / A
- UPDATEIFCOPY / U
Возвращает: klass : тип объекта ndpointer
Тип объекта, который является экземпляром
_ndtprи содержит информацию оdtype,ndim,shapeиflags.Возможные исключения: TypeError
Если заданный массив не удовлетворяет указанным ограничениям.
Примеры
>>> clib.somefunc.argtypes = [np.ctypeslib.ndpointer(dtype=np.float64, ... ndim=1, ... flags='C_CONTIGUOUS')] ... >>> clib.somefunc(np.array([1, 2, 3], dtype=np.float64)) ...
© 2008–2017 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.13.0/reference/routines.ctypeslib.html