ctypeslib - Dalam talian di Awan

JADUAL:

NAMA

h2xml - tukar fail pengepala kepada pengantara XML
xml2py - tukar perantara XML kepada antara muka Python ctypes

SINOPSIS

h2xml includefile ... [pilihan] -o outputxmlfile
xml2py xmlfile ... [pilihan] -o outputpyfile

DESCRIPTION

ctypeslib ialah penjana kod Python yang mampu menukar fail pengepala C kepada fail xml
(menggunakan gccxml), dan kemudian menukar xmlfiles ke dalam modul Python yang mentakrifkan ctypes
antara muka ke perpustakaan C yang sepadan.

Ctypeslib bukan ctypes. Ctypes disertakan dalam Python 2.5+ dan sebagai add-on untuk lower
versi, manakala ctypeslib ialah alat tambah yang kurang dikenali yang ditulis oleh pengarang ctypes. Jika awak
menggunakan ctypes banyak dan bosan menetapkan argtypes dan menaip semula fungsi yang dipanggil,
anda harus melihat ke dalam ctypeslib. Ctypeslib juga boleh menyediakan jenis data dan struktur daripada
Fail pengepala C secara automatik.

h2xml and xml2py ialah skrip antara muka pengguna kepada ctypeslib. h2xml menukarkan tajuk C
fail ke dalam perantaraan xml (menggunakan gccxml) dan xml2py menukarkan perantaraan ini kepada
Fail Python. Sekurang-kurangnya, anda boleh mendapatkan pembinaan automatik jenis C
(struktur, dll) dalam definisi ctypes. Dengan pilihan tambahan, definisi makro boleh
dikembangkan dan fail Python keluaran boleh dipautkan secara automatik (menggunakan ctypes) ke
perpustakaan C yang sepadan.

Contoh paling ringkas ialah:

h2xml pengepala.h -o out_c.xml
xml2py out_c.xml -o out_c.py

Untuk mendapatkan simbol prapemproses, anda mesti menggunakan -c bendera ke h2xml. Untuk memaut secara automatik
ke perpustakaan C melalui ctypes, anda mesti lulus perpustakaan yang berkaitan xml2py bersama -l
perpustakaan.jadi.

PILIHAN

h2xml pilihan yang berikut:

-h, - membantu
tunjukkan mesej bantuan ringkas

-q, --senyap

-D NAMA[=VALUE]
makro untuk ditakrifkan

-U NAMA
makro untuk menyahtakrifkan

-I DIREKTORI
tambahan termasuk direktori

-o XMLFILE
Nama fail keluaran XML

-c, --cpp-simbol
cuba cari simbol #define - ini mungkin memberikan ralat pengkompil, jadi ia dimatikan oleh
lalai.

-k jangan padam fail sementara yang dibuat (berguna untuk mencari masalah)

xml2py pilihan yang berikut:

-h, - membantu
tunjukkan mesej bantuan ini dan keluar

-c sertakan lokasi fail sumber dalam ulasan

-d sertakan docstrings yang mengandungi prototaip C dan lokasi fail sumber

-k JENIS
jenis perihalan jenis untuk disertakan: d = #defines, e = enumeations, f =
fungsi, s = struktur, t = typedefs

-l dll
perpustakaan untuk mencari fungsi yang dieksport

-o OUTPUT
nama fail output (jika tidak dinyatakan, output standard akan digunakan)

-r EXPRESSION
ungkapan biasa untuk simbol disertakan (jika bukan simbol mahupun
ungkapan dinyatakan, semuanya akan disertakan)

-s SYMBOL
simbol untuk disertakan (jika simbol mahupun ungkapan tidak
dinyatakan, semuanya akan disertakan)

-v keluaran verbose

-w tambah semua dll windows standard ke senarai dll yang dicari

-m modul
Modul Python yang mengandungi simbol yang akan diimport dan bukannya
dijana

--pramuat=Dll
dll untuk dimuatkan sebelum semua yang lain (untuk menyelesaikan simbol)

CONTOH

Sila lihat /usr/share/doc/python-ctypeslib/examples.Debian untuk contoh dan penerangan.

Gunakan ctypeslib dalam talian menggunakan perkhidmatan onworks.net