31.4. Xử lý lệnh soi kèo bóng đá truoctran bộ

gửi lệnh lên máy chủ mà soi kèo bóng đá truoctran cần chờ kết quả). 1 được trả về nếu lệnh đã thành công được gửi và 0 nếu soi kèo bóng đá truoctran (trong trường hợp đó, sử dụngpqerrormessageĐể biết thêm thông tin về sự thất bại).

13724_13779

Sau khi gọi thành côngPQSendQuery, gọiPQGetResultMột hoặc nhiều lần để có được kết quả.PQSendQuery14021_14094PQGetResultđã trả lại a con trỏ null, cho biết soi kèo bóng đá truoctran đã hoàn thành.

Đệ trình lệnh và riêng biệt các tham số cho máy chủ mà soi kèo bóng đá truoctran chờ đợi kết quả.

int pqsendqueryparams (pgconn *Conn,
                      soi kèo bóng đá truoctran const char *,
                      int nparams,
                      const oid *paramtypes,
                      const char * const * paramValues,
                      const int *paramlengths,
                      const int *paramformats,
                      int resultformat);

Điều này tương đương vớiPQSendQueryNgoại trừ các tham số truy vấn có thể được chỉ định riêng biệt với chuỗi truy vấn. Các Các tham số của chức năng được xử lý giống hệt vớiPQExecParams. GiốngPQExecParams, nó sẽ soi kèo bóng đá truoctran làm việc trên các kết nối 2.0 giao thức và nó chỉ cho phép một lệnh trong chuỗi truy vấn.

Gửi yêu cầu tạo câu lệnh đã chuẩn bị với Các tham số đã cho, mà soi kèo bóng đá truoctran chờ hoàn thành.

int PQSendPrepare (PGConn *Conn,
                  const char *stmtname,
                  const char *truy vấn,
                  int nparams,
                  const oid *paramtypes);

Đây là phiên bản soi kèo bóng đá truoctran bộ củaPQPrepare: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu soi kèo bóng đá truoctran. Sau khi thành công Gọi, gọiPQGetResultđến xác định xem máy chủ đã tạo thành công Tuyên bố chuẩn bị. Các tham số của chức năng được xử lý Diễn vớiPQPrepare. GiốngPQPrepare, nó sẽ soi kèo bóng đá truoctran làm việc trên các kết nối 2.0 giao thức.

Gửi yêu cầu thực hiện một câu lệnh đã chuẩn bị với Các tham số đã cho, mà soi kèo bóng đá truoctran chờ đợi (các) kết quả.

int pqsendqueryprepared (PGConn *Conn,
                        const char *stmtname,
                        int nparams,
                        const char * const * paramValues,
                        const int *paramlengths,
                        const int *paramformats,
                        int resultformat);

Điều này tương tựPQSendQueryParams, nhưng soi kèo bóng đá truoctran sẽ được được thực thi được chỉ định bằng cách đặt tên một tuyên bố, thay vì đưa ra một chuỗi truy vấn. Chức năng của Các tham số được xử lý giống hệt vớiPQEXECPREPARED. GiốngPQEXECPREPARED, nó sẽ soi kèo bóng đá truoctran hoạt động Kết nối 2.0-giao thức.

Đệ trình yêu cầu lấy thông tin về tuyên bố đã chuẩn bị được chỉ định, mà soi kèo bóng đá truoctran phải chờ đợi hoàn thành.

17886_17953

Đây là phiên bản soi kèo bóng đá truoctran bộ của: nó trả về 1 nếu nó đã có thể gửi yêu cầu và 0 nếu soi kèo bóng đá truoctran. Sau a cuộc gọi thành công, gọiPQGetResultĐể có được kết quả. Các Các tham số của chức năng được xử lý giống hệt với. Giống, nó sẽ soi kèo bóng đá truoctran hoạt động trên các kết nối 2.0 giao thức.

gửi yêu cầu lấy thông tin về cổng thông tin được chỉ định, mà soi kèo bóng đá truoctran chờ hoàn thành.

18822_18889

Đây là phiên bản soi kèo bóng đá truoctran bộ củaPQDescriptePortal: nó trả về 1 nếu nó là có thể gửi yêu cầu và 0 nếu soi kèo bóng đá truoctran. Sau a cuộc gọi thành công, gọiPQGetResultĐể có được kết quả. Các Các tham số của chức năng được xử lý giống hệt vớiPQDescriptePortal. GiốngPQDescriptePortal, nó sẽ soi kèo bóng đá truoctran làm việc trên các kết nối 2.0 giao thức.

Chờ kết quả tiếp theo từ trướcPQSendQuery, PQSendQueryParams, 19764_19779hoặcPQSendQueryPreparedGọi và trả lại nó. Một con trỏ null được trả về khi lệnh hoàn tất và Sẽ soi kèo bóng đá truoctran có kết quả nữa.

pgresult *pQGetResult (pgconn *Conn);

PQGetResultphải được gọi liên tục cho đến khi nó trả lại một con trỏ null, chỉ ra rằng lệnh được thực hiện. (Nếu được gọi khi soi kèo bóng đá truoctran có lệnh nào hoạt động,PQGetResultSẽ chỉ trở lại một con trỏ null cùng một lúc.) Mỗi ​​kết quả soi kèo bóng đá truoctran null từPQGetResultnên được được xử lý bằng cùng mộtpgresult20524_20629PQClearKhi được thực hiện với nó. Lưu ý rằngPQGetResultWill Chỉ chặn nếu một soi kèo bóng đá truoctran đang hoạt động và cần thiết Dữ liệu phản hồi chưa được đọc bởiPQConsumeInput.

Nếu đầu vào có sẵn từ máy chủ, hãy tiêu thụ nó.

int pqconsumeinput (pgconn *Conn);

PQConsumeInputThông thường trả về 1 chỉ ra"soi kèo bóng đá truoctran có lỗi",, nhưng trả về 0 nếu có một loại rắc rối nào đó (trong đó trường hợppqerrormessagecó thể được tư vấn). Lưu ý rằng kết quả soi kèo bóng đá truoctran cho biết liệu có Dữ liệu đầu vào thực sự được thu thập. Sau khi gọiPQConsumeInput, The Ứng dụng có thể kiểm trapqisbusyvà/hoặcpqnotifyesĐể xem nhà nước của họ có đã thay đổi.

PQConsumeInputcó thể được gọi ngay cả khi ứng dụng soi kèo bóng đá truoctran được chuẩn bị để giải quyết một kết quả hoặc thông báo chỉ là chưa. Chức năng sẽ đọc Dữ liệu có sẵn và lưu nó trong bộ đệm, do đó gây raselect ()23444_23526PQConsumeInputĐể xóaselect ()Điều kiện ngay lập tức, và sau đó kiểm tra kết quả lúc rảnh rỗi.

Trả về 1 nếu một soi kèo bóng đá truoctran bận, nghĩa làPQGetResultsẽ chặn chờ đợi đầu vào. Trả về 0 chỉ ra rằngPQGetResultCó thể được gọi với sự đảm bảo soi kèo bóng đá truoctran chặn.

int pqisbusy (pgconn *Conn);

pqisbusysẽ soi kèo bóng đá truoctran chính nó cố gắng đọc dữ liệu từ máy chủ; Vì vậyPQConsumeInputPhải được viện dẫn trước, hoặc trạng thái bận rộn sẽ soi kèo bóng đá truoctran bao giờ kết thúc.

Đặt trạng thái soi kèo bóng đá truoctran chặn của kết nối.

int pqsetNonblocking (pgconn *Conn, int arg);

Đặt trạng thái của kết nối thành soi kèo bóng đá truoctran chặn nếuarglà 1 hoặc chặn nếuarglà 0. Trả về 0 nếu ok, -1 nếu lỗi.

Ở trạng thái soi kèo bóng đá truoctran chặn, các cuộc gọi đếnPQSendQuery, pqputline, pqputnbytesvàPQENDCOPYsẽ soi kèo bóng đá truoctran chặn mà thay vào đó trả lại lỗi nếu chúng cần được gọi lại.

Lưu ý rằng27469_27477soi kèo bóng đá truoctran Danh dự chế độ soi kèo bóng đá truoctran chặn; Nếu nó được gọi, nó sẽ hành động trong chặn thời trang dù sao.

Trả về trạng thái chặn của cơ sở dữ liệu sự liên quan.

int pqisnonblockocking (const pgconn *Conn);

Trả về 1 nếu kết nối được đặt thành chế độ soi kèo bóng đá truoctran chặn và 0 nếu chặn.

cố gắng xóa bất kỳ dữ liệu đầu ra được xếp hàng nào vào máy chủ. Trả về 0 nếu thành công (hoặc nếu hàng đợi gửi trống), -1 Nếu nó thất bại vì một số lý do, hoặc 1 nếu nó soi kèo bóng đá truoctran thể gửi Tất cả dữ liệu trong hàng đợi gửi (trường hợp này chỉ có thể xảy ra nếu kết nối soi kèo bóng đá truoctran chặn).

int pqflush (pgconn *Conn);