32.1. Các chức năng điều khiển kèo chấp bóng đá hôm nay cơ sở dữ liệu

Tạo kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay thúc mảng. Đầu tiên,Từ khóa, được định nghĩa là một mảng kèo chấp bóng đá hôm nay 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ưPQSetDbLogin13480_13617PQConnectStartParamsvàPQConnectPoll) được ưu tiên cho lập trình ứng dụng mới.

kèo chấp bóng đá hôm nay từ khóa tham số hiện được công nhận được liệt kê trongPhần 32.1.2.

kèo chấp bóng đá hôm nay mảng được truyền có thể trống để sử dụng tất cả kèo chấp bóng đá hôm nay tham số mặc định hoặc có thể chứa một hoặc nhiều cài đặt tham số. Chúng phải được khớp với chiều dài. Xử lý sẽ dừng ở lần đầu tiênnullNhập vàoTừ khóaMảng. Ngoài ra, nếuGiá trịmục liên quan đến khôngnull Từ khóamục lànullhoặc một chuỗi trống, mục nhập đó bị bỏ qua và xử lý tiếp tục với kèo chấp bóng đá hôm nay mục nhập mảng tiếp theo.

Khiexpand_dbnamelà khác không, giá trị cho đầu tiêndbnameTừ khóa được kiểm tra để xem đó có phải làchuỗi kèo chấp bóng đá hôm nay. Nếu vậy, nó là"Mở rộng"vào các tham số kèo chấp bóng đá hôm nay riêng lẻ được trích xuất từ ​​chuỗi. Giá trị được coi là chuỗi kèo chấp bóng đá hôm nay, thay vì chỉ tên cơ sở dữ liệu, nếu nó chứa một dấu bằng (=) Hoặc nó bắt đầu bằng một trình thiết kế sơ đồ URI. (Thông tin chi tiết về các định dạng chuỗi kèo chấp bóng đá hôm nay xuất hiện trongPhần 32.1.1.) Chỉ lần xuất hiện đầu tiên củadbnameđược đối xử theo cách này; bất kỳ sau đódbnameTham số được xử lý dưới dạng tên cơ sở dữ liệu đơn giản.

Nói chung, kèo chấp bóng đá hôm nay mảng tham số được xử lý từ đầu đến cuối. Nếu bất kỳ từ khóa nào được lặp lại, giá trị cuối cùng (không phảinullhoặc trống) được sử dụng. Quy tắc này được áp dụng cụ thể khi một từ khóa được tìm thấy trong một chuỗi kèo chấp bóng đá hôm nay xung đột với một từ xuất hiện trongTừ khóaMảng. Do đó, lập trình viên có thể xác định xem các mục nhập mảng có thể ghi đè hoặc được ghi đè bởi các giá trị được lấy từ chuỗi kèo chấp bóng đá hôm nay hay không. Các mục nhập mảng xuất hiện trước khi mở rộng15779_15787mục nhập có thể bị ghi đè bởi các trường của chuỗi kèo chấp bóng đá hôm nay và lần lượt các trường đó được ghi đè bởi các mục nhập mảng xuất hiện saudbname(Nhưng, một lần nữa, chỉ khi kèo chấp bóng đá hôm nay mục đó cung cấp kèo chấp bóng đá hôm nay giá trị không trống).

16026_16243Phần 32.14) được đặt, giá trị của nó được sử dụng. Nếu biến môi trường cũng không được đặt, thì giá trị mặc định tích hợp của tham số được sử dụng.

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

PGConn *PQConnectDB (const char *Conninfo);

Hàm này mở kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 32.1.1Để biết chi tiết.

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

17273_17560

Đâ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 chấp bóng đá hôm nay tham số bị thiếu sẽ luôn mang kèo chấp bóng đá hôm nay giá trị mặc định. Viếtnullhoặc chuỗi trống cho bất kỳ một trong kèo chấp bóng đá hôm nay tham số cố định được mặc định.

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

Tạo kèo chấp bóng đá hôm nay 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ọiPQSetDbLogin18732_18762Đăng nhập18792_18799PWDtham số. Nó được cung cấp để tương thích ngược với kèo chấp bóng đá hôm nay chương trình rất cũ.

Tạo kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay hoạt động khác.

vớiPQConnectStartParams, kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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àmáy chủtham số được sử dụng một cách thích hợp để đảm bảo rằng kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay tham số này trongPhần 32.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.

• 21259_21331PQConnectPoll, 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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ếuPQConnectStartThà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 chấp bóng đá hôm nay. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kèo chấp bóng đá hôm nay 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 hàm hệ thống tương tự). Sau đó gọiPQConnectPoll (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 chấp bóng đá hôm nay đã thất bại hoặcPGRES_POLLING_OK, cho biết kèo chấp bóng đá hôm nay đã được thực hiện thành công.

Bất cứ lúc nào trong quá trình kèo chấp bóng đá hôm nay, trạng thái của kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay đã thất bại; Nếu cuộc gọi trả vềConnection_ok, sau đó kèo chấp bóng đá hôm nay đã 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 chấp bóng đá hôm nay không đồng bộ. Chúng chỉ ra giai đoạn hiện tại của quy trình kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay ...";
            phá vỡ;

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

TheConnect_TimeoutTham số kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay thất bại hoặc bị bỏ rơi.

27000_27041

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 chấp bóng đá hôm nay. 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 chấp bóng đá hôm nay. Đ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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay giá trị mặc định hiện tại (ValTrường) sẽ phụ thuộc vào các biến môi trường và bối cảnh khác. Một tệp dịch vụ bị thiếu hoặc không hợp lệ sẽ bị bỏ qua âm thầm. Người gọi phải coi dữ liệu tùy chọn kèo chấp bóng đá hôm nay 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 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 chấp bóng đá hôm nay được sử dụng bởi kèo chấp bóng đá hôm nay trực tiếp.

28951_28996

29004_29085PQConnectDBTùy chọn và các giá trị được sử dụng để kèo chấp bóng đá hôm nay với máy chủ. Giá trị trả về chỉ vào một mảngPQConninFooptioncấu trúc, kèo chấp bóng đá hôm nay thúc bằng một mục có nullTừ khóaCon trỏ. Tất cả kèo chấp bóng đá hôm nay ghi chú ở trên choPQConnDefaultsCũng áp dụng cho kèo chấp bóng đá hôm nay quả củaPQConnInfo.

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

29738_29811

phân tích chuỗi kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay. Chức năng này có thể được sử dụng để trích xuấtPQConnectDBTùy chọn trong chuỗi kèo chấp bóng đá hôm nay được cung cấp. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay quả, nhưngPQConninFooptionĐối với bất kỳ tùy chọn nào không có trong chuỗi kèo chấp bóng đá hôm nay sẽ cóValĐặ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ớimallocD Chuỗi lỗi giải thích vấn đề. (Nó cũng có thể cho*errmsgđược đặt thànhnullvà hàm để 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 đếnPQConninFopars. 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 chấp bóng đá hôm nay với máy chủ. Cũng giải phóng bộ nhớ được sử dụng bởiPGConnĐối tượng.

31675_31705

Lưu ý rằng ngay cả khi cố gắng kèo chấp bóng đá hôm nay máy chủ không thành cô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);

Hàm này sẽ đóng kèo chấp bóng đá hôm nay với máy chủ và cố gắng thiết lập lại một kèo chấp bóng đá hôm nay 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 khôi phục lỗi nếu mất kèo chấp bóng đá hôm nay làm việc.

Đặ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 chấp bóng đá hôm nay với máy chủ và cố gắng thiết lập lại một kèo chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay chức năng này bị hạn chế giống nhưPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại kèo chấp bóng đá hôm nay, 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay giống hệt với các tham số củaPQConnectDBParams34092_34316

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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay 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 chấp bóng đá hôm nay không thành công.

pgping pqping (const char *conninfo);

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