C-типы интерфейса внешних функций (numpy.ctypeslib)
-
numpy.ctypeslib.as_array(obj, shape=None)[source] -
Создать массив numpy из массива ctypes или указателя ctypes. Массив numpy совмещает память с объектом ctypes.
Параметр размера должен быть указан, если преобразование выполняется из указателя ctypes. Параметр размера игнорируется при преобразовании из массива 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 : str или кортеж str
Флаги массива; могут быть одним или несколькими из:
- 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–2016 NumPy Developers
Licensed under the NumPy License.
https://docs.scipy.org/doc/numpy-1.11.0/reference/routines.ctypeslib.html