30.10. Các chức năng kèo chấp bóng đá hôm nay

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

void pqfreemem (void *ptr);

10265_10293libpq, đặc biệtpqescapyteaconn, pqescapytea, PQUNESCAPHERTEAvàpqnotifyes. Nó đặc biệt quan trọng rằng kèo chấp bóng đá hôm nay 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 kèo chấp bóng đá hôm nay nền tảng Windows không 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 chấp bóng đá hôm nay cấu trúc dữ liệu được phân bổ bởiPQConnDefaultshoặcPQConnInfoparse.

11527_11596

Một đơn giảnpqfreememWill không làm cho điều này, vì mảng chứa kèo chấp bóng đá hôm nay tài liệu tham khảo đế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);

12216_12318thay đổi mật khẩu joe người dùng 'PWD'. Nó là tốt Thực hành không gửi mật khẩu Cleartext gốc trong một lệnh như vậy, bởi vì nó có thể được phơi bày trong lệnh Nhật ký, hoạt động hiển thị, v.v. Thay vào đó, sử dụng điều này chức năng chuyển đổi mật khẩu thành biểu mẫu được mã hóa trước nó được gửi đi. kèo chấp bóng đá hôm nay đối số là mật khẩu Cleartext và Tên SQL của người dùng. Giá trị trả về là một Chuỗi được phân bổ bởimalloc,, hoặcnullNếu ra khỏi bộ nhớ. kèo chấp bóng đá hôm nay người gọi có thể giả sử chuỗi không chứa bất kỳ đặc biệt nào kèo chấp bóng đá hôm nay 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.

13483_13568

Đây làlibpq's kèo chấp bóng đá hôm nay nội bộ để phân bổ và khởi tạo trốngPGRESULTĐối tượng. kèo chấp bóng đá hôm nay này Trả về null nếu bộ nhớ không thể được phân bổ. Nó là xuất khẩu vì một số ứng dụng thấy nó hữu ích Tạo các đối tượng kết quả (đặc biệt là các đối tượng có lỗi tình trạng) bản thân. Nếu nhưConnIS kèo chấp bóng đá hôm nay phải null vàstatuschỉ ra một Lỗi, thông báo lỗi hiện tại của được chỉ định Kết nối được sao chép vàopgresult. Ngoài ra, nếuConnkèo chấp bóng đá hôm nay phải là NULL, mọi quy trình sự kiện Đã đăng ký trong kết nối được sao chép vàopgresult. (Họ kèo chấp bóng đá hôm nay nhận đượcPGEVT_RESULTCREATEcuộc gọi, nhưng xemPQFireresultCreateEvents.) 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ó.

FIRES APGEVT_RESULTCREATESự kiện (xemPhần 30.12) Đối với mỗi quy trình sự kiện được đăng ký trongpgresultĐối tượng. Trả về kèo chấp bóng đá hôm nay phải cho Thành công, kèo chấp bóng đá hôm nay nếu có bất kỳ thủ tục sự kiện nào thất bại.

15378_15454

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

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

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

Tạo một bản sao của ApgresultĐối tượng. Bản sao kèo chấp bóng đá hôm nay được liên kết với kết quả nguồn trong bất kỳ cách vàPQClearPhải được gọi khi bản sao kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay. (Đ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 chấp bóng đá hôm nay được sao chép.)

Đặt kèo chấp bóng đá hôm nay thuộc tính của APGRESULTĐối tượng.

18133_18230

được cung cấpAttdescslà sao chép vào kết quả. NếuAttdescsCon trỏ là null hoặcnumattributnhỏ hơn một, Yêu cầu bị bỏ qua và kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay không thành công, giá trị trả về bằng không. Nếu kèo chấp bóng đá hôm nay 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.

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

kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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,, Giá trị trường sẽ được đặt thành SQLnull. Thegiá trị19977_20214

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 chấp bóng đá hôm nay này sẽ được giải phóng khiresđược xóa. Nếu chức năng kèo chấp bóng đá hôm nay thành công, giá trị trả về lànull20836_20940malloc.