kèo bóng đá cúp c2 9.0.23 Tài liệu | ||||
---|---|---|---|---|
prev | UP | Chương 31.libpq- C Thư viện | Tiếp theo |
Một khi kết nối với máy chủ cơ sở dữ kèo bóng đá cúp c2 đã thành công
Nó được phép bao gồm nhiều lệnh SQL (được phân tách bằngPQEXEC
cuộc gọi được xử lýbắt đầu/cam kếtlệnhpgresultCấu trúc chỉ mô tả kết quảpgresultmô tả
PQExecParams
gửi lệnh lên máy chủ và chờ đợi
PGRESULT *PQEXECPARAMS (PGConn *Conn,
PQExecparams
giống nhưPQEXEC
, nhưng cung cấpPQExecparams
IS
Các đối số chức năng là:
Đối tượng kết nối để gửi lệnh
Chuỗi lệnh SQL được kèo bóng đá cúp c2. Nếu như$ 1, $ 2, v.v.
Số lượng tham số được cung cấp; nó làparamtypes [], paramValues [], paramlength []vàparamformats []. (MảngnullKhinparamsbằng kèo bóng đá cúp c2.)
Chỉ định, bởi OID, các loại dữ kèo bóng đá cúp c2 sẽ được gánparamtypeslànullhoặc bất kỳ yếu tố cụ thể nào trong
Chỉ định các giá trị thực của các tham số. MỘT
Chỉ định độ dài dữ kèo bóng đá cúp c2 thực tế của
Chỉ định xem các tham số có phải là văn bản kèo bóng đá cúp c2 (đặt một
Giá trị được truyền ở định dạng nhị phân đòi hỏi kiến thứcSốGiá trị đòi hỏi kiến thức vềsrc/backend/utils/adt/numeric.c :: numeric_send ()vàsrc/backend/utils/adt/numeric.c :: numeric_recv ().
Chỉ định số 0 để có được kết quả ở định dạng văn bản,
Ưu điểm chính củaPQExecparams
OverPQEXEC
Có thể là các giá trị tham số
kèo bóng đá cúp c2 giống nhưPQEXEC
, PQExecParams
Cho phép nhiều nhất kèo bóng đá cúp c2 lệnh SQL
Tip:Chỉ định các loại tham số thông qua OIDS là
Chọn * Từ MyTable WHERE X = $ 1 :: Bigint;Tham số lực lượng này$ 1thànhBigint, trong khi mặc địnhx. Buộc quyết định loại tham số,
PQPrepare
Đệ trình yêu cầu tạo câu lệnh đã chuẩn bị với
pgresult *pqprepare (pgconn *Conn,
PQPrepare
Tạo aPQEXECPREPARED
. Tính năng này cho phépPQPrepare
IS
Hàm tạo ra kèo bóng đá cúp c2 câu lệnh đã chuẩn bị có tênstmtnametừTruy vấnchuỗi, phải chứa kèo bóng đá cúp c2stmtnamecó thể""Để tạo ra kèo bóng đá cúp c2$ 1,
$ 2, v.v.NPARAMSlà số lượng tham số choparamtypes []. (Con trỏ mảng có thể lànullKhinparamsbằng kèo bóng đá cúp c2.)paramtypes []Chỉ định, bởi OID, dữ kèo bóng đá cúp c2paramtypeslànullhoặc bất kỳ yếu tố cụ thể nào trongNPARAMS; Các loại dữ kèo bóng đá cúp c2 sẽ được suy ra choĐối với kèo bóng đá cúp c2 phương tiện để tìm
như vớiPQEXEC
, Thepgresultđối tượng có nội dung biểu thị thành công phía máy chủ hoặcpqerrormessage
Để biết thêm thông tin
Câu lệnh được chuẩn bị để sử dụng vớiPQEXECPREPARED
cũng có thể được tạo bởiChuẩn bịCâu lệnh. Ngoài ra, mặc dù kèo bóng đá cúp c2 cólibpqChức năng xóa kèo bóng đá cúp c2 chế độ chuẩn bịDealLocateCâu lệnh có thể được sử dụng cho mục đích đó.
PQEXECPREPARED
Gửi yêu cầu thực hiện câu lệnh đã chuẩn bị với
PGRESULT *PQEXECPREPARED (PGConn *Conn,
PQEXECPREPARED
giống nhưPQExecParams
, nhưngPQEXECPREPARED
được hỗ trợ
Các tham số giống hệt vớiPQExecParams
, ngoại trừ tên của kèo bóng đá cúp c2paramtypes []tham số
gửi yêu cầu lấy thông tin về
25799_25868
PQDespripePrepared
Cho phép kèo bóng đá cúp c2 ứng dụng có được thông tin về Achỉ được hỗ trợ trong
stmtnamecó thể""hoặcnullđếnpgresultvới trạng tháiPGRES_COMMAND_OKđược trả về.pqnparams
vàPQParamType
có thể được áp dụngpgresultĐể có đượcPQNFields
, PQFNAME
, PQFTYPE
, vv Cung cấp thông tin về
gửi yêu cầu lấy thông tin về
27474_27543
cho phéplibpqkèo bóng đá cúp c2 cung cấp bất kỳ quyền truy cập trực tiếp nào vào cổng, nhưng bạnKhai báoLệnh SQL.)
PQDescriptePortal
chỉ được hỗ trợ trong
PortalNamecó thể""hoặcnullĐể tham khảo cổng thông tin kèo bóng đá cúp c2 tên,pgresultVớipgres_command_okISPQNFields
, pqfname
, PQFTYPE
, ETC có thể được áp dụng choPGRESULTđể có được
ThePGRESULTCấu trúclibpqCác lập trình viên ứng dụng nên đượcpgresultTrừu tượng. Sử dụng các chức năng truy cập bên dưới để có đượcpgresult. Tránh xaPGRESULTCấu trúc vì chúng là chủ thể
PQResultstatus
Trả về trạng thái kết quả của lệnh.
29724_29779
PQResultstatus
Có thể
Chuỗi được gửi đến máy chủ trống.
Hoàn thành thành công lệnh trả về kèo bóng đá cúp c2
Hoàn thành thành công kèo bóng đá cúp c2 lệnh quay lạiChọnhoặcshow).
Sao chép (từ máy chủ) Truyền dữ kèo bóng đá cúp c2
Sao chép (vào máy chủ) Bắt đầu truyền dữ kèo bóng đá cúp c2.
Phản hồi của máy chủ kèo bóng đá cúp c2 được hiểu.
Một lỗi kèo bóng đá cúp c2 sinh (thông báo hoặc cảnh báo)
xảy ra lỗi nghiêm trọng.
Nếu trạng thái kết quả làPGRES_TUDS_OK, sau đó các chức năngChọnLệnh xảy ra để truy xuất các hàng kèo bóng đá cúp c2 vẫn hiển thịPGRES_TUDS_OK. PGRES_COMMAND_OKdành cho các lệnh có thểChèn, Cập nhật, v.v.). kèo bóng đá cúp c2 phản hồi củapgres_empty_querycó thể chỉ ra
Kết quả của trạng tháiPGRES_NONFATAL_ERRORSẽ kèo bóng đá cúp c2 bao giờ được trả lạiPQEXEC
hoặc khácPhần 31.11).
pqresstatus
Chuyển đổi loại được liệt kê được trả về bởiPQResultstatus
thành hằng số chuỗi
33757_33802
pqresulterrormessage
Trả về thông báo lỗi được liên kết với lệnh,
char *pqresulterrormessage (const pgresult *res);
Nếu có lỗi, chuỗi được trả về sẽpgresultXử lý được chuyển choPQClear
.
Ngay sau APQEXEC
hoặcPQGetResult
CALL,pqerrormessage
(trên kết nối) sẽpqresulterrormessage
(về kết quả).pgresultWillpqresulterrormessage
Khi bạn muốnpgresult; sử dụngpqerrormessage
Khi bạn muốn biết
pqresulterrorfield
Trả về kèo bóng đá cúp c2 trường riêng lẻ của báo cáo lỗi.
Char *pqresulterrorfield (const pgresult *res, int fieldCode);
FieldCodelà trường lỗinullđược trả về nếupgresultkèo bóng đá cúp c2 phải là lỗi hoặc cảnh báopgresultXử lý được chuyển choPQClear
.
Mã trường sau đây có sẵn:
Mức độ nghiêm trọng; Nội dung trường làERROR, FatalhoặcPanic(trong kèo bóng đá cúp c2 thông báo lỗi) hoặccảnh báo, Thông báo, DEBUG, INFOhoặclog(trong kèo bóng đá cúp c2 thông báo thông báo) hoặc a
Mã SQLSTATE cho lỗi. SQLSTATEPhụ lục. Lĩnh vực này kèo bóng đá cúp c2 thể bản địa hóa, và luôn luôn
Thông báo lỗi chính của con người
Chi tiết: Thông báo lỗi thứ cấp tùy chọn
Gợi ý: kèo bóng đá cúp c2 đề xuất tùy chọn phải làm gì
kèo bóng đá cúp c2 chuỗi chứa số nguyên thập phân cho biết
Điều này được xác định giống nhưpg_diag_statement_poseitionTrường, nhưngPG_DIAG_INTERNAL_QUERYTrường sẽ
Văn bản của một lỗi kèo bóng đá cúp c2 được tạo ra trong nội bộ
kèo bóng đá cúp c2 dấu hiệu của ngữ cảnh trong đó lỗi
Tên tệp của vị trí mã nguồn trong đó
Số dòng của vị trí mã nguồn
Tên của báo cáo chức năng mã nguồn
Khách hàng chịu trách nhiệm định dạng được hiển thị
Lỗi được tạo bên tronglibpqsẽ có mức độ nghiêm trọng và chính
Lưu ý rằng các trường lỗi chỉ khả dụng từPGRESULTĐối tượng, kèo bóng đá cúp c2PGConnĐối tượng; kèo bóng đá cúp c2 cópqerrorfield
chức năng.
PQClear
Giải phóng bộ nhớ liên kết với Apgresult. Mọi kết quả lệnh nênPQClear
Khi nào
void pqClear (pgresult *res);
Bạn có thể giữPGRESULTĐối tượng xung quanh miễn là bạn cần nó; nó kèo bóng đá cúp c2 điPQClear
. kèo bóng đá cúp c2 làm điều này
Những chức năng này được sử dụng để trích xuất thông tin từ APGRESULTđối tượng đại diện cho aPGRES_TUDS_OK). Họ cũng có thể
PQNTUMPLES
Trả về số lượng hàng (bộ dữ kèo bóng đá cúp c2) trong truy vấn
int pqntuples (const pgresult *res);
PQNFields
Trả về số lượng cột (trường) trong mỗi hàng của
int pqnfields (const pgresult *res);
pqfname
Trả về tên cột được liên kết với chữ cái đã chopgresultXử lý được chuyển choPQClear
.
char *pqfname (const pgresult *res,
nullđược trả về nếu cột
PQFNumber
Trả về số cột được liên kết với số tiền đã cho
int pqfnumber (const pgresult *res,
-1 được trả về nếu tên đã cho kèo bóng đá cúp c2 khớp với bất kỳ
Tên đã cho được đối xử như kèo bóng đá cúp c2 định danh trong SQL
Chọn 1 làm foo, 2 là "thanh";
Chúng tôi sẽ có kết quả:
pqfname (res, 0)foopqfname (res, 1)Barpqfnumber (res, "foo")0pqfnumber (res, "foo")0pqfnumber (res, "bar")-1pqfnumber (res, "\" bar \ "")1
PQFTable
Trả về OID của bảng mà từ đó đã cho
oid pqftable (const pgresult *res,
kèo bóng đá cúp c2 hợp lệđược trả về nếupg_ classĐể xác định chính xác
Loạioidvà hằng sốkèo bóng đá cúp c2 hợp lệsẽ được xác định khilibpqTệp tiêu đề. Cả hai sẽ là kèo bóng đá cúp c2 loại số nguyên.
pqftablecol
Trả về số cột (trong bảng của nó) của
int pqftablecol (const pgresult *res,
số kèo bóng đá cúp c2 được trả về nếu số cột nằm ngoài phạm vi,
PQFFORMAT
Trả về mã định dạng biểu thị định dạng của
int pqfformat (const pgresult *res,
Mã định dạng Zero cho biết dữ kèo bóng đá cúp c2 văn bản
PQFTYPE
Trả về kiểu dữ kèo bóng đá cúp c2 được liên kết với cột đã cho
oid pqfttype (const pgresult *res,
Bạn có thể truy vấn bảng hệ thốngPG_TYPEĐể có được tên và thuộc tínhoidS của các loại dữ kèo bóng đá cúp c2 tích hợp làsrc/bao gồm/catalog/pg_type.hTrong
PQFMOD
Trả về bộ sửa đổi loại của cột được liên kết
int pqfmod (const pgresult *res,
Giải thích các giá trị sửa đổi là"kèo bóng đá cúp c2 có thông tin". Hầu hết dữ kèo bóng đá cúp c2
PQFSize
Trả về kích thước theo byte của cột được liên kết
int pqfsize (const pgresult *res,
pqfsize
Trả về
PQBinaryTuples
Trả về 1 nếuPGRESULTChứa dữ kèo bóng đá cúp c2 nhị phân và 0 nếu nó chứa dữ kèo bóng đá cúp c2 văn bản.
int pqbinarytuples (const pgresult *res);
Hàm này được kèo bóng đá cúp c2 dùng nữa (ngoại trừ việc sử dụng nó trongCopy), bởi vìPGRESULTĐể chứa dữ kèo bóng đá cúp c2 văn bản trong một sốPQFFormat
được ưu tiên.PQBinaryTuples
Chỉ trả lại 1 nếu tất cả
PQGetValue
Trả về kèo bóng đá cúp c2 giá trị trường duy nhất của kèo bóng đá cúp c2 hàng của APGRESULT. Hàng và cộtPGRESULTXử lý được chuyển choPQClear
.
Char *pqgetValue (const pgresult *res,
Đối với dữ kèo bóng đá cúp c2 ở định dạng văn bản, giá trị được trả về bởiPQGetValue
là aTYPSEND
vàTyPreceive
chức năng. (Giá trị là
kèo bóng đá cúp c2 chuỗi trống được trả về nếu giá trị trường làPQGetisNull
đến
Con trỏ được trả về bởiPQGetValue
Điểm để lưu trữ đó làPGRESULTCấu trúc. Người ta kèo bóng đá cúp c2 nên sửa đổi dữ liệu mà nó trỏ đến,PGRESULTCấu trúc chính nó.
PQGetisNull
Kiểm tra kèo bóng đá cúp c2 trường cho giá trị null. Các số hàng và cột
int pqgetisnull (const pgresult *res,
Hàm này trả về 1 nếu trường là null và 0 nếuPQGetValue
Sẽ trả về kèo bóng đá cúp c2 chuỗi trống,
PQGetLpm
Trả về chiều dài thực của giá trị trường tính bằng byte.
int pqetlength (const pgresult *res,
Đây là độ dài dữ kèo bóng đá cúp c2 thực tế cho dữ kèo bóng đá cúp c2 cụ thểPQGetValue
. Cho dữ kèo bóng đá cúp c2 văn bảnstrlen ()
. Đối với định dạng nhị phân này làkèo bóng đá cúp c2dựa vàopqfsize
Để có được dữ kèo bóng đá cúp c2 thực tế
pqnparams
Trả về số lượng tham số của kèo bóng đá cúp c2 đã chuẩn bị
int pqnparams (const pgresult *res);
Hàm này chỉ hữu ích khi kiểm tra. Cho các loại khác của
PQParamType
Trả về kiểu dữ kèo bóng đá cúp c2 của câu lệnh được chỉ định
oid pqparamtype (const pgresult *res, int param_number);
Hàm này chỉ hữu ích khi kiểm tra. Cho các loại khác của
PQPrint
In ra tất cả các hàng và, tùy chọn, cột
void pqprint (tệp *fout, / *luồng đầu ra * /
Hàm này trước đây được sử dụng bởiPSQLĐể in kết quả truy vấn, nhưng
Các chức năng này được sử dụng để trích xuất thông tin khác từPGRESULTĐối tượng.
PQCMDSTATUS
Trả về thẻ trạng thái lệnh từ lệnh SQLPGRESULT.
char *pqcmdstatus (pgresult *res);
Thông thường đây chỉ là tên của lệnh, nhưng nópgresultXử lý được chuyển choPQClear
.
PQCMDTUMPLES
Trả về số lượng hàng bị ảnh hưởng bởi SQL
char *pqcmdtuples (pgresult *res);
Hàm này trả về kèo bóng đá cúp c2 chuỗi chứa sốSQLCâu lệnh đã tạoPGRESULT. Chức năng này có thểChọn, Tạo bảng, Chèn, Cập nhật, Xóa,
Di chuyển, FetchhoặcCopycâu lệnh hoặc kèo bóng đá cúp c2kèo bóng đá cúp c2của aChèn, Cập nhật,,XóaTuyên bố. NếuPGRESULTlà bất cứ điều gì khác,PQCMDTUMPLES
Trả về anPGRESULTXử lý được chuyển choPQClear
.
PQOIDVALUE
Trả về OID của hàng được chèn, nếuSQLLệnh làChènđã chèn chính xác kèo bóng đá cúp c2kèo bóng đá cúp c2của kèo bóng đá cúp c2 truy vấn đã chuẩn bị có chứaChènCâu lệnh.kèo bóng đá cúp c2 hợp lệ. Chức năng này cũng sẽ trở lạikèo bóng đá cúp c2 hợp lệNếu bảng bị ảnh hưởngChènCâu lệnh kèo bóng đá cúp c2
oid pqoidValue (const pgresult *res);
PQOIDSTATUS
Trả về kèo bóng đá cúp c2 chuỗi với oid của hàng được chèn, nếuSQLlệnh làChènđã chèn chính xác kèo bóng đá cúp c2kèo bóng đá cúp c2của kèo bóng đá cúp c2 người chuẩn bịChèn. (Chuỗi sẽ là0NếuChènkèo bóng đá cúp c2 chèn chính xác một hàng hoặc nếu bảng đíchChèn, trả về kèo bóng đá cúp c2 chuỗi trống.
char *pqoidstatus (const pgresult *res);
Hàm này kèo bóng đá cúp c2 được ủng hộPQOIDVALUE
. Nó kèo bóng đá cúp c2 an toàn.
pqescapeliteral
Char *pqescapeliteral (pgconn *Conn, const char *str, size_t length);
pqescapeliteral
Escapespqescapeliteral
Thực hiện điều này
pqescapeliteral
Trả vềstrtham số trong bộ nhớ được phân bổ vớimalloc ()
. Ký ức này nên được giải phóngpqfreemem ()
Khilength. (Nếu một byte chấm dứt bằng kèo bóng đá cúp c2lengthbyte làpqescapeliteral
dừng ở số 0; Hành vi như vậy giống nhưstrncpy
.) Chuỗi trả vềkèo bóng đá cúp c2Trình phân tích cú pháp theo nghĩa đen. MỘTkèo bóng đá cúp c2Chuỗi nghĩa đen là
ON Lỗi,pqescapeliteral
returnnullVà kèo bóng đá cúp c2 thông điệp phù hợp được lưu trữ trongConnĐối tượng.
Tip:Điều đặc biệt quan trọng là phải làm"SQL tiêm"Tấn công
Lưu ý rằng kèo bóng đá cúp c2 cần thiết cũng kèo bóng đá cúp c2 đúngPQExecparams
hoặc các thói quen anh chị em của nó.
pqescapeidentifier
67044_67119
pqescapeidentifier
thoát kèo bóng đá cúp c2 chuỗi để sử dụng làm định danh SQL, chẳng hạn như A
pqescapeidentifier
Trả về phiên bản củastrtham số thoát ra như kèo bóng đá cúp c2 định danh SQL trong bộ nhớmalloc ()
.pqfreemem ()
Khi kết quả là kèo bóng đá cúp c2length. (Nếu một byte chấm dứt bằng kèo bóng đá cúp c2LEGNByte làpqescapeidentifier
dừng ở số 0;strncpy
.) Chuỗi trả về có tất cả
ON Lỗi,pqescapentifier
returnnullVà kèo bóng đá cúp c2 thông điệp phù hợp được lưu trữ trongConnĐối tượng.
Tip:Như với các chuỗi chữ, để ngăn chặn
pqescapestringConn
size_t pqescapestringconn (pgconn *Conn,
pqescapestringConn
Escapes Chuỗi nghĩa đen, giống nhưpqescapeliteral
. kèo bóng đá cúp c2 giống nhưpqescapeliteral
, người gọi làpqescapestringConn
kèo bóng đá cúp c2 tạo rakèo bóng đá cúp c2Chuỗi chữ; họtừchỉ vào ký tự đầu tiên củaLEGNTham số cung cấp số lượnglength. (Nếu một byte chấm dứt bằng kèo bóng đá cúp c2LEGNbyte làpqescapestringConn
dừng ở số 0;strncpy
.)đếnsẽ chỉ vào bộ đệm có thể giữ ít nhất kèo bóng đá cúp c2length, nếu kèo bóng đá cúp c2 thì hành vi làđếnvàtừChuỗi chồng chéo.
NếuERRORTham số lànull, sau đó*Lỗiđược đặt thành kèo bóng đá cúp c2 thành công, kèo bóng đá cúp c2ConnĐối tượng, có hay kèo bóng đá cúp c2ERRORlànull.
pqescapestringConn
Trả về số byte được viết thànhđến, kèo bóng đá cúp c2 bao gồm số 0 chấm dứt
pqescapestring
pqescapestring
là kèo bóng đá cúp c2pqescapestringConn
.
size_t pqescapestring (char *to, const char *từ, size_t length);
Sự khác biệt duy nhất so vớipqescapestringConn
làpqescapestring
kèo bóng đá cúp c2 lấyPGConnhoặcERRORtham số. Vì điều này, nónó có thể cung cấp. Ngoài ra, nó kèo bóng đá cúp c2 có cách nào để báo cáo lỗi
pqescapestring
có thểkèo bóng đá cúp c2Kết nối tại"Phía sau hậu trường"). TRONGpqescapestringConn
.
pqescapyteaconn
thoát dữ kèo bóng đá cúp c2 nhị phân để sử dụng trong lệnh SQL cóbytea. Như vớipqescapestringConn
, Đây là
Char kèo bóng đá cúp c2 dấu *pqescapyteaconn (PGConn *Conn,
Giá trị byte nhất định phải được thoát khi được sử dụng như kèo bóng đá cúp c2 phầnbyteatheo nghĩa đen trong kèo bóng đá cúp c2SQLcâu lệnh.pqescapyteaconn
EscapesPhần 8.4cho
ThetừĐiểm tham sốfrom_lengthTham sốto_lengthĐiểm tham số
pqescapyteaconn
Trả về phiên bản thoát củatừChuỗi nhị phân tham số trong bộ nhớmalloc ()
.pqfreemem ()
Khi kết quả là kèo bóng đá cúp c2kèo bóng đá cúp c2Trình phân tích cú pháp theo nghĩa đen,byteaHàm đầu vào. MỘTkèo bóng đá cúp c2Chuỗi chữ kèo bóng đá cúp c2
Khi lỗi, kèo bóng đá cúp c2 con trỏ null được trả về và kèo bóng đá cúp c2ConnĐối tượng. Hiện tại, duy nhất
pqescapytea
pqescapytea
là kèo bóng đá cúp c2pqescapyteaconn
.
Char kèo bóng đá cúp c2 dấu *pqescapytea (const unsign char *từ,
Sự khác biệt duy nhất so vớipqescapyteaconn
làpqescapytea
kèo bóng đá cúp c2 lấyPGConnTham số. Vìpqescapytea
Có thểkèo bóng đá cúp c2Kết nối tại"Phía sau hậu trường"). Nócó thể cho saiNếu được sử dụng trong các chương trình sử dụng nhiềupqescapyteaconn
Trong những trường hợp như vậy).
PQUNESCAPHERTEA
Chuyển đổi biểu diễn chuỗi của dữ kèo bóng đá cúp c2 nhị phân thànhPQESCAPHYTEA
. Điều này là cần thiết khibyteaDữ kèo bóng đá cúp c2 trong văn bản
78375_78456
ThetừĐiểm tham sốPQGetValue
Khi áp dụng cho AbyteaCột.PQUNESCAPHERTEA
Chuyển đổi chuỗi nàymalloc ()
hoặcnulltrên lỗi và đặt kích thước củato_length. CácPQFREEMEM
Khi nó kèo bóng đá cúp c2 còn nữa
Chuyển đổi này kèo bóng đá cúp c2 chính xác là nghịch đảo củapqescapytea
, vì"Escaped"Khi nhận được từPQGetValue
. Đặc biệt điều này có nghĩa làPGConntham số.