27.5. kèo bóng đá pháp nhanh

PostgreSQLcung cấp a kèo bóng đá pháp dẫn nhanh để 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 máy chủ chức năng thông qua kèo bóng đá pháp nhanh:

pgresult* pqfn (pgconn* Conn,
               int fnid,
               int *result_buf,
               int *result_len,
               int result_is_int,
               const pqargblock *args,
               int nargs);

typedef struct 
    int len;
    int isint;
    Liên minh 
        int *ptr;
        Int Integer;
     u;
 Pqargblock;

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 được truyền cho chức năng; Họ phải phù hợp với hàm được khai báo Danh sách đối số. KhiisintTrường của Một 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à 1, 2 hoặc 4 byte); Hoán đổi byte thích hợp xảy ra. Khiisintlà sai, số byte được chỉ định tại*U.Ptrđược gửi không có xử lý; Dữ kèo bóng đá pháp phải ở định dạng mà máy chủ dự kiến Truyền kiểu dữ kèo bóng đá pháp đối số của chức năng.result_buflà bộ đệm để đặt Giá trị trả lại. Người gọi phải phân bổ đủ không gian để Lưu trữ giá trị trả về. (Không có kiểm tra!) Kết quả thực tế Độ dài sẽ được trả về trong số nguyên được trỏ bởiresult_len. Nếu kết quả số nguyên 1, 2 hoặc 4 byte được mong đợi, được đặtresult_is_intđến 1, nếu không, đặt nó thành 0. Cài đặtresult_is_intđến 1 Nguyên nhânlibpqTO BYTE-SWAP 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. Khiresult_is_intlà 0, byte định dạng nhị phân Chuỗi được gửi bởi máy chủ được trả về không sửa đổi.

PQFNLuôn trả về 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óng13963_13973vớ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 kèo bóng đá pháp này.