31.1. Điều khiển kèo bóng đá hôm nay và ngày mai cơ sở dữ liệu Chức năng

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

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

Hàm này mở kèo bóng đá hôm nay và ngày mai cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ hainullMảng được kèo bóng đá hôm nay và ngày mai thúc. Đầu tiên,Từ khóa, được định nghĩa là một mảng chuỗi, Mỗi ngườ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ưPQSetDbLoginbên dưới, tập hợp tham số có thể được mở rộng mà không cần thay đổi Chữ ký chức kèo bóng đá hôm nay và ngày mai, vì vậy sử dụng chức kèo bóng đá hôm nay và ngày mai này (hoặc Các chất tương tự không chặnPQConnectStartParamsvàPQConnectPoll) được ưu tiên cho mới Lập trình ứng dụng.

Các 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, ThedbnameGiá trị từ khóa là được phép được nhận dạng là một chuỗi kèo bóng đá hôm nay và ngày mai. Chỉ có Sự xuất hiện đầu tiên củadbnameIS đã mở rộng theo cách này, mọi sau đódbnameGiá trị được xử lý như đơn giản Tên cơ sở dữ liệu. Thông tin chi tiết về kèo bóng đá hôm nay và ngày mai có thể Các định dạng chuỗi 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 mặc định tham số 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ại với cuối cùng khô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,14) được kiểm tra. Nếu Biến môi trường cũng không được đặt, sau đó được chỉ định mặc định tích hợp được sử dụng.

Nói chung, các từ khóa được xử lý từ đầu Các mảng theo thứ tự chỉ mục. Hiệu quả của điều này là Khi các từ khóa được lặp lại, giá trị được xử lý cuối cùng là giữ lại. Do đó, 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 mộtConninfoChuỗi và những gì có thể không.

Tạo kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai 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ả các mặc định tham số hoặc nó có thể chứa một hoặc nhiều tham số Cài đặt đượ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.1Để biết chi tiết.

Tạo kèo bóng đá hôm nay và ngày mai 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 tập hợp cố định tham số. Nó có cùng chức kèo bóng đá hôm nay và ngày mai ngoại trừ Thiếu tham số sẽ luôn luôn có các giá trị mặc định. Viếtnullhoặc một chuỗi trống cho bất kỳ một trong các tham số cố định là mặc định.

Nếudbnamechứa=dấu hiệu hoặc có kèo bóng đá hôm nay và ngày mai hợp lệURItiền tố, nó được lấy như mộtConninfoChuỗi chính xác giống như cách nó đã được truyền choPQConnectDBvà các tham số còn lại sau đó được áp dụng theo quy định choPQConnectDBParams.

Tạo kèo bóng đá hôm nay và ngày mai 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 các con trỏ null choĐăng nhậpvàPWDtham số. Nó được cung cấp cho Khả kèo bóng đá hôm nay và ngày mai tương thích ngược với các chương trình rất cũ.

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

PGConn *PQConnectStartParams (const char *const *từ khóa, 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 đá hôm nay và ngày mai với A máy chủ cơ sở dữ liệu sao cho chủ đề của ứng dụng của bạn về Thực thi không bị chặn trên I/O từ xa trong khi làm như vậy. Các Đ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 lặp chính của ứng dụng, thay vào đó hơn 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 các hoạt động khác các hoạt động.

vớiPQConnectStartParams,, kèo bóng đá hôm nay và ngày mai cơ sở dữ liệu được thực hiện bằng cách sử dụng các tham số được thực hiện 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, The kèo bóng đá hôm nay và ngày mai cơ sở dữ liệu được thực hiện bằng các tham số được lấy từ chuỗiConninfonhư mô tả Trên choPQConnectDB.

khôngPQConnectStartParamscũng khôngPQConnectStartcũng khôngPQConnectPollsẽ chặn, miễn là a Số lượng 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 các truy vấn tên và tên ngược không làm ra. Xem tài kèo bóng đá hôm nay và ngày mai của các 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 khối.

• Bạn đảm bảo rằng ổ cắm nằm trong thích hợp trạng thái trước khi 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 đá hôm nay và ngày mai 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 một hợp lệ kèo bóng đá hôm nay và ngày mai 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, 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 đá hôm nay và ngày mai. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kèo bóng đá hôm nay và ngày mai cơ sở dữ liệu. Vòng lặp Do đó: 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 đá hôm nay và ngày mai 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 có chưa gọiPQConnectPoll,, tức là, ngay sau cuộc gọi đếnPQConnectStart, hành xử như thể nó kéo dài đã trả vềPGRES_POLLING_WRITY. Tiếp tục vòng lặp này cho đến khiPQConnectPoll (Conn)returnpgres_polling_failed, chỉ ra Quy trình kèo bóng đá hôm nay và ngày mai đã thất bại hoặcPGRES_POLLING_OK, Cho biết kèo bóng đá hôm nay và ngày mai đã được thực hiện thành công.

Bất cứ lúc nào trong quá trình kèo bóng đá hôm nay và ngày mai, trạng thái của kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai đã thất bại; Nếu cuộc gọi trả vềConnection_ok, thì kèo bóng đá hôm nay và ngày mai là 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. Khác Các quốc gia cũng có thể xảy ra trong (và chỉ trong) Quy trình kèo bóng đá hôm nay và ngày mai không đồng bộ. Những điều này chỉ ra giai đoạn hiện tại của thủ tục kèo bóng đá hôm nay và ngày mai và có thể là hữu ích để cung cấp phản hồi cho người dùng làm ví dụ. Những cái này Trạng thái là:

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

Switch (pqstatus (Conn))

        Case Connection_started:
            Phản hồi = "kèo bóng đá hôm nay và ngày mai ...";
            phá vỡ;

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

TheConnect_Timeoutkèo bóng đá hôm nay và ngày mai 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 quá mức của Thời gian đã 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 null con trỏ, 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ỳ liên kết nào Khối bộ nhớ. Điều này phải được thực hiện ngay cả khi kèo bóng đá hôm nay và ngày mai cố gắng thất bại hoặc bị bỏ rơi.

Trả về các tùy chọn kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai. 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 đá hôm nay và ngày mai. Điều này có thể được sử dụng để Xác định tất cả có thểPQConnectDBTùy chọn và dòng điện của chúng giá trị mặc định. Giá trị trả về chỉ vào một mảngPQConninFooptionCấu trúc, kèo bóng đá hôm nay và ngày mai thúc bằng một mục có nullTừ khóaCon trỏ. Con trỏ null là trả lại nếu bộ nhớ không thể được phân bổ. Lưu ý rằng 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à các biến khác bối cảnh. Người gọi phải coi dữ liệu tùy chọn kèo bóng đá hôm nay và ngày mai là chỉ đọc.

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách vượt qua nó đếnPQConnInfofree. 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 Gọi đếnPQConnDefaults.

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

30993_31068

Phân tích chuỗi kèo bóng đá hôm nay và ngày mai và trả về kết quả tùy chọn như một mảng; hoặc trả lạinullNếu có vấn đề với Chuỗi kèo bóng đá hôm nay và ngày mai. Chức năng này có thể được sử dụng để trích xuấtPQConnectDBTùy chọn trong Cung cấp chuỗi kèo bóng đá hôm nay và ngày mai. Giá trị trả về chỉ ra một mảngPQConninFooptionCấu trúc, kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai quả, NhưngPQConninFooptionĐối với bất kỳ tùy chọn không có trong chuỗi kèo bóng đá hôm nay và ngày mai 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ànhnullThành công, khác để Mộtmalloc'D 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 cho thấy một bộ nhớ ngoài tình trạng.)

Sau khi xử lý mảng tùy chọn, hãy giải phóng nó bằng cách vượt qua nó đếnPQConninFofree. 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 đếnPQConnInfopars. Ngược lại, Nếu xảy ra lỗi vàerrmsgIS khôngnull, Hãy chắc chắn giải phóng lỗi Chuỗi sử dụngpqfreemem.

Đóng kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai máy chủ không cố (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 sau đópqfinishđã được gọi điện.

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

void pqreset (pgconn *Conn);

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

Đặt lại kênh truyền thông cho máy chủ, trong A 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 đá hôm nay và ngày mai với máy chủ và cố gắng thiết lập lại một kèo bóng đá hôm nay và ngày mai 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. Cái này có thể hữu ích cho việc khôi phục lỗi nếu kèo bóng đá hôm nay và ngày mai làm việc là mất. Chúng khác vớipqreset(ở trên) trong đó họ hành động trong một cách không chặn. Các chức kèo bóng đá hôm nay và ngày mai này bị giống nhau Hạn chế làPQConnectStartParams, PQConnectStartvàPQConnectPoll.

Để bắt đầu đặt lại kèo bóng đá hôm nay và ngày mai, 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ụngPQResetPollTrong chính xác theo cách mà bạn sẽ tạo kèo bóng đá hôm nay và ngày mai 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 đá hôm nay và ngày mai giống với những người củaPQConnectDBParams, được mô tả ở trên. Nó là Tuy nhiên, không cần thiết để cung cấp tên người dùng chính xác, Mật khẩu hoặc giá trị tên cơ sở dữ kèo bóng đá hôm nay và ngày mai để có được máy chủ trạng thái.

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

Hàm trả về một trong các 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 đá hôm nay và ngày mai giống hệt cho những ngườiPQConnectDB,, mô tả ở trên. Tuy nhiên, không cần thiết để cung cấp đúng tên người dùng, mật khẩu hoặc giá trị tên cơ sở dữ kèo bóng đá hôm nay và ngày mai thành có được trạng thái máy chủ.

pgping pqping (const char *conninfo);

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