ThePQEXEC
Hàm là đủ để gửi các kèo chấp bóng đá hôm nay trong các ứng dụng bình thường, đồng bộ. Nó có một vài thiếu sót, tuy nhiên, có thể quan trọng đối với một số người dùng:
PQEXEC
Đợi lệnh được hoàn thành. Ứng dụng có thể có công việc khác phải làm (chẳng hạn như duy trì giao diện người dùng), trong trường hợp đó sẽ kèo chấp bóng đá hôm nay muốn chặn chờ phản hồi.
Vì việc thực hiện ứng dụng máy khách bị đình chỉ trong khi chờ kết quả, rất khó để ứng dụng quyết định rằng họ muốn cố gắng hủy lệnh đang diễn ra. (Nó có thể được thực hiện từ một trình xử lý tín hiệu, nhưng kèo chấp bóng đá hôm nay phải khác.)
PQEXEC
chỉ có thể trả về mộtpgresult
Cấu trúc. Nếu chuỗi kèo chấp bóng đá hôm nay đã gửi chứa nhiềuSQL12462_12492pgresult
bị loại bỏ bởiPQEXEC
.
PQEXEC
Luôn thu thập toàn bộ kết quả của kèo chấp bóng đá hôm nay, đệm nó trong mộtPGRESULT
. Mặc dù điều này đơn giản hóa logic xử lý lỗi cho ứng dụng, nhưng nó có thể kèo chấp bóng đá hôm nay thực tế đối với kết quả có chứa nhiều hàng.
Các ứng dụng kèo chấp bóng đá hôm nay thích những hạn chế này thay vào đó có thể sử dụng các chức năng cơ bản màPQEXEC
được xây dựng từ:PQSendQuery
vàPQGetResult
. Cũng cóPQSendQueryParams
, PQSendPrepare
, PQSendQueryPrepared
, và
, có thể được sử dụng với
PQGetResult
Để sao chép chức năng củaPQExecParams
, PQPrepare
, PQEXECPREPARED
, và
PQDescriptePortal
tương ứng.
PQSendQuery
gửi lệnh lên máy chủ mà kèo chấp bóng đá hôm nay cần chờ kết quả. 1 được trả về nếu lệnh được gửi thành công và 0 nếu kèo chấp bóng đá hôm nay (trong trường hợp đó, sử dụngpqerrormessage
Để biết thêm thông tin về sự thất bại).
int pqsendquery (pgconn *Conn, const char *kèo chấp bóng đá hôm nay);
15510_1553915618_15631
, gọiPQGetResult
Một hoặc nhiều lần để có được kết quả.PQSendQuery
kèo chấp bóng đá hôm nay thể được gọi lại (trên cùng một kết nối) cho đến khiPQGetResult
đã trả về một con trỏ null, cho biết rằng kèo chấp bóng đá hôm nay đã được thực hiện.
PQSendQueryParams
gửi một lệnh và các tham số riêng biệt cho máy chủ mà kèo chấp bóng đá hôm nay cần chờ kết quả.
int pqsendqueryparams (pgconn *Conn, kèo chấp bóng đá hôm nay 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ớiPQSendQuery
Ngoạ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 tham số của chức năng được xử lý giống hệt vớiPQExecParams
. GiốngPQExecParams
, nó sẽ kèo chấp bóng đá hôm nay hoạt động 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.
PQSendPrepare
Gửi yêu cầu tạo câu lệnh đã chuẩn bị với các tham số đã cho, mà kèo chấp bóng đá hôm nay cần 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 kèo chấp bóng đá hôm nay bộ củaPQPrepare
: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu kèo chấp bóng đá hôm nay. Sau một cuộc gọi thành công, hãy gọiPQGetResult
Để xác định xem máy chủ có tạo thành công câu lệnh đã chuẩn bị hay kèo chấp bóng đá hôm nay. Các tham số của chức năng được xử lý giống hệt vớiPQPrepare
. GiốngPQPrepare
, nó sẽ kèo chấp bóng đá hôm nay hoạt động trên các kết nối 2.0-giao thức.
PQSendQueryPrepared
Gửi yêu cầu thực thi câu lệnh đã chuẩn bị với các tham số đã cho, mà kèo chấp bóng đá hôm nay cần chờ 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 kèo chấp bóng đá hôm nay sẽ được thực thi được chỉ định bằng cách đặt tên một câu kèo chấp bóng đá hôm nay được chuẩn bị trước đó, thay vì đưa ra một chuỗi truy vấn. Các tham số của chức năng được xử lý giống hệt vớiPQExecprepared
. GiốngPQExecprepared
19969_20018
20266_20379
20412_20479
Đây là phiên bản kèo chấp bóng đá hôm nay bộ của: nó trả về 1 nếu nó có thể gửi yêu cầu và 0 nếu kèo chấp bóng đá hôm nay. Sau một cuộc gọi thành công, hãy gọi
PQGetResult
Để có được kết quả. Các tham số của chức năng được xử lý giống hệt vớiPQDespripePrepared
. Giống, nó sẽ kèo chấp bóng đá hôm nay hoạt động trên các kết nối 2.0-giao thức.
Đệ trình yêu cầu lấy thông tin về cổng thông tin được chỉ định mà kèo chấp bóng đá hôm nay cần chờ hoàn thành.
21591_21658
Đây là phiên bản kèo chấp bóng đá hôm nay bộ củaPQDescriptePortal
21821_21922PQGetResult
Để có được kết quả. Các tham số của chức năng được xử lý giống hệt với22185_22203
. GiốngPQDescriptePortal
, nó sẽ kèo chấp bóng đá hôm nay hoạt động trên các kết nối 2.0-giao thức.
PQGetResult
Chờ kết quả tiếp theo từ trướcPQSendQuery
, PQSendQueryParams
, PQSendPrepare
, PQSendQueryPrepared
, hoặc
Gọi và trả về nó. Một con trỏ null được trả về khi lệnh hoàn tất và sẽ kèo chấp bóng đá hôm nay còn kết quả nữa.
PGRESULT *PQGetResult (PGConn *Conn);
PQGetResult
phải được gọi nhiều lần cho đến khi nó trả về một con trỏ null, cho biết lệnh được thực hiện. (Nếu được gọi khi kèo chấp bóng đá hôm nay có lệnh nào hoạt động,PQGetResult
Sẽ chỉ trả lại một con trỏ null cùng một lúc.) Mỗi kết quả kèo chấp bóng đá hôm nay có null từPQGetResult
nên được xử lý bằng cách sử dụng cùngpgresult
Các hàm accessor được mô tả trước đây. Đừng quên giải phóng mỗi đối tượng kết quả vớiPQClear
Khi được thực hiện với nó. Lưu ý rằngPQGetResult
Sẽ chỉ chặn nếu một kèo chấp bóng đá hôm nay đang hoạt động và dữ liệu phản hồi cần thiết chưa được đọc bởiPQConsumeInput
.
ngay cả khiPQResultstatus
Cho biết lỗi nghiêm trọng,PQGetResult
nên được gọi cho đến khi nó trả về một con trỏ null, để cho phéplibpqĐể xử lý hoàn toàn thông tin lỗi.
sử dụngPQSendQuery
vàPQGetResult
giải quyết một trongPQEXEC
S Vấn đề: Nếu chuỗi kèo chấp bóng đá hôm nay chứa nhiềuSQL25605_25876
Một tính năng khác thường có thể thu được bằngPQSendQuery
vàPQGetResult
đang truy xuất kết quả truy vấn lớn một hàng tại một thời điểm. Điều này được thảo luận trongPhần 33.5.
Chính nó, gọiPQGetResult
vẫn sẽ khiến máy khách chặn cho đến khi máy chủ hoàn thành tiếp theoSQLkèo chấp bóng đá hôm nay. Điều này có thể tránh được bằng cách sử dụng đúng hai chức năng:
PQConsumeInput
Nếu đầu vào có sẵn từ máy chủ, hãy tiêu thụ nó.
int pqconsumeinput (pgconn *Conn);
PQConsumeInput
Thông thường trả về 1 chỉ raHồikèo chấp bóng đá hôm nay có lỗixông, nhưng trả về 0 nếu có một số loại rắc rối (trong trường hợp đópqerrormessage
có thể được tư vấn). Lưu ý rằng kết quả kèo chấp bóng đá hôm nay cho biết liệu có bất kỳ dữ liệu đầu vào nào được thu thập hay kèo chấp bóng đá hôm nay. Sau khi gọiPQConsumeInput
, ứng dụng có thể kiểm trapqisbusy
và/hoặcpqnotify
Để xem trạng thái của họ có thay đổi kèo chấp bóng đá hôm nay.
PQConsumeInput
có thể được gọi ngay cả khi ứng dụng chưa được chuẩn bị để xử lý kết quả hoặc thông báo. Chức năng sẽ đọc dữ liệu có sẵn và lưu nó trong bộ đệm, do đó gây raselect ()
Chỉ báo sẵn sàng để biến mất. Do đó ứng dụng có thể sử dụngPQConsumeInput
Để xóaselect ()
Điều kiện ngay lập tức, sau đó kiểm tra kết quả lúc rảnh rỗi.
PQISBusy
Trả về 1 nếu một kèo chấp bóng đá hôm nay bận, nghĩa làPQGetResult
Sẽ chặn chờ nhập. Trả về 0 chỉ ra rằngPQGetResult
Có thể được gọi với sự đảm bảo kèo chấp bóng đá hôm nay chặn.
int pqisbusy (pgconn *Conn);
pqisbusy
Bản thân nó sẽ kèo chấp bóng đá hôm nay cố gắng đọc dữ liệu từ máy chủ; Vì vậyPQConsumeInput
phải được gọi trước hoặc trạng thái bận rộn sẽ kèo chấp bóng đá hôm nay bao giờ kết thúc.
29553_29631select ()
hoặcpoll ()
Để chờ tất cả các điều kiện mà nó phải đáp ứng. Một trong các điều kiện sẽ được nhập từ máy chủ, theo điều khoảnselect ()
có nghĩa là dữ liệu có thể đọc được trên bộ mô tả tệp được xác định bởiPQSocket
. Khi vòng chính phát hiện đầu vào sẵn sàng, nó sẽ gọiPQConsumeInput
Để đọc đầu vào. Sau đó nó có thể gọiPQISBusy
, theo sau làPQGetResult
nếuPQISBusy
Trả về sai (0). Nó cũng có thể gọipqnotifyes
Để phát hiệnThông báo
Tin nhắn (xemPhần 33.8).
Một máy khách sử dụngPQSendQuery
/PQGetResult
cũng có thể cố gắng hủy một kèo chấp bóng đá hôm nay vẫn đang được máy chủ xử lý; nhìn thấyPhần 33.6. Nhưng bất kể giá trị trả về củaPQCANCEL
, Ứng dụng phải tiếp tục với chuỗi đọc kết quả thông thường bằng cách sử dụngPQGetResult
. Việc hủy bỏ thành công chỉ đơn giản là khiến lệnh chấm dứt sớm hơn so với nếu kèo chấp bóng đá hôm nay.
Bằng cách sử dụng các chức năng được mô tả ở trên, có thể tránh chặn trong khi chờ nhập từ máy chủ cơ sở dữ liệu. Tuy nhiên, vẫn có thể ứng dụng sẽ chặn chờ gửi đầu ra đến máy chủ. Điều này tương đối kèo chấp bóng đá hôm nay phổ biến nhưng có thể xảy ra nếu các lệnh SQL hoặc giá trị dữ liệu rất dài được gửi. (Sẽ có nhiều khả năng hơn nếu ứng dụng gửi dữ liệu quaSao chép trong
Tuy nhiên.) Để ngăn chặn khả năng này và đạt được hoạt động cơ sở dữ liệu hoàn toàn kèo chấp bóng đá hôm nay chặn, các chức năng bổ sung sau đây có thể được sử dụng.
pqsetNonblocking
Đặt trạng thái kèo chấp bóng đá hôm nay 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 kèo chấp bóng đá hôm nay chặn nếuarg
là 1 hoặc chặn nếuarg
là 0. Trả về 0 nếu ok, -1 nếu lỗi.
Ở trạng thái kèo chấp bóng đá hôm nay chặn, các cuộc gọi thành công đếnPQSendQuery
, pqputline
, pqputnbytes
, PQPutCopydata
vàPQENDCOPY
sẽ kèo chấp bóng đá hôm nay chặn; Những thay đổi của chúng được lưu trữ trong bộ đệm đầu ra cục bộ cho đến khi chúng được xả. Các cuộc gọi kèo chấp bóng đá hôm nay thành công sẽ trả về một lỗi và phải được thử lại.
Lưu ý rằngPQEXEC
kèo chấp bóng đá hôm nay tôn trọng chế độ kèo chấp bóng đá hôm nay chặn; Nếu nó được gọi, dù sao nó cũng sẽ hành động theo thời trang.
PQISNONBLOCK
Trả về trạng thái chặn của kết nối cơ sở dữ liệu.
int pqisnonblocking (const pgconn *Conn);
Trả về 1 nếu kết nối được đặt thành chế độ kèo chấp bóng đá hôm nay chặn và 0 nếu chặn.
PQFLUSH
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ó kèo chấp bóng đá hôm nay thành công vì một số lý do hoặc 1 nếu nó kèo chấp bóng đá hôm nay 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 kèo chấp bóng đá hôm nay chặn).
int pqflush (pgconn *Conn);
Sau khi gửi bất kỳ lệnh hoặc dữ liệu nào trên kết nối kèo chấp bóng đá hôm nay chặn, hãy gọiPQFLUSH
. Nếu nó trả về 1, hãy đợi ổ cắm được đọc hoặc viết. Nếu nó trở nên sẵn sàng viết, hãy gọiPQFLUSH
Một lần nữa. Nếu nó trở nên sẵn sàng đọc, hãy gọiPQConsumeInput
, sau đó gọiPQFLUSH
Một lần nữa. Lặp lại cho đến khiPQFLUSH
Trả về 0. (Cần kiểm tra sẵn sàng đọc và thoát đầu vào vớiPQConsumeInput
35772_35902PQFLUSH
Trả về 0, đợi ổ cắm được đọc và sau đó đọc phản hồi như mô tả ở trên.
Nếu bạn thấy bất cứ điều gì trong tài liệu kèo chấp bóng đá hôm nay chính xác, kèo chấp bóng đá hôm nay khớp Kinh nghiệm của bạn với tính năng cụ thể hoặc yêu cầu làm rõ thêm, Vui lòng sử dụngMẫu nàyĐể báo cáo vấn đề tài liệu.