Thực thi soi kèo bóng đá truoctran Chức năng

• PQEXECGửi soi kèo bóng đá truoctran cho Postgres. Trả về một con trỏ pgresult nếu soi kèo bóng đá truoctran thành công hoặc NULL nếu không. Nếu một null được trả lại, pqerrormessage có thể được sử dụng để có thêm thông tin về lỗi.

  PGRESULT *PQEXEC (PGCONN *Conn,
                   Char *soi kèo bóng đá truoctran);

  ThepgresultCấu trúc đóng gói kết quả soi kèo bóng đá truoctran được trả về bởi phần phụ trợ.libpqlập trình viên nên cẩn thận để duy trì Pgresult trừu tượng. Sử dụng các chức năng của người truy cập được mô tả dưới đây để Lấy kết quả của soi kèo bóng đá truoctran. Tránh trực tiếp tham khảo các lĩnh vực của cấu trúc pgresult vì chúng có thể thay đổi Tương lai.

• PQResultstatusTrả về kết quả trạng thái của soi kèo bóng đá truoctran. PQResultstatus có thể trả lại một trong những Giá trị sau:

  PGRES_EMPTY_Query,
  Pgres_command_ok, / * soi kèo bóng đá truoctran là một lệnh * /
  Pgres_tuples_ok, / * soi kèo bóng đá truoctran trả về thành công các bộ dữ liệu * / /
  Pgres_copy_out,
  Pgres_copy_in,
  PGRES_BAD_RESPONSE, / * đã nhận được phản hồi bất ngờ * / /
  Pgres_nonfatal_error,
  Pgres_fatal_error

  Nếu trạng thái kết quả là pgres_tuples_ok, thì sau đó Các thói quen có thể được sử dụng để truy xuất các bộ dữ liệu được trả về bởi soi kèo bóng đá truoctran.

• PQNTUMPLESTrả về số lượng của Tuples (phiên bản) trong kết quả soi kèo bóng đá truoctran.

  int pqntuples (pgresult *res);

• PQNFieldsTrả về số lượng của Các trường (thuộc tính) trong kết quả soi kèo bóng đá truoctran.

  int pqnfields (pgresult *res);

• pqfnameTrả về trường (thuộc tính) Tên được liên kết với chỉ mục trường đã cho. Cánh đồng Chỉ số bắt đầu ở 0.

  char *pqfname (pgresult *res,
                int field_index);

• PQFNumberTrả về trường (thuộc tính) Chỉ mục được liên kết với tên trường đã cho.

  int pqfnumber (pgresult *res,
                char* field_name);

• PQFTYPETrả về loại trường liên kết với chỉ số trường đã cho. Số nguyên được trả về là một mã hóa nội bộ soi kèo bóng đá truoctran loại. Chỉ số trường bắt đầu ở 0.

  oid pqfttype (pgresult *res,
              int field_num);

• pqfsizeTrả về kích thước bằng byte soi kèo bóng đá truoctran Trường liên kết với chỉ số trường đã cho. Nếu kích thước Trả về là -1, trường là trường độ dài thay đổi. Cánh đồng Chỉ số bắt đầu ở 0.

  INT2 PQFSIZE (PGRESULT *RES,
                             int field_index);

• PQGetValueTrả về trường (thuộc tính) giá trị. Đối với hầu hết các soi kèo bóng đá truoctran, giá trị được trả về bởi PQGetValue là một đại diện chuỗi ASCII kết thúc giá trị thuộc tính. Nếu soi kèo bóng đá truoctran là kết quả của một nhị phân con trỏ, sau đó giá trị được trả lại bởi pqgetValue là nhị phân biểu diễn loại trong định dạng nội bộ của Máy chủ phụ trợ. Trách nhiệm của Lập trình viên đối với Cast và chuyển đổi dữ liệu thành loại C chính xác. Giá trị được trả lại bởi pqgetValue chỉ vào lưu trữ là một phần của pgresult kết cấu. Người ta phải sao chép một cách rõ ràng giá trị vào Lưu trữ nếu nó được sử dụng trong suốt cuộc đời của pgresult cấu trúc chính nó.

  Char * PQGetValue (pgresult * res,
                   int tup_num,
                   int field_num);

• PQGetLpmTrả về chiều dài soi kèo bóng đá truoctran a trường (thuộc tính) trong byte. Nếu trường là một varlena struct, Độ dài được trả lại ở đây không bao gồm trường kích thước soi kèo bóng đá truoctran varlena, tức là, nó ít hơn 4 byte.

  int PQGetLpm (pgresult *res,
                                int tup_num,
                                int field_num);

• PQCMDSTATUSTrả về lệnh Trạng thái được liên kết với lệnh soi kèo bóng đá truoctran cuối cùng.

  char *pqcmdstatus (pgresult *res);

• PQOIDSTATUSTrả về một chuỗi với ID đối tượng của tuple được chèn nếu soi kèo bóng đá truoctran cuối cùng là Lệnh chèn. Nếu không, trả về một chuỗi trống.

  char * pqoidstatus (pgresult * res);

• PQPRINTTUMPLESIn ra tất cả Tuples và, tùy chọn, tên thuộc tính cho được chỉ định Luồng đầu ra. Các chương trình PSQL và giám sát cả hai đều sử dụng Pqprinttuples cho đầu ra.

  VOID PQPRINTTUMPLES (
                       Pgresult* res,
                       Tệp* fout, /* luồng đầu ra* /
                       int printattname,/* in tên thuộc tính hoặc không*//
                       int terseOutput, /* thanh phân cách hoặc không?* / /
                       int chiều rộng /* chiều rộng soi kèo bóng đá truoctran cột, chiều rộng biến nếu 0* /
                       );

• PQCleargiải phóng bộ lưu trữ được liên kết với pgresult. Mọi kết quả soi kèo bóng đá truoctran nên được giải phóng đúng cách Khi nó không còn được sử dụng. Không làm điều này sẽ dẫn đến rò rỉ bộ nhớ trong ứng dụng frontend.

  VOID PQCLEAR (pqresult *res);