31.7. kèo bóng đá c1 nhanh

PostgreSQLCung cấp đường dẫn nhanh giao kèo bóng đá c1 để gửi các cuộc gọi chức năng đơn giản đến máy chủ.

hàmPQFNYêu cầu thực hiện chức năng máy chủ thông qua kèo bóng đá c1 nhanh:

11528_11871

ThefnidĐối số là oid của chức năng sẽ được thực thi.argsvàNARGSXác định các tham số sẽ được truyền đến chức năng; Họ phải khớp với đối số hàm được khai báo danh sách. KhiisintTrường của a cấu trúc tham số là đúng,U.Integer12264_12396isintIS Sai, số byte được chỉ định tại*U.Ptrđược gửi không có xử lý; dữ kèo bóng đá c1 phải ở định dạng mà máy chủ dự kiến ​​để truyền nhị phân Kiểu dữ kèo bóng đá c1 đối số của chức năng. (Tuyên bố củaU.PTRlà loạiint *là lịch sử; Sẽ tốt hơn nếu xem xét nóvoid *.)result_bufĐiểm đến bộ đệm để đặt giá trị trả về của hàm. Các Người gọi phải phân bổ đủ không gian để lưu trữ trở lại giá trị. (Không có kiểm tra!) Độ dài kết quả thực tế trong byte sẽ được trả về trong số nguyên được trỏ bởiresult_len. Nếu kết quả số nguyên 2 hoặc 4 byte là mong đợi, đặtresult_is_intđến 1, nếu không, đặ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, vì vậy rằng 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 phân phối vào trong*result_bufcho được phép Kích thước kết quả. 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 thay đổi. (Trong trường hợp này tốt hơn là nên xem xétresult_buflà loạiVOID *.)

PQFNLuô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. Người gọi là chịu trách nhiệm giải phóngpgresultvớiPQClearKhi nó không còn nữa cần thiết.

Lưu ý rằng không thể xử lý các đối số null, null Kết quả, cũng không có kết quả có giá trị khi sử dụng giao kèo bóng đá c1 này.