31.11. Các chức năng soi kèo bóng đá truoctran

Bộ nhớ giải phóng được phân bổ bởilibpq.

void pqfreemem (void *ptr);

Bộ nhớ giải phóng được phân bổ bởilibpq, đặc biệtpqescapyteaconn, pqescapytea, PQUNESCAPHERTEAvàpqnotifyes. Điều đặc biệt quan trọng là chức năng này, thay vìfree ()10385_10724free ().

giải phóng soi kèo bóng đá truoctran cấu trúc dữ liệu được phân bổ bởiPQConnDefaultshoặcPQConnInfoparse.

11053_11106

A Đơn giảnpqfreememsẽ soi kèo bóng đá truoctran làm điều này, vì mảng chứa các tham chiếu đến chuỗi công ty con.

Chuẩn bị mẫu được mã hóa của APostgreSQLMật khẩu.

char *pqencryptpassword (const char *passwd, const char *user);

soi kèo bóng đá truoctran này được dự định sẽ được sử dụng bởi các ứng dụng khách muốn gửi các lệnh nhưThay đổi mật khẩu Joe của người dùng 'PWD'11718_12092mallochoặcnullNếu ra khỏi bộ nhớ. Người gọi có thể giả sử chuỗi soi kèo bóng đá truoctran chứa bất kỳ ký tự đặc biệt nào yêu cầu thoát. Sử dụng12306_12317Để giải phóng kết quả khi thực hiện với nó.

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

12622_12691

Đây là12733_12740S Chức năng nội bộ để phân bổ và khởi tạo trốngpgresultĐối tượng. soi kèo bóng đá truoctran này trả vềnullNếu bộ nhớ soi kèo bóng đá truoctran thể được phân bổ. Nó được xuất vì một số ứng dụng thấy hữu ích để tạo các đối tượng kết quả (đặc biệt là các đối tượng có trạng thái lỗi). Nếu nhưConnsoi kèo bóng đá truoctran phải là null vàtrạng tháiCho biết lỗi, thông báo lỗi hiện tại của kết nối được chỉ định được sao chép vàopgresult. Ngoài ra, nếuConnsoi kèo bóng đá truoctran phải là null, bất kỳ quy trình sự kiện nào được đăng ký trong kết nối được sao chép vàopgresult. (Họ soi kèo bóng đá truoctran nhận đượcPGEVT_RESULTCREATEcuộc gọi, nhưng xemPQFireresultCreateEvents.) Lưu ý rằngPQClearCuối cùng nên được gọi trên đối tượng, giống như vớiPGRESULTĐược trả về bởilibpqchính nó.

Hỏa hoạn APGEVT_RESULTCREATESự kiện (xemPhần 31.13) cho mỗi quy trình sự kiện được đăng ký trongpgresultĐối tượng. Trả về soi kèo bóng đá truoctran phải cho thành công, soi kèo bóng đá truoctran, nếu có bất kỳ thủ tục sự kiện nào thất bại.

14233_14293

TheConnĐối số được chuyển qua các thủ tục sự kiện nhưng soi kèo bóng đá truoctran được sử dụng trực tiếp. Nó có thể lànullNếu quy trình sự kiện sẽ soi kèo bóng đá truoctran sử dụng nó.

Quy trình sự kiện đã nhận đượcPGEVT_RESULTCREATEhoặcPGEVT_RESULTCOPYSự kiện cho đối tượng này soi kèo bóng đá truoctran bị bắn nữa.

Lý do chính mà chức năng này tách biệt vớiPQMakeMpTypgresultCó phải là soi kèo bóng đá truoctran phù hợp để tạopgresultvà điền vào dữ liệu trước khi gọi soi kèo bóng đá truoctran quy trình sự kiện.

Tạo một bản sao của ApgresultĐối tượng. Bản sao soi kèo bóng đá truoctran được liên kết với kết quả nguồn theo bất kỳ cách nào vàPQClearphải được gọi khi bản sao soi kèo bóng đá truoctran còn cần thiết. Nếu chức năng soi kèo bóng đá truoctran thành công,nullđược trả về.

pgresult *pqcopyresult (const pgresult *src, int flags);

Điều này soi kèo bóng đá truoctran nhằm tạo một bản sao chính xác. Kết quả trả về luôn được đặt vàoPGRES_TUDS_OKtrạng thái và soi kèo bóng đá truoctran sao chép bất kỳ thông báo lỗi nào trong nguồn. (Tuy nhiên, nó sao chép chuỗi trạng thái lệnh.)15670_15677Đối số xác định những gì khác được sao chép. Nó là một chút hoặc của một số cờ.PG_COPYRES_ATTRSChỉ định sao chép soi kèo bóng đá truoctran thuộc tính của kết quả nguồn (định nghĩa cột).pg_copyres_tuplesChỉ định sao chép soi kèo bóng đá truoctran bộ dữ liệu của kết quả nguồn. (Điều này cũng ngụ ý sao chép soi kèo bóng đá truoctran thuộc tính.)pg_copyres_noticehooksChỉ định sao chép soi kèo bóng đá truoctran móc thông báo của kết quả nguồn.pg_copyres_eventsChỉ định sao chép các sự kiện của kết quả nguồn. (Nhưng bất kỳ dữ liệu thể hiện nào được liên kết với nguồn soi kèo bóng đá truoctran được sao chép.)

Đặt soi kèo bóng đá truoctran thuộc tính của APGRESULTĐối tượng.

16495_16576

được cung cấpAttdescsđược sao chép vào kết quả. NếuAttdescsCon trỏ lànullhoặcnumattributnhỏ hơn một, yêu cầu bị bỏ qua và chức năng thành công. Nếu nhưresĐã chứa các thuộc tính, soi kèo bóng đá truoctran sẽ bị lỗi. Nếu soi kèo bóng đá truoctran không thành công, giá trị trả về bằng không. Nếu soi kèo bóng đá truoctran thành công, giá trị trả về không khác.

Đặt giá trị trường Tuple của ApgresultĐối tượng.

int pqsetValue (pgresult *res, int tup_num, int field_num, char *value, int len);

soi kèo bóng đá truoctran sẽ tự động phát triển mảng Tuples nội bộ của kết quả khi cần thiết. Tuy nhiên,TUP_NUMĐối số phải nhỏ hơn hoặc bằngPQNTUMPLES, có nghĩa là soi kèo bóng đá truoctran này chỉ có thể phát triển mảng Tuples một tuple cùng một lúc. Nhưng bất kỳ trường nào của bất kỳ tuple hiện có có thể được sửa đổi theo bất kỳ thứ tự nào. Nếu một giá trị tạifield_numĐã tồn tại, nó sẽ bị ghi đè. Nếu nhưlenlà -1 hoặcgiá trịlànull, giá trị trường sẽ được đặt thành giá trị null SQL. Thegiá trịđược sao chép vào bộ nhớ riêng của kết quả, do đó không còn cần thiết sau khi chức năng trở lại. Nếu soi kèo bóng đá truoctran không thành công, giá trị trả về bằng không. Nếu soi kèo bóng đá truoctran thành công, giá trị trả về không khác.

Phân bổ lưu trữ công ty con cho APGRESULTĐối tượng.

void *pqresultalloc (pgresult *res, size_t nbytes);

Bất kỳ bộ nhớ nào được phân bổ với chức năng này sẽ được giải phóng khiresđược xóa. Nếu soi kèo bóng đá truoctran không thành công, giá trị trả về lànull. Kết quả được đảm bảo được căn chỉnh đầy đủ cho bất kỳ loại dữ liệu nào, giống như đối vớimalloc.

Trả lại phiên bảnlibpqĐiều đó đang được sử dụng.

int pqlibversion (void);

19060_19305PQConnectDBhoặc nếuHex byteaĐầu ra được thêm vào trong PostgreSql 9.0 được hỗ trợ.

Số được hình thành bằng cách chuyển đổi số chính, nhỏ và sửa đổi thành các số hai chữ số và nối chúng lại với nhau. Ví dụ: phiên bản 9.1 sẽ được trả về dưới dạng 90100 và phiên bản 9.1.2 sẽ được trả về vì 90102 (soi kèo bóng đá truoctran được hiển thị 0).