Các chức năng này có thể được sử dụng để thẩm vấn trạng thái của đối tượng tỷ lệ kèo bóng đá trực tuyến hôm nay cơ sở dữ liệu hiện có.
libpqLập trình viên ứng dụng nên cẩn thận để duy trìPGConn
Trừu tượng. Sử dụng các hàm accessor được mô tả bên dưới để có được nội dung củaPGConn
. Tham khảo nội bộPGConn
Trường sử dụnglibpq-int.h
không được khuyến nghị vì chúng có thể thay đổi trong tương lai.
Các hàm sau trả về giá trị tham số được thiết lập khi tỷ lệ kèo bóng đá trực tuyến hôm nay. Các giá trị này được cố định cho tuổi thọ của tỷ lệ kèo bóng đá trực tuyến hôm nay. Nếu chuỗi tỷ lệ kèo bóng đá trực tuyến hôm nay đa host được sử dụng, các giá trị củaPQHOST
, PQPort
vàPQPass
Có thể thay đổi nếu tỷ lệ kèo bóng đá trực tuyến hôm nay mới được thiết lập bằng cùng mộtPGConn
Đối tượng. Các giá trị khác được cố định cho vòng đời củaPGConn
Đối tượng.
PQDB
Trả về tên cơ sở dữ liệu của tỷ lệ kèo bóng đá trực tuyến hôm nay.
char *pqdb (const pgconn *Conn);
pquser
Trả về tên người dùng của tỷ lệ kèo bóng đá trực tuyến hôm nay.
char *pquser (const pgconn *Conn);
PQPass
Trả về mật khẩu của tỷ lệ kèo bóng đá trực tuyến hôm nay.
Char *PQPass (const pgconn *Conn);
PQPass
Sẽ trả về mật khẩu được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay hoặc nếu không có và mật khẩu được lấy từPostgresql: Tài, nó sẽ trả lại điều đó. Trong trường hợp sau, nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, thì không thể dựa vào kết quả củaPQPass
Cho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus
.
PQHOST
Trả về tên máy chủ máy chủ của tỷ lệ kèo bóng đá trực tuyến hôm nay đang hoạt động. Đây có thể là tên máy chủ, địa chỉ IP hoặc đường dẫn thư mục nếu tỷ lệ kèo bóng đá trực tuyến hôm nay thông qua ổ cắm UNIX. (Trường hợp đường dẫn có thể được phân biệt vì nó sẽ luôn là một con đường tuyệt đối, bắt đầu bằng/
.)
char *pqhost (const pgconn *Conn);
Nếu các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay được chỉ định cảhost
vàhostaddr
, sau đóPQHOST
sẽ trả vềmáy chủ
Thông tin. Nếu chỉhostaddr
đã được chỉ định, sau đó được trả về. Nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay,PQHOST
Trả về máy chủ thực sự được tỷ lệ kèo bóng đá trực tuyến hôm nay với.
PQHOST
returnnull
NếuConn
Đối số lànull
. Mặt khác, nếu có lỗi tạo ra thông tin máy chủ (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.
Nếu nhiều máy chủ được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, không thể dựa vào kết quả củaPQHOST
Cho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus
.
PQHOSTADDR
Trả về địa chỉ IP máy chủ của tỷ lệ kèo bóng đá trực tuyến hôm nay hoạt động. Đây có thể là địa chỉ mà tên máy chủ được giải quyết hoặc địa chỉ IP được cung cấp thông quahostaddr
tham số.
char *pqhostaddr (const pgconn *Conn);
PQHOSTADDR
returnnull
NếuConn
Đối số lànull
. Mặt khác, nếu có lỗi tạo ra thông tin máy chủ (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.
PQPort
Trả về cổng tỷ lệ kèo bóng đá trực tuyến hôm nay hoạt động.
char *pqport (const pgconn *Conn);
Nếu nhiều cổng được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay,PQPort
Trả về cổng thực sự được tỷ lệ kèo bóng đá trực tuyến hôm nay với.
PQPort
returnnull
NếuConn
Đối số lànull
. Mặt khác, nếu có lỗi tạo ra thông tin cổng (có lẽ nếu tỷ lệ kèo bóng đá trực tuyến hôm nay chưa được thiết lập đầy đủ hoặc có lỗi), nó sẽ trả về một chuỗi trống.
Nếu nhiều cổng được chỉ định trong các tham số tỷ lệ kèo bóng đá trực tuyến hôm nay, không thể dựa vào kết quả củaPQPort
Cho đến khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập. Trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay có thể được kiểm tra bằng hàmpqstatus
.
pqtty
Chức tỷ lệ kèo bóng đá trực tuyến hôm nay này không còn làm gì cả, nhưng nó vẫn dành cho khả tỷ lệ kèo bóng đá trực tuyến hôm nay tương thích ngược. Hàm luôn trả về một chuỗi trống hoặcnull
NếuConn
Đối số lànull
.
char *pqtty (const pgconn *Conn);
PQOptions
Trả về các tùy chọn dòng lệnh được truyền trong yêu cầu tỷ lệ kèo bóng đá trực tuyến hôm nay.
char *pqoptions (const pgconn *Conn);
Các chức tỷ lệ kèo bóng đá trực tuyến hôm nay sau khi trả về dữ liệu trạng thái có thể thay đổi khi các hoạt động được thực thi trênPGConn
Đối tượng.
pqstatus
Trả về trạng thái của tỷ lệ kèo bóng đá trực tuyến hôm nay.
ConnstatusType pqStatus (const pgconn *Conn);
Trạng thái có thể là một trong một số giá trị. Tuy nhiên, chỉ có hai trong số này được nhìn thấy bên ngoài quy trình tỷ lệ kèo bóng đá trực tuyến hôm nay không đồng bộ:Connection_ok
vàConnection_Bad
. Một tỷ lệ kèo bóng đá trực tuyến hôm nay tốt với cơ sở dữ liệu có trạng tháiConnection_ok
. Một nỗ lực tỷ lệ kèo bóng đá trực tuyến hôm nay thất bại được báo hiệu bởi trạng tháiConnection_Bad
. Thông thường, tỷ lệ kèo bóng đá trực tuyến hôm nay OK sẽ vẫn như vậy cho đến khipqfinish
, nhưng lỗi truyền thông có thể dẫn đến tỷ lệ kèo bóng đá trực tuyến hôm nay thay đổi thànhConnection_Bad
sớm. Trong trường hợp đó, ứng dụng có thể cố gắng khôi phục bằng cách gọiPQReset
.
Xem mục choPQConnectStartParams
, PQConnectStart
vàPQConnectPoll
Liên quan đến các mã tỷ lệ kèo bóng đá trực tuyến hôm nay khác có thể được trả về.
PQTransactionStatus
Trả về tỷ lệ kèo bóng đá trực tuyến hôm nay chuyển đổi hiện tại của máy chủ.
tỷ lệ kèo bóng đá trực tuyến hôm nay có thể làPQTRANS_IDLE
(hiện đang nhàn rỗi),pqtrans_active
(một lệnh đang được tiến hành),pqtrans_intrans
(nhàn rỗi, trong một khối giao dịch hợp lệ) hoặcpqtrans_inerror
(nhàn rỗi, trong một khối giao dịch thất bại).pqtrans_unknown
được báo cáo nếu tỷ lệ kèo bóng đá trực tuyến hôm nay xấu.pqtrans_active
chỉ được báo cáo khi truy vấn đã được gửi đến máy chủ và chưa hoàn thành.
PQParameterstatus
Xem lên cài đặt tham số hiện tại của máy chủ.
const char *pqparameterstatus (const pgconn *Conn, const char *paramname);
Các giá trị tham số nhất định được báo cáo tự động khi khởi động tỷ lệ kèo bóng đá trực tuyến hôm nay hoặc bất cứ khi nào giá trị của chúng thay đổi.PQParameterstatus
có thể được sử dụng để thẩm vấn các cài đặt này. Nó trả về giá trị hiện tại của một tham số nếu được biết hoặcnull
Nếu tham số không được biết.
Các tham số được báo cáo là bản phát hành hiện tại bao gồmserver_version
, server_encoding
, client_encoding
, application_name
, default_transaction_read_only
, in_hot_standby
, is_superuser
, session_Authorization
, Datestyle
, IntervalStyle
, timezone
, Integer_Datetimes
vàStandard_Conforming_Strings
. (server_encoding
, timezone
vàInteger_Datetimes
không được báo cáo bởi các bản phát hành trước 8.0;Standard_Conforming_Strings
không được báo cáo bởi các bản phát hành trước 8.1;IntervalStyle
Không được báo cáo bởi các bản phát hành trước 8.4;application_name
không được báo cáo bởi các bản phát hành trước 9.0;default_transaction_read_only
vàin_hot_standby
Không được báo cáo bởi các bản phát hành trước 14.) Lưu ý rằngserver_version
, server_encoding
vàinteger_datetimes
Không thể thay đổi sau khi khởi động.
Nếu không có giá trị choStandard_Conforming_Strings
được báo cáo, các ứng dụng có thể giả sử đó làTẮT
, nghĩa là, các dấu gạch chéo ngược được coi là trốn thoát trong các chuỗi chữ. Ngoài ra, sự hiện diện của tham số này có thể được coi là một dấu hiệu cho thấy cú pháp chuỗi thoát (E '...'
) được chấp nhận.
Mặc dù con trỏ được trả về được khai báoconst
, Thực tế nó chỉ vào bộ lưu trữ có thể thay đổi được liên tỷ lệ kèo bóng đá trực tuyến hôm nay vớiPGConn
Cấu trúc. Không khôn ngoan khi cho rằng con trỏ sẽ vẫn còn hiệu lực trên các truy vấn.
PQProtocolVersion
thẩm vấn giao thức Frontend/phụ trợ đang được sử dụng.
int pqProtocolVersion (const pgconn *Conn);
Các ứng dụng có thể muốn sử dụng chức năng này để xác định xem một số tính năng nhất định có được hỗ trợ hay không. Hiện tại, các giá trị có thể là 3 (giao thức 3.0) hoặc không (tỷ lệ kèo bóng đá trực tuyến hôm nay xấu). Phiên bản giao thức sẽ không thay đổi sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay khởi động hoàn tất, nhưng về mặt lý thuyết, nó có thể thay đổi trong quá trình đặt lại tỷ lệ kèo bóng đá trực tuyến hôm nay. Giao thức 3.0 được hỗ trợ bởiPostgreSQLPhiên bản máy chủ 7.4 trở lên.
PQServerVersion
Trả về một số nguyên đại diện cho phiên bản máy chủ.
int pqserverversion (const pgconn *Conn);
Các ứng dụng có thể sử dụng chức năng này để xác định phiên bản của máy chủ cơ sở dữ liệu mà chúng được tỷ lệ kèo bóng đá trực tuyến hôm nay. Kết quả được hình thành bằng cách nhân số phiên bản chính của máy chủ với 10000 và thêm số phiên bản nhỏ. Ví dụ: Phiên bản 10.1 sẽ được trả về dưới dạng 100001 và phiên bản 11.0 sẽ được trả lại là 110000. Không được trả về nếu tỷ lệ kèo bóng đá trực tuyến hôm nay xấu.
Trước phiên bản chính 10,PostgreSQLđã sử dụng số phiên bản ba phần trong đó hai phần đầu tiên cùng nhau đại diện cho phiên bản chính. Cho các phiên bản đó,PQServerVersion
Sử dụng hai chữ số cho mỗi phần; Ví dụ: Phiên bản 9.1.5 sẽ được trả lại là 90105 và phiên bản 9.2.0 sẽ được trả về là 90200.
Do đó, với mục đích xác định khả năng tương thích tính năng, các ứng dụng nên chia tỷ lệ kèo bóng đá trực tuyến hôm nay quả củaPQServerVersion
bởi 100 không 10000 để xác định số phiên bản chính logic. Trong tất cả các chuỗi phát hành, chỉ có hai chữ số cuối cùng khác nhau giữa các bản phát hành nhỏ (bản phát hành sửa lỗi).
pqerrormessage
Trả về thông báo lỗi được tạo gần đây nhất bởi một thao tác trên tỷ lệ kèo bóng đá trực tuyến hôm nay.
char *pqerrormessage (const pgconn *Conn);
Gần như tất cảlibpqCác chức tỷ lệ kèo bóng đá trực tuyến hôm nay sẽ đặt tin nhắn chopqerrormessage
Nếu họ thất bại. Lưu ý rằng bằnglibpqquy ước, một người không trốngpqerrormessage
tỷ lệ kèo bóng đá trực tuyến hôm nay quả có thể bao gồm nhiều dòng và sẽ bao gồm một dòng mới. Người gọi không nên giải phóng tỷ lệ kèo bóng đá trực tuyến hôm nay quả trực tiếp. Nó sẽ được giải phóng khi được liên tỷ lệ kèo bóng đá trực tuyến hôm nayPGConn
Xử lý được chuyển chopqfinish
. Chuỗi tỷ lệ kèo bóng đá trực tuyến hôm nay quả không nên được dự kiến sẽ giữ nguyên trong các hoạt động trênPGConn
Cấu trúc.
PQSocket
Lấy số lượng mô tả tệp của ổ cắm tỷ lệ kèo bóng đá trực tuyến hôm nay vào máy chủ. Một mô tả hợp lệ sẽ lớn hơn hoặc bằng 0; Kết quả của -1 chỉ ra rằng không có tỷ lệ kèo bóng đá trực tuyến hôm nay máy chủ hiện đang mở. (Điều này sẽ không thay đổi trong quá trình hoạt động bình thường, nhưng có thể thay đổi trong quá trình thiết lập hoặc đặt lại tỷ lệ kèo bóng đá trực tuyến hôm nay.)
int pqsocket (const pgconn *Conn);
PQBackendPid
Trả về quy trìnhid(pid)của quá trình phụ trợ xử lý tỷ lệ kèo bóng đá trực tuyến hôm nay này.
int pqbackendPid (const pgconn *Conn);
phụ trợPIDrất hữu ích cho mục đích gỡ lỗi và để so sánh vớiThông báo
Tin nhắn (bao gồmPIDcủa quy trình phụ trợ thông báo). Lưu ý rằngPIDthuộc về quá trình thực thi trên máy chủ máy chủ cơ sở dữ liệu, không phải máy chủ cục bộ!
PQConnectionNeedSpassword
Trả về đúng (1) Nếu phương thức xác thực tỷ lệ kèo bóng đá trực tuyến hôm nay yêu cầu mật khẩu, nhưng không có sẵn. Trả về false (0) nếu không.
int pqconnectionNeedSpassword (const pgconn *Conn);
Hàm này có thể được áp dụng sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay thất bại cố gắng quyết định có nhắc người dùng về mật khẩu không.
PQConnectionSpassword
Trả về true (1) Nếu phương thức xác thực tỷ lệ kèo bóng đá trực tuyến hôm nay sử dụng mật khẩu. Trả về false (0) nếu không.
30684_30737
Hàm này có thể được áp dụng sau khi cố gắng tỷ lệ kèo bóng đá trực tuyến hôm nay thành công hoặc không thành công để phát hiện xem máy chủ có yêu cầu mật khẩu hay không.
Các chức năng sau trả về thông tin liên quan đến SSL. Thông tin này thường không thay đổi sau khi tỷ lệ kèo bóng đá trực tuyến hôm nay được thiết lập.
PQSSlinuse
Trả về true (1) Nếu tỷ lệ kèo bóng đá trực tuyến hôm nay sử dụng SSL, false (0) nếu không.
int pqsslinuse (const pgconn *Conn);
PQSSlattribution
Trả về thông tin liên quan đến SSL về tỷ lệ kèo bóng đá trực tuyến hôm nay.
31783_31862
Danh sách các thuộc tính có sẵn khác nhau tùy thuộc vào thư viện SSL đang được sử dụng và loại tỷ lệ kèo bóng đá trực tuyến hôm nay. Nếu một thuộc tính không khả dụng, hãy trả về null.
Các thuộc tính sau đây thường có sẵn:
Thư viện
Tên của việc triển khai SSL đang sử dụng. (Hiện tại, chỉ"OpenSSL"
được triển khai)
Giao thức
Phiên bản SSL/TLS đang được sử dụng. Các giá trị chung là"TLSV1"
, "TLSV1.1"
và"TLSV1.2"
, nhưng việc triển khai có thể trả về các chuỗi khác nếu một số giao thức khác được sử dụng.
key_bits
Số bit khóa được sử dụng bởi thuật toán mã hóa.
mật mã
Một tên ngắn của ciphersuite được sử dụng, ví dụ:"DHE-RSA-DES-CBC3-SHA"
. Các tên được cụ thể cho mỗi triển khai SSL.
Nén
Trả về "BẬT" Nếu nén SSL được sử dụng, nếu không nó sẽ trả về "TẮT".
PQSSlattributenames
Trả về một mảng tên thuộc tính SSL có sẵn. Mảng bị chấm dứt bởi một con trỏ null.
const char * const * pqsslattributenames (const pgconn * Conn);
PQSSLSTRuct
34181_34267
34300_34367
Cấu trúc có sẵn phụ thuộc vào việc thực hiện SSL đang sử dụng. VìOpenSSL, có một cấu trúc, có sẵn dưới tên "OpenSSL" và nó trả về một con trỏ choOpenSSL SSL
Cấu trúc. Để sử dụng chức tỷ lệ kèo bóng đá trực tuyến hôm nay này, mã dọc theo các dòng sau có thể được sử dụng:
#include <libpq-fe.h #include <openSSL/ssl.h ... SSl *SSl; dbconn = pqconnectdb (...); ... ssl = pqsslstruct (dbconn, "openSSL"); Nếu (SSL) / * Sử dụng các chức tỷ lệ kèo bóng đá trực tuyến hôm nay OpenSSL để truy cập SSL *//
Cấu trúc này có thể được sử dụng để xác minh các mức mã hóa, kiểm tra chứng chỉ máy chủ và hơn thế nữa. Tham khảoOpenSSLTài liệu để biết thông tin về cấu trúc này.
PQGetSSL
Trả về cấu trúc SSL được sử dụng trong tỷ lệ kèo bóng đá trực tuyến hôm nay hoặc NULL nếu SSL không được sử dụng.
VOID *PQGETSSL (const pgconn *Conn);
Hàm này tương đương vớiPQSSLStruct (Conn, "OpenSSL")
. Nó không nên được sử dụng trong các ứng dụng mới, vì cấu trúc được trả về dành riêng choOpenSSLvà sẽ không khả dụng nếu người khácSSLThực hiện được sử dụng. Để kiểm tra xem tỷ lệ kèo bóng đá trực tuyến hôm nay có sử dụng SSL không, hãy gọiPQSSlinuse
Thay vào đó, và để biết thêm chi tiết về tỷ lệ kèo bóng đá trực tuyến hôm nay, sử dụngPQSSlattribution
.
Nếu bạn thấy bất cứ điều gì trong tài liệu không chính xác, không khớp Kinh nghiệm của bạn với tính tỷ lệ kèo bóng đá trực tuyến hôm nay 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.