PostgreSQLCung cấp kèo bóng đá cúp c2 để 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 đá cúp c2 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ữ liệu phải ở định dạng mà máy chủ dự kiến ​​để truyền nhị phân của kiểu dữ liệu đố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 biến đổ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ỏ, có trạng tháiPGRES_COMMAND_OKĐể thành công hoặcPGRES_FATAL_ERRORNếu gặp một số vấn đề. Trạng thái kết quả nên được kiểm tra trước khi kết quả được sử dụng.pgresultvớiPQClearKhi nó không còn cần thiết nữa.

Để chuyển đối số null cho hàm, đặtlenTrường của cấu trúc tham số đó thành-1; TheisintvàuTrường sau đó không liên quan.

Nếu hàm trả về null,*result_lenđược đặt thành-1và*result_bufkhông được sửa đổi.

Lưu ý rằng không thể xử lý các kết quả có giá trị được đặt khi sử dụng kèo bóng đá cúp c2 này. Ngoài ra, hàm phải là hàm đơn giản, không phải là tổng hợp, hàm cửa sổ hoặc thủ tục.