PostgreSQL: soi kèo bóng đá truoctran liệu: | |||
---|---|---|---|
prev | UP | Chương 31.libpq- C Thư viện | Tiếp theo |
PostgreSQLCung cấp kèo bóng đá euro nhanh để gửi các cuộc gọi chức năng đơn giản đến máy chủ.
Tip:kèo bóng đá euro này có phần lỗi thời, vì người ta có thể đạt được hiệu suất tương tự và chức năng lớn hơn bằng cách thiết lập một câu lệnh đã chuẩn bị để xác định cuộc gọi chức năng. Sau đó, thực hiện câu lệnh bằng truyền nhị phân của các tham số và kết quả thay thế cho một cuộc gọi hàm đường nhanh.
hàmPQFN
Yêu cầu thực hiện chức năng máy chủ thông qua kèo bóng đá euro dẫn nhanh:
pgresult *pqfn (pgconn *Conn,
ThefnidĐối số là oid của hàm được thực thi.argsvàNARGSXác định các tham số sẽ được truyền đến hàm; Họ phải khớp với danh sách đối số chức năng được khai báo.isintTrường của cấu trúc tham số là đúng,U.IntegerGiá trị được gửi đến máy chủ dưới dạng số nguyên của độ dài được chỉ định (đây phải là 2 hoặc 4 byte); Hoán đổi byte thích hợp xảy ra.isintlà sai, số byte được chỉ định tại*U.Ptrđược gửi không có xử lý; Dữ kèo bóng đá euro phải ở định dạng mà máy chủ dự kiến để truyền nhị phân của kiểu dữ kèo bóng đá euro đối số của hàm.U.PTRlà loạiint *là lịch sử; Sẽ tốt hơn nếu xem xét nóvoid *.)result_bufchỉ vào bộ đệm để đặt giá trị trả về của hàm. Người gọi phải phân bổ đủ không gian để lưu trữ giá trị trả về.result_len. Nếu dự kiến kết quả số nguyên 2 hoặc 4 byte, hãy đặtresult_is_intthành 1, nếu không sẽ đặt nó thành 0. Cài đặtresult_is_intđến 1 nguyên nhânlibpqĐể hoán đổi giá trị nếu cần thiết, để nó được phân phối dưới dạng thích hợpintGiá trị cho máy khách; Lưu ý rằng một số nguyên 4 byte được chuyển vào*result_bufĐối với kích thước kết quả được phép. Khiresult_is_intlà 0, chuỗi byte định dạng nhị phân được gửi bởi máy chủ được trả về không sửa đổi. (Trong trường hợp này tốt hơn là nên xem xétresult_buflà loạivoid *.)
PQFN
Luôn trả về một hợp lệpgresultCon trỏ. Trạng thái kết quả nên được kiểm tra trước khi kết quả được sử dụng.pgresultvớiPQClear
Khi nó không còn cần thiết nữa.
Lưu ý rằng không thể xử lý các đối số null, kết quả null, cũng không có kết quả có giá trị khi sử dụng kèo bóng đá euro này.