31.10. Các chức năng kèo bóng đá c1

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. Nó đặc biệt quan trọng rằng kèo bóng đá c1 này, thay vìfree (), được sử dụng trên Microsoft Windows. Điều này là do phân bổ bộ nhớ trong một DLL và phát hành nó Trong ứng dụng chỉ hoạt động nếu MultiThreaded/đơn luồng, phát hành/gỡ lỗi và cờ tĩnh/động giống nhau cho DLL và ứng dụng. Trên các nền tảng Windows kèo bóng đá c1 phải Microsoft, điều này chức năng giống như chức năng thư viện tiêu chuẩnfree ().

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

11425_11480

A Đơn giảnPQFreememWill kèo bóng đá c1 làm cho điều này, vì mảng chứa các tài liệu tham khảo đến chuỗi công ty con.

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

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

kèo bóng đá c1 này được dự định sẽ được sử dụng bởi máy khách các ứng dụng muốn gửi các lệnh nhưThay đổi mật khẩu joe của người dùng 'PWD'12204_12634malloc,, hoặcnullNếu ra khỏi bộ nhớ. Các người gọi có thể giả sử chuỗi kèo bóng đá c1 chứa bất kỳ đặc biệt nào Các nhân vật sẽ yêu cầu trốn thoát. Sử dụngPQFreememĐể giải phóng kết quả khi hoàn thành với nó.

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

13263_13334

Đây làlibpq's kèo bóng đá c1 nội bộ để phân bổ và khởi tạo trốngpgresultĐối tượng. kèo bóng đá c1 này trả vềnull13573_13773Connkèo bóng đá c1 phải là null vàtrạng tháiCho biết lỗi, hiện tại Thông báo lỗi của kết nối được chỉ định được sao chép vào Thepgresult. Ngoài ra, nếuConnkèo bóng đá c1 phải là null, bất kỳ sự kiện nào Các thủ tục đã đăng ký trong kết nối được sao chép vàoPGRESULT. (Họ kèo bóng đá c1 nhận đượcPGEVT_RESULTCREATE14272_14298PQFireresultCreateEvents.) Lưu ý rằngPQClearnên cuối cùng đượ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 (xemPostgreSQL:) Đối với mỗi quy trình sự kiện được đăng ký trongpgresultĐối tượng. Trả về kèo bóng đá c1 phải cho Thành công, kèo bóng đá c1 nếu có bất kỳ thủ tục sự kiện nào thất bại.

15122_15184

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

Quy trình sự kiện đã nhận đượcPGEVT_RESULTCREATEhoặcPGEVT_RESULTCOPY15574_15627

Lý do chính mà kèo bóng đá c1 này tách biệt vớiPQMakeMpTypgresultlà như vậy nó thường thích hợp để tạo mộtpgresultvà điền vào dữ liệu trước đó gọi kèo bóng đá c1 thủ tục sự kiện.

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

PGRESULT *PQCOPYRESULT (const pgresult *src, int flags);

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

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

17782_17865

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

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

18703_18787

kèo bóng đá c1 sẽ tự động phát triển kết quả mảng bộ dữ liệu nội bộ khi cần thiết. Tuy nhiên,TUP_NUMĐối số phải nhỏ hơn hoặc bằngPQNTUMPLES, Ý nghĩa kèo bóng đá c1 này chỉ có thể phát triển mảng Tuples một tuple tại một thời gian. Nhưng bất kỳ trường nào của bất kỳ tuple hiện có nào cũng có thể được sửa đổi theo bất kỳ thứ tự. Nếu một giá trị tạifield_numđã tồn tại, nó sẽ ghi đè. Nếu nhưlenlà-1hoặcgiá trịlànull, The Giá trị trường sẽ được đặt thành giá trị null SQL. Thegiá trịđược sao chép vào Lưu trữ riêng của kết quả, do đó không còn cần thiết sau kèo bóng đá c1 trả về. Nếu kèo bóng đá c1 không thành công, việc trả lại Giá trị bằng không. Nếu kèo bóng đá c1 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 kèo bóng đá c1 này sẽ được giải phóng khiresđược xóa. Nếu chức năng kèo bóng đá c1 thành công, giá trị trả về lànull. Kết quả được đảm bảo là được căn chỉnh đầy đủ cho bất kỳ loại dữ kèo bóng đá c1 nào, giống như đối vớimalloc.