31.1. Các chức năng điều khiển kèo bóng đá euro cơ sở dữ liệu

Tạo kèo bóng đá euro mới với máy chủ cơ sở dữ liệu.

PGConn *PQConnectDbParams (const char *const *từ khóa, từ khóa,
                          const char * const * giá trị,
                          int expand_dbname);

Hàm này mở kèo bóng đá euro cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ hainull-kèo bóng đá euro thúc Mảng. Đầu tiên,Từ khóa14174_14252Giá trị, đưa ra giá trị cho mỗi từ khóa. Không giống nhưPQSetDbLoginbên dưới, The Bộ tham số có thể được mở rộng mà không thay đổi chức năng Chữ ký, vì vậy sử dụng chức năng này (hoặc kèo bóng đá euro chất tương tự không chặn của nóPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho ứng dụng mới Lập trình.

kèo bóng đá euro từ khóa tham số hiện được công nhận được liệt kê trongPhần 31.1.2.

Khiexpand_dbnamelà khác không,dbnamegiá trị từ khóa được phép được công nhận là chuỗi kèo bóng đá euro. Chỉ có sự xuất hiện đầu tiên củadbnameđược mở rộng theo cách này, bất kỳ tiếp theodbnameGiá trị được xử lý là Tên cơ sở dữ liệu đơn giản. Thêm chi tiết về chuỗi kèo bóng đá euro có thể Các định dạng xuất hiện trongPhần 31.1.1.

Mảng được truyền có thể trống để sử dụng tất cả các tham số mặc định hoặc có thể chứa một hoặc nhiều cài đặt tham số. Chúng nên được kèo bóng đá euro hợp chiều dài. Xử lý sẽ dừng lại với không phải cuối cùngnullPhần tử củaTừ khóamảng.

Nếu bất kỳ tham số nào không được xác định, thì tương ứng Biến môi trường (xemPhần 31,1415671_15780

Nói chung, kèo bóng đá euro từ khóa được xử lý từ đầu của chúng Mảng theo thứ tự chỉ mục. Hiệu quả của điều này là khi kèo bóng đá euro từ khóa được lặp lại, giá trị xử lý cuối cùng được giữ lại. Vì thế, thông qua vị trí cẩn thận củadbnameTừ khóa, có thể xác định những gì có thể bị ghi đè bởi AConninfoChuỗi và những gì có thể không.

Tạo kèo bóng đá euro mới với máy chủ cơ sở dữ liệu.

PGConn *PQConnectDB (const char *Conninfo);

Hàm này mở kèo bóng đá euro cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ chuỗiConninfo.

Chuỗi truyền có thể trống để sử dụng tất cả kèo bóng đá euro tham số mặc định hoặc nó có thể chứa một hoặc nhiều cài đặt tham số được phân tách bằng khoảng trắng hoặc nó có thể chứaURI. Nhìn thấyPhần 31.1.1cho chi tiết.

Tạo kèo bóng đá euro mới với máy chủ cơ sở dữ liệu.

PGConn *pqsetdblogin (const char *pghost,
                     const char *pgport,
                     const char *pgoptions,
                     const char *pgtty,
                     const char *dbname,
                     const char *đăng nhập,
                     const char *pwd);

Đây là tiền thân củaPQConnectDBVới một bộ tham số cố định. Nó có cùng chức năng ngoại trừ kèo bóng đá euro tham số bị thiếu sẽ Luôn luôn nhận kèo bóng đá euro giá trị mặc định. Viếtnullhoặc một chuỗi trống cho bất kỳ một trong kèo bóng đá euro tham số cố định được mặc định.

Nếudbnamechứa=dấu hiệu hoặc có kèo bóng đá euro hợp lệURItiền tố, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như thể nó đã được truyền choPQConnectDB, và kèo bóng đá euro tham số còn lại sau đó được áp dụng theo quy định choPQConnectDBParams.

Tạo kèo bóng đá euro mới với máy chủ cơ sở dữ liệu.

18271_18425

Đây là một macro gọiPQSetDbLoginvới kèo bóng đá euro con trỏ null choĐăng nhậpvàPWDtham số. Nó được cung cấp để tương thích ngược với rất cũ chương trình.

Tạo kèo bóng đá euro với máy chủ cơ sở dữ liệu trong không chặn thái độ.

PGConn *PQConnectStartParams (Const Char *Const *Từ khóa,
                             const char * const * giá trị,
                             int expand_dbname);

Pgconn *pqconnectStart (const char *conninfo);

PostgrespollingStatusType PQConnectPoll (PGConn *Conn);

Ba chức năng này được sử dụng để mở kèo bóng đá euro với A máy chủ cơ sở dữ liệu sao cho chủ đề thực thi của ứng dụng của bạn là Không bị chặn trên I/O từ xa trong khi làm như vậy. Quan điểm của điều này cách tiếp cận là sự chờ đợi cho I/O hoàn thành có thể xảy ra trong vòng chính của ứng dụng, thay vì xuống bên trongPQConnectDBParamshoặcPQConnectDB, và vì vậy ứng dụng có thể quản lý Hoạt động này song song với kèo bóng đá euro hoạt động khác.

vớiPQConnectStartParams, The kèo bóng đá euro cơ sở dữ liệu được thực hiện bằng các tham số được lấy từTừ khóavàgiá trịmảng và được kiểm soát bởiexpand_dbname, như được mô tả ở trên choPQConnectDBParams.

vớiPQConnectStart, Cơ sở dữ liệu kèo bóng đá euro được thực hiện bằng cách sử dụng các tham số được lấy từ chuỗiConninfoNhư được mô tả ở trên choPQConnectDB.

khôngPQConnectStartParamscũng khôngPQConnectStartcũng khôngPQConnectPollsẽ chặn, miễn là một số Hạn chế được đáp ứng:

• Thehostaddrvàhosttham số được sử dụng phù hợp để đảm bảo Tên và truy vấn tên ngược không được thực hiện. Xem Tài kèo bóng đá euro của các tham số này trongPhần 31.1.2cho chi tiết.

• Nếu bạn gọiPQTRACE, Đảm bảo rằng đối tượng luồng mà bạn theo dõi sẽ không chặn.

• Bạn đảm bảo rằng ổ cắm ở trạng thái thích hợp trước GọiPQConnectPoll, như mô tả dưới.

Lưu ý: Sử dụngPQConnectStartParamstương tự nhưPQConnectStarthiển thị dưới.

Để bắt đầu yêu cầu kèo bóng đá euro không chặn, hãy gọiConn = PQConnectStart ("Connection_info_String"). Nếu nhưConnlà null, sau đólibpqđã không thể phân bổ mớiPGConnCấu trúc. Nếu không, một hợp lệPGConnCon trỏ được trả về (mặc dù không Tuy nhiên, đại diện cho một kèo bóng đá euro hợp lệ với cơ sở dữ liệu). Khi trở về từPQConnectStart, gọistatus = pqstatus (Conn). Nếu nhưtrạng tháibằngConnection_Bad, PQConnectStartđã thất bại.

nếuPQConnectStartThành công, The Giai đoạn tiếp theo là thăm dò ý kiến22180_22187Vì vậy rằng nó có thể tiến hành với chuỗi kèo bóng đá euro. Sử dụngPQSocket (Conn)Để có được mô tả của Ổ cắm dưới kèo bóng đá euro cơ sở dữ liệu. Vòng lặp như vậy: nếuPQConnectPoll (Conn)Trả về lần cuốipgres_polling_reading, đợi cho đến khi Ổ cắm đã sẵn sàng để đọc (như được chỉ ra bởiselect (), poll (),, hoặc chức kèo bóng đá euro hệ thống tương tự). Sau đó gọiPQConnectPoll (Conn)Một lần nữa. Ngược lại, nếuPQConnectPoll (Conn)Đã trả về lần cuốiPGRES_POLLING_WRITY, đợi cho đến khi Ổ cắm đã sẵn sàng để viết, sau đó gọiPQConnectPoll (Conn)Một lần nữa. Nếu bạn chưa gọiPQConnectPoll, tức là, chỉ sau đó cuộc gọi đếnPQConnectStart, hành xử như Nếu nó trả về lần cuốiPGRES_POLLING_WRITY. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnPGRES_POLLING_FAILED, Cho biết kèo bóng đá euro Quy trình đã thất bại hoặcpgres_polling_ok23406_23463

Bất cứ lúc nào trong quá trình kèo bóng đá euro, trạng thái của kèo bóng đá euro có thể được kiểm tra bằng cách gọipqstatus. Nếu như Cuộc gọi này trả vềConnection_Bad23654_23720Connection_ok, sau đó kèo bóng đá euro đã sẵn sàng. Cả hai của các trạng thái này có thể phát hiện như nhau từ giá trị trả về củaPQConnectPoll, được mô tả ở trên. Khác Các quốc gia cũng có thể xảy ra trong (và chỉ trong) không đồng bộ Quy trình kèo bóng đá euro. Những điều này chỉ ra giai đoạn hiện tại của Quy trình kèo bóng đá euro và có thể hữu ích để cung cấp phản hồi cho người dùng ví dụ. Các trạng thái này là:

Lưu ý rằng, mặc dù các hằng số này sẽ vẫn còn (để duy trì khả năng tương thích), một ứng dụng không bao giờ nên dựa vào những điều này xảy ra theo một thứ tự cụ thể, hoặc hoàn toàn hoặc trên trạng thái Luôn luôn là một trong những giá trị tài kèo bóng đá euro này. Một ứng dụng có thể Làm điều gì đó như thế này:

Switch (pqstatus (Conn))

        Case Connection_started:
            Phản hồi = "kèo bóng đá euro ...";
            phá vỡ;

        Case Connection_Made:
            Phản hồi = "kèo bóng đá euro với máy chủ ...";
            phá vỡ;
.
.
.
        mặc định:
            Phản hồi = "kèo bóng đá euro ...";

TheConnect_Timeoutkèo bóng đá euro tham số bị bỏ qua khi sử dụngPQConnectPoll; nó là ứng dụng trách nhiệm quyết định xem một lượng thời gian quá mức có đã trôi qua. Nếu không thì,PQConnectStarttheo sau làPQConnectPollVòng lặp là tương đương vớiPQConnectDB.

Lưu ý rằng nếuPQConnectStartTrả về một con trỏ không null, bạn phải gọipqfinishKhi bạn kết thúc với nó, theo thứ tự để xử lý cấu trúc và bất kỳ khối bộ nhớ liên quan. Cái này phải được thực hiện ngay cả khi cố gắng kèo bóng đá euro không thành công hoặc là bị bỏ rơi.

Trả về các tùy chọn kèo bóng đá euro mặc định.

26879_27655

Trả về mảng tùy chọn kèo bóng đá euro. Điều này có thể được sử dụng để Xác định tất cả có thểPQConnectDBTùy chọn và kèo bóng đá euro giá trị mặc định hiện tại của chúng. kèo bóng đá euro điểm giá trị trả về đến một mảngPQConninFooptionCấu trúc, kèo bóng đá euro thúc bằng một mục có nullTừ khóaCon trỏ. Con trỏ null được trả lại nếu Bộ nhớ không thể được phân bổ. Lưu ý rằng kèo bóng đá euro giá trị mặc định hiện tại (ValTrường) sẽ phụ thuộc vào Biến môi trường và bối cảnh khác. Người gọi phải đối xử với Dữ liệu tùy chọn kèo bóng đá euro là chỉ đọc.

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách chuyển nó sangPQConninFofree. Nếu điều này không được thực hiện, Một lượng nhỏ bộ nhớ bị rò rỉ cho mỗi cuộc gọi đếnPQConnDefaults.

Trả về các tùy chọn kèo bóng đá euro được sử dụng bởi kèo bóng đá euro trực tiếp.

Trả về mảng tùy chọn kèo bóng đá euro. Điều này có thể được sử dụng để Xác định tất cả có thểPQConnectDBTùy chọn và các giá trị được sử dụng để kèo bóng đá euro với máy chủ. Các Trả về giá trị điểm cho một mảngPQConninFooptioncấu trúc, kèo bóng đá euro thúc bằng một mục nhập nullTừ khóaCon trỏ. Tất cả kèo bóng đá euro ghi chú ở trên choPQConnDefaultsCũng áp dụng cho kèo bóng đá euro quả củaPQConnInfo.

Trả về các tùy chọn kèo bóng đá euro phân tích cú pháp từ kèo bóng đá euro được cung cấp sợi dây.

29500_29574

Phân tích chuỗi kèo bóng đá euro và trả về các tùy chọn kết quả là một mảng; hoặc trả lạinullNếu có Vấn đề với chuỗi kèo bóng đá euro. Chức năng này có thể được sử dụng để Trích xuấtPQConnectDBTùy chọn trong Chuỗi kèo bóng đá euro được cung cấp. Giá trị trả về chỉ vào một mảng củaPQConninFooptionCấu trúc, mà kèo bóng đá euro thúc bằng một mục có nullTừ khóaCon trỏ.

Tất cả các tùy chọn pháp lý sẽ có mặt trong mảng kèo bóng đá euro quả, nhưngPQConninFooptionĐối với bất kỳ tùy chọn nào không hiện diện trong chuỗi kèo bóng đá euro sẽ cóValĐặt thànhnull; mặc định giá trị không được chèn.

nếuerrmsgkhông phảinull, sau đó*errmsgđược đặt thànhnullKhi thành công, khác vớimalloc'D chuỗi lỗi giải thích vấn đề. (Nó cũng có thể cho*errmsgđược đặt thànhnullvà chức kèo bóng đá euro trả vềnull; Điều này chỉ ra một điều kiện ngoài bộ nhớ.)

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách chuyển nó sangPQConnInfofree. Nếu điều này không được thực hiện, Một số bộ nhớ bị rò rỉ cho mỗi cuộc gọi đếnPQConnInfoparse. Ngược lại, nếu xảy ra lỗi Vàerrmsgkhông phảinull, Hãy chắc chắn giải phóng chuỗi lỗi bằng cách sử dụngPQFreemem.

Đóng kèo bóng đá euro với máy chủ. Cũng giải phóng bộ nhớ được sử dụng bởi ThePGConnĐối tượng.

void pqfinish (pgconn *Conn);

Lưu ý rằng ngay cả khi kèo bóng đá euro máy chủ không cố gắng được chỉ ra bởiPQStatus), The Ứng dụng nên gọipqfinishđến miễn phí bộ nhớ được sử dụng bởiPGConnĐối tượng. ThePGConnCon trỏ không được Được sử dụng lại saupqfinishđã được gọi điện.

Đặt lại kênh truyền thông cho máy chủ.

void pqreset (pgconn *Conn);

Hàm này sẽ đóng kèo bóng đá euro với máy chủ và cố gắng thiết lập lại một kèo bóng đá euro mới với cùng một máy chủ, sử dụng Tất cả các tham số giống nhau được sử dụng trước đây. Điều này có thể hữu ích cho phục hồi lỗi nếu mất kèo bóng đá euro làm việc.

32508_32581

int pqresetstart (pgconn *Conn);

PostgrespollingStatusType PQResetPoll (PGConn *Conn);

Các chức năng này sẽ đóng kèo bóng đá euro với máy chủ và cố gắng thiết lập lại một kèo bóng đá euro mới với cùng một máy chủ, sử dụng Tất cả các tham số giống nhau được sử dụng trước đây. Điều này có thể hữu ích cho Phục hồi lỗi nếu mất kèo bóng đá euro làm việc. Chúng khác vớipqreset(ở trên) trong đó họ hành động trong một cách không chặn. kèo bóng đá euro chức năng này bị giống nhau Hạn chế làPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại kèo bóng đá euro, gọipqresetstart. Nếu nó trả về 0, thiết lập lại có thất bại. Nếu nó trả về 1, hãy bỏ phiếu đặt lại bằng cách sử dụngpqresetpolltheo cách tương tự như bạn muốn Tạo kèo bóng đá euro bằng cách sử dụngPQConnectPoll.

PQPingParamsBáo cáo trạng thái của máy chủ. Nó chấp nhận các tham số kèo bóng đá euro giống hệt với các tham số củaPQConnectDBParams, được mô tả ở trên. Không cần thiết phải cung cấp chính xác tên người dùng, mật khẩu hoặc Giá trị tên cơ sở dữ liệu để có được trạng thái máy chủ; Tuy nhiên, nếu Các giá trị không chính xác được cung cấp, máy chủ sẽ đăng nhập không thành công kèo bóng đá euro cố gắng.

PGPing PQPingParams (const char * const * từ khóa, từ khóa,
                    const char * const * giá trị,
                    int expand_dbname);

Hàm trả về một trong kèo bóng đá euro giá trị sau:

PQPing35773_35865PQConnectDB, được mô tả ở trên. Nó là Không cần thiết để cung cấp chính xác tên người dùng, mật khẩu hoặc cơ sở dữ liệu Tên giá trị để có được trạng thái máy chủ; Tuy nhiên, nếu không chính xác Các giá trị được cung cấp, máy chủ sẽ đăng nhập kèo bóng đá euro không thành công nỗ lực.

pgping pqping (const char *conninfo);

Giá trị trả về giống như đối vớiPQPingParams.