Phiên bản được hỗ trợ:hiện tại(17)16/15/14/13
Phiên bản phát triển:Devel
Phiên bản kèo bóng đá pháp được hỗ trợ:12/11/10/9.6/9.5/9.4/9.3/9.2/9.1/9.0/8.4/8.3/8.2/8.1/8.0/7.4/7.3/7.2/7.1
Tài liệu này dành cho phiên bản không được hỗ trợ của kèo bóng đá pháp.
Bạn có thể muốn xem cùng một trang chohiện tạiPhiên bản hoặc một trong kèo bóng đá pháp phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

kèo bóng đá pháp1.3.

Một khi kết nối với máy chủ cơ sở dữ liệu đã thành công

1.3.1. kèo bóng đá pháp thói quen chính

  • PQEXECGửi kèo bóng đá pháp cho

    PGRESULT *PQEXEC (PGCONN *Conn,

    Trả về ApgresultCon trỏPGRES_FATAL_ERRORKết quả. Sử dụngpqerrormessageĐể có thêm

ThepgresultCấu trúclibpqlập trình viên ứng dụng nên cẩn thậnpgresultTrừu tượng. Sử dụng kèo bóng đá pháp 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ểkèo bóng đá pháp6.4, định nghĩa củastruct pgresultthậm chí kèo bóng đá pháp được cung cấp tronglibpq-fe.h. Nếu bạn có mã cũpgresultTrường trực tiếp,libpq-int.hquá, nhưng bạn được khuyến khích sửa chữa

  • PQResultstatusTrả về

    12652_12706

    PQResultstatusCó thể trả lại

    • pgres_empty_query- The

    • PGRES_COMMAND_OK-

    • PGRES_TUDS_OK- The

    • PGRES_COPY_OUT- Sao chép ra

    • PGRES_COPY_IN- Sao chép vào

    • pgres_bad_response- The

    • PGRES_NONFATAL_ERROR

    • PGRES_FATAL_ERROR

    Nếu trạng thái kết quả làPGRES_TUDS_OK, sau đó kèo bóng đá pháp thói quen được mô tảPGRES_TUDS_OK.PGRES_COMMAND_OKlà cho kèo bóng đá pháp lệnh có thểpgres_empty_querythường phơi bày a

  • pqresstatusChuyển đổiPQResultstatusthành hằng số chuỗi

    char *pqresstatus (trạng thái execstatusType);
  • pqresulterrormessageTrả về thông báo lỗi được liên kết với truy vấn hoặc một

    char *pqresulterrormessage (const pgresult *res);

    ngay sau APQEXEChoặcPQGetResultCALL,pqerrormessage(trên kết nối) sẽpqresulterrormessage(về kết quả).pgresultsẽ giữ lạipqresulterrormessageKhi bạn muốnpgresult; sử dụngpqerrormessageKhi bạn muốn biết

  • PQCleargiải phóng bộ lưu trữpgresult.PQClearKhi nó kèo bóng đá pháp còn cần thiết nữa.

    VOID PQCLEAR (pqresult *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 đá pháp điPQClear. kèo bóng đá pháp làm điều này sẽ kết quả

  • PQMakeMpTypgresultXây dựng trốngPGRESULTĐối tượng có trạng thái đã cho.

    16967_17038

    Đây làlibpq'spgresultĐối tượng. Nó được xuất khẩuConnkèo bóng đá pháppgresult.Lưu ý rằngPQClearCuối cùng nên được gọipgresultĐược trả về bởilibpqchính nó.

1.3.2. Thoát khỏi dây cho

pqescapestringConnthoát apqescapestringConnThực hiện thao tác này.

Tip:Điều đặc biệt quan trọng là phải làm đúng"SQLkèo bóng đá pháp cuộc tấn công trong đó kèo bóng đá pháp lệnh SQL không mong muốn là

size_t pqescapestringconn (pgconn *Conn,

pqescapestringConnViết mộttừchuỗi thànhđếnbộ đệm,kèo bóng đá phápChuỗitừchỉ vàolengthTham số cholength. (Nếu tìm thấy một byte chấm dứt bằng kèo bóng đá pháplengthByte làpqescapestringConndừng ở số 0; Hành vi như vậy giống nhưstrncpy.)đếnsẽ chỉ vào bộ đệm có khả kèo bóng đá phápLEGN, nếu kèo bóng đá pháp thì hành viđếntừChuỗi chồng chéo.

NếuERRORtham số thì kèo bóng đá pháp*Lỗiđược đặt thành 0 trênConnĐối tượng, có hay kèo bóng đá phápERRORlà null.

pqescapestringConnTrả vềđến,,

size_t pqescapestring (char *to, const char *từ, size_t length);

pqescapestringpqescapestringConn; Sự khác biệt là nóConnhoặcERRORtham số. VìNó có thể cho sai. Ngoài ra, nó kèo bóng đá pháp có cách nào để báo cáo lỗi

pqescapestringcó thể được sử dụngkèo bóng đá phápKết nối tại a"Phía sau hậu trường"). Trong khácpqescapestringConn.

1.3.3. Thoát khỏi chuỗi nhị phân cho

pqescapyteaconn

thoát dữ liệu nhị phân để sử dụng trong kèo bóng đá pháp SQL với kèo bóng đá pháp SQL vớibytea.

Char kèo bóng đá pháp dấu *pqescapyteaconn (PGConn *Conn,

Giá trị byte nhất địnhphảiđược thoát ra (nhưng tất cảCANđược thoát) khi được sử dụng như một phần củabyteanghĩa đen trong mộtSQLTuyên bố. Nói chung, để trốn thoát') và Backslash (\) kèo bóng đá pháp ký tự có sự thay thế đặc biệtpqescapyteaconnThực hiện điều này

ThetừTham sốfrom_lengthTham số cho sốto_lengththam số trỏ đến a

pqescapyteaconnTrả về phiên bản thoát củatừChuỗi nhị phân tham số trong bộ nhớmalloc ().free ()Khi kết quả kèo bóng đá pháp còn nữakèo bóng đá phápChuỗibyteaĐầu vàokèo bóng đá phápChuỗi chữ kèo bóng đá pháp

Khi lỗi, một con trỏ null được trả về và mộtConnĐối tượng. Hiện tại, duy nhất

pqescapytea

pqescapytealà mộtpqescapyteaconn.

Char kèo bóng đá pháp dấu *pqescapytea (char kèo bóng đá pháp dấu *từ,

Sự khác biệt duy nhất so vớipqescapyteaconnpqescapyteakèo bóng đá pháp lấyPGConnTham số. VìNó có thể cho sai. Ngoài ra, nó kèo bóng đá pháp có cách nào để trả về một lỗi

pqescapyteacó thểkèo bóng đá phápKết nối tại một thời điểm (trong trường hợp này nó có thể tìm ra những gì"Phía sau). Trong kèo bóng đá pháp bối cảnh khác, nó là một bảo mậtpqescapyteaconn.

PQUNESCAPHERTEA

Chuyển đổi biểu diễn chuỗi dữ liệu nhị phân thànhpqescapytea. Điều này là cần thiết khibyteaDữ liệu trong văn bản

27883_27958

ThetừTham sốPQGetValueKhi áp dụng chobyteacột.PQUNESCAPHERTEAChuyển đổi chuỗi nàymalloc ()hoặc null khi lỗi và đặtto_length. Kết quả phải được giải phóngfree ()Khi nó kèo bóng đá pháp

Chuyển đổi này kèo bóng đá pháp 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ố.

1.3.4. Lấy kết quả Chọn

  • PQNTUMPLESTrả về

    int pqntuples (const pgresult *res);
  • PQNFieldsTrả về

    int pqnfields (const pgresult *res);
  • PQFNAMETrả về trường

    Char *pqfname (const pgresult *res,
  • PQFNumberTrả về

    int pqfnumber (const pgresult *res,

    -1 được trả về nếu tên đã cho kèo bóng đá pháp khớp với bất kỳ

  • PQFTYPETrả về trường

    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ính củaoidS của kèo bóng đá pháp loại dữ liệu tích hợp làsrc/bao gồm/catalog/pg_type.hTrong nguồn

  • PQFMODTrả về

    int pqfmod (const pgresult *res,
  • pqfsizeTrả về kích thước

    int pqfsize (const pgresult *res,

    pqfsizeTrả về kèo bóng đá pháp gian

  • PQBinaryTuplesTrả về 1pgresultChứa nhị phân

    int pqbinarytuples (const pgresult *res);

    Hiện tại, dữ liệu Tuple nhị phân chỉ có thể được trả về bởi A

1.3.5. Lấy kết quả Chọn

  • PQGetValueTrả về aPGRESULT. Tuple và lĩnh vực

    Char * pqgetValue (const pgresult * res,

    Đối với hầu hết kèo bóng đá pháp truy vấn, giá trị được trả về bởiPQGetValuelà một ký tự kết thúc kèo bóng đá pháppqbinarytuples ()là 1, ThePQGetValuelà biểu diễn nhị phân của loại trong nội bộPQGetValueĐiểm để lưu trữ là một phầnPGRESULTCấu trúc. MộtpgresultCấu trúc chính nó.

  • PQGetisNullKiểm tra một trường

    int pqgetisnull (const pgresult *res,

    Hàm này trả về 1 nếu trường chứa null, 0PQGetValueSẽ trả về một chuỗi trống,

  • PQGetLpmTrả về

    int pqetlength (const pgresult *res,

    Đây là độ dài dữ liệu thực tế cho dữ liệu cụ thểPQGetValue. Lưu ý rằng chopqfsize.

  • PQPrintIn ra tất cả

    void pqprint (tệp* fout, /* luồng đầu ra* /Bảng ...*//Chú thích*//

    Hàm này trước đây được sử dụng bởiPSQLĐể in kết quả truy vấn, nhưng điều này

1.3.6. Lấy kết quả kèo bóng đá pháp chọn

  • PQCMDSTATUSTrả vềPGRESULT.

    char * pqcmdstatus (pgresult * res);
  • PQCMDTUMPLESTrả về

    char * pqcmdtuples (pgresult * res);

    NếuSQLkèo bóng đá phápPGRESULTwas

  • PQOIDVALUETrả vềSQLkèo bóng đá pháp là một chèn chènkèo bóng đá pháp hợp lệ.

    oid pqoidValue (const pgresult *res);

    Loạioidvà hằng sốkèo bóng đá pháp hợp lệsẽ được xác định nếu bạnlibpqTiêu đề

  • PQOIDSTATUSTrả về aSQLkèo bóng đá pháp là một0Nếu

    char * pqoidstatus (const pgresult * res);

    Chức năng này kèo bóng đá pháp được ủng hộPQOIDVALUEvà kèo bóng đá pháp an toàn cho chủ đề.