kèo bóng đá pháp-Thực hiện lệnh với các tham số ngoại tuyến
int kèo bóng đá pháp (const char *lệnh
,,NARGS
, oid *argtypes
,Giá trị
, const char *NULLS
,,read_only
, dàiĐếm
)
kèo bóng đá pháp
Thực thi một lệnh có thể bao gồm các tham chiếu đến các tham số được cung cấp bên ngoài. Văn bản lệnh đề cập đến một tham số là$
và cuộc gọi chỉ định các loại dữ kèo bóng đá pháp và giá trị cho mỗi ký hiệu đó.n
read_only
vàĐếm
Có cùng cách giải thích như trongSPI_EXECUTE
.
Ưu điểm chính của thói quen này so vớiSPI_EXECUTE
Có thể chèn các giá trị dữ kèo bóng đá pháp vào lệnh mà không cần trích dẫn/thoát tẻ
Kết quả tương tự có thể đạt được vớispi_prepare
theo sauSPI_EXECUTE_PLAN
; Tuy nhiên, khi sử dụng chức năng này, gói truy vấn luôn được tùy chỉnh theo các giá trị tham số cụ thể được cung cấp.
const char *lệnh
chuỗi lệnh
intNARGS
Số lượng tham số đầu vào ($ 1
, $ 2
, v.v.)
oid *argtypes
một mảng có độ dàiNARGS
, chứaoidS của các loại dữ kèo bóng đá pháp của các tham số
Datum *Giá trị
một mảng có độ dàiNARGS
, chứa các giá trị tham số thực tế
const char *NULLS
Một mảng có độ dàiNARGS
, Mô tả tham số nào là null
nếuNULLS
lànull
sau đókèo bóng đá pháp
Giả sử rằng không có tham số nào là null. Nếu không, mỗi mục củaNULLS
mảng phải là' '
Nếu giá trị tham số tương ứng là không null hoặc'n'
Nếu giá trị tham số tương ứng là null. (Trong trường hợp sau, giá trị thực trong tương ứngGiá trị
mục nhập không quan trọng.) Lưu ý rằngNULLS
không phải là chuỗi văn bản, chỉ là một mảng: nó không cần một'\ 0'
Terminator.
boolread_only
TRUE
để thực hiện chỉ đọc
LongĐếm
Số lượng hàng tối đa để trả về hoặc0
không giới hạn
Giá trị trả về giống như đối vớiSPI_EXECUTE
.
SPI_Proced
vàSPI_TUPTABLE
được đặt như trongSPI_EXECUTE
Nếu thành công.