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

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

13818_13975

Hàm này mở kèo bóng đá việt nam cơ sở dữ liệu mới bằng cách sử dụng các tham số được lấy từ hainull-kèo bóng đá việt nam thúc mảng. Đầu tiên,Từ khóa, được định nghĩa là một mảng kèo bóng đá việt nam chuỗi, mỗi chuỗi là một từ khóa. Thứ hai,Giá trị, đưa ra giá trị cho mỗi từ khóa. Không giống nhưPQSetDbLogin14350_14487PQConnectStartParamsvàPQConnectPoll) được ưu tiên cho lập trình ứng dụng mới.

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

Khiexpand_dbnamelà không khác,dbnameGiá trị từ khóa được phép được nhận dạng là chuỗi kèo bóng đá việt nam. 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 theo nàodbnameGiá trị được xử lý dưới dạng tên cơ sở dữ liệu đơn giản. Thêm chi tiết về các định dạng chuỗi kèo bóng đá việt nam có thể xuất hiện trongPhần 31.1.1.

Mảng được truyền có thể trống để sử dụng tất cả kèo bóng đá việt nam 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 khớp với chiều dài. Xử lý sẽ dừng ở lần đầu tiênnullphần tử trongTừ khóamảng.

Nếu bất kỳ tham số nào lànullhoặc chuỗi Emptry, biến môi trường tương ứng (xemPhần 31,14) được kiểm tra. Nếu biến môi trường cũng không được đặt, thì kèo bóng đá việt nam mặc định được chỉ định được chỉ định được sử dụng.

15793_16019dbnameTừ 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 đá việt nam 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 đá việt nam cơ sở dữ liệu mới bằng cách sử dụng các 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 đá việt nam 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ứa AURI. Nhìn thấyPhần 31.1.1Để biết chi tiết.

16964_17012

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 tập hợp kèo bóng đá việt nam tham số cố định. Nó có cùng chức năng ngoại trừ kèo bóng đá việt nam tham số bị thiếu sẽ luôn mang kèo bóng đá việt nam giá trị mặc định. Viếtnullhoặc chuỗi trống cho bất kỳ một trong kèo bóng đá việt nam tham số cố định được mặc định.

Nếudbnamechứa=dấu hiệu hoặc có kèo bóng đá việt nam 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 chuyển sangPQConnectDBvà kèo bóng đá việt nam tham số còn lại sau đó được áp dụng theo quy định choPQConnectDBParams.

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

PGConn *PQSetDB (char *pghost,
                char *pgport,
                char *pgoptions,
                char *pgtty,
                char *dbname);

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

Tạo kèo bóng đá việt nam với máy chủ cơ sở dữ liệu theo cách không chặn.

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 đá việt nam với máy chủ cơ sở dữ liệu sao cho chủ đề thực thi ứng dụng của bạn không bị chặn trên I/O từ xa trong khi làm như vậy. Điểm của phương pháp này 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 đá việt nam hoạt động khác.

vớiPQConnectStartParams, kèo bóng đá việt nam cơ sở dữ liệu được tạo 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, kèo bóng đá việt nam cơ sở dữ liệu được tạo bằ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 một cách thích hợp để đảm bảo rằng kèo bóng đá việt nam truy vấn tên và tên ngược không được thực hiện. Xem tài liệu của kèo bóng đá việt nam tham số này trongPhần 31.1.2Để biết 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 khi gọiPQConnectPoll, như được mô tả bên dưới.

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

Để bắt đầu yêu cầu kèo bóng đá việt nam 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ù chưa đại diện cho kèo bóng đá việt nam hợp lệ với cơ sở dữ liệu). Khi trở về từPQConnectStart, gọistatus = pqStatus (Conn). Nếu nhưstatusbằngConnection_Bad, PQConnectStartđã thất bại.

nếu22070_22086Thành công, giai đoạn tiếp theo là thăm dò ý kiếnlibpqđể nó có thể tiến hành trình tự kèo bóng đá việt nam. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kèo bóng đá việt nam 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 ()22601_22644PQConnectPoll (Conn)Một lần nữa. Ngược lại, nếuPQConnectPoll (Conn)Đã trả lại 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à, ngay sau cuộc gọi đếnPQConnectStart, Hành xử như thể 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 quy trình kèo bóng đá việt nam đã thất bại hoặcPGRES_POLLING_OK, cho biết kèo bóng đá việt nam đã được thực hiện thành công.

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

Lưu ý rằng, mặc dù kèo bóng đá việt nam hằng số này sẽ vẫ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 chúng xảy ra theo một thứ tự cụ thể, hoặc hoàn toàn, hoặc theo trạng thái luôn luôn là một trong những giá trị được ghi nhận 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 đá việt nam ...";
            phá vỡ;

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

TheConnect_TimeoutTham số kèo bóng đá việt nam bị bỏ qua khi sử dụngPQConnectPoll; Trách nhiệm của ứng dụng là quyết định xem một lượng thời gian quá mức đã trôi qua. Nếu không thì,PQConnectStarttheo sau làPQConnectPollVòng lặp 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ó, để xử lý cấu trúc và bất kỳ khối bộ nhớ liên quan nào. Điều này phải được thực hiện ngay cả khi cố gắng kèo bóng đá việt nam thất bại hoặc bị bỏ rơi.

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

pqconninfooption *pqconndefaults (void);

Cấu trúc typedef

    từ khóa *từ khóa;   / * Từ khóa của tùy chọn */
    char *envvar;    / * Tên biến môi trường dự phòng */
    char *biên soạn;  / * Dự phòng được biên dịch trong giá trị mặc định */
    char *val;       / * Giá trị hiện tại của tùy chọn hoặc null */
    Nhãn char *;     / * Nhãn cho trường trong hộp thoại Connect */
    char *vua;  /* Cho biết cách hiển thị trường này
                          Trong một hộp thoại kèo bóng đá việt nam. Giá trị là:
                          "" Hiển thị giá trị đã nhập như là
                          "*" Trường mật khẩu - ẩn giá trị
                          Tùy chọn gỡ lỗi "D" - không hiển thị theo mặc định */
    int phân tán;  / * Kích thước trường trong các ký tự cho hộp thoại */
 PQConnInFooption;

Trả về mảng tùy chọn kèo bóng đá việt nam. Đ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 đá việt nam giá trị mặc định hiện tại của chúng. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kèo bóng đá việt nam thúc bằng một mục có nullTừ khóaCon trỏ. Con trỏ null được trả về nếu bộ nhớ không thể được phân bổ. Lưu ý rằng kèo bóng đá việt nam giá trị mặc định hiện tại (Val28091_28278

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 bộ nhớ nhỏ sẽ bị rò rỉ cho mỗi cuộc gọi đếnPQConnDefaults.

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

Trả về mảng tùy chọn kèo bóng đá việt nam. Đ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 đá việt nam với máy chủ. Giá trị trả về chỉ vào một mảngPQConninFooptioncấu trúc, kèo bóng đá việt nam thúc bằng một mục có nullTừ khóaCon trỏ. Tất cả kèo bóng đá việt nam ghi chú ở trên choPQConnDefaultsCũng áp dụng cho kèo bóng đá việt nam quả củaPQConnInfo.

Trả về các tùy chọn kèo bóng đá việt nam phân tích cú pháp từ chuỗi kèo bóng đá việt nam được cung cấp.

29502_29575

Phân tích chuỗi kèo bóng đá việt nam và trả về các tùy chọn kết quả dưới dạng mảng; hoặc trả lạinullNếu có vấn đề với chuỗi kèo bóng đá việt nam. 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 đá việt nam được cung cấp. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kèo bóng đá việt nam 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 đá việt nam quả, nhưngPQConninFooption30165_30230ValĐặt thànhnull; Giá trị mặc định 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 năng 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ớ sẽ 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ụng31170_31181.

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

void pqfinish (pgconn *Conn);

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

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

VOID PQRESET (PGCONN *Conn);

32085_32324

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

int pqresetstart (pgconn *Conn);

PostgrespollingStatusType PQResetPoll (PGConn *Conn);

Các chức năng này sẽ đóng kèo bóng đá việt nam với máy chủ và cố gắng thiết lập lại một kèo bóng đá việt nam 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 việc phục hồi lỗi nếu mất kèo bóng đá việt nam làm việc. Chúng khác vớipqreset(ở trên) trong đó chúng hành động theo cách không chặn. kèo bóng đá việt nam chức năng này bị hạn chế giống nhưPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại kèo bóng đá việt nam, hãy gọipqresetstart. Nếu nó trả về 0, thiết lập lại đã 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 sẽ tạo kèo bóng đá việt nam 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 đá việt nam giống hệt với các tham số củaPQConnectDBParams33856_34080

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

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

PQPingBá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 đá việt nam giống hệt với các tham số củaPQConnectDB, được mô tả ở trên. Không cần thiết phải cung cấp các giá trị tên người dùng, mật khẩu hoặc cơ sở dữ liệu chính xác để 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ẽ ghi lại một kèo bóng đá việt nam không thành công.

pgping pqping (const char *conninfo);

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