31.1. Điều khiển kèo bóng đá cúp c2 cơ sở dữ liệu Chức năng

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

13394_13487

Hàm này mở kèo bóng đá cúp c2 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 đá cúp c2 thúc mảng. Đầ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 năng, vì vậy sử dụng chức năng này (hoặc kèo bóng đá cúp c2 chất tương tự không chặnPQConnectStartParamsvà14177_14192) được ưu tiên cho mới Lập trình ứng dụng.

khiexpand_dbnamelà khác không, Thedbnamegiá trị từ khóa là được phép được công nhận làConninfoChuỗi. Xem bên dưới cho chi tiết.

Mảng được truyền có thể trống để sử dụng tất cả kèo bóng đá cúp c2 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.

kèo bóng đá cúp c2 từ khóa tham số hiện được công nhận là:

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.13) đượ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ếuexpand_dbnamelà không khác Vàdbnamechứa=dấu, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như Nếu nó đã được truyền choPQConnectDB37306_37407Conninfochuỗi.

Nói chung, kèo bóng đá cúp c2 từ khóa được xử lý từ đầu kèo bóng đá cúp c2 mảng theo thứ tự chỉ mục. Hiệu quả của điều này là Khi kèo bóng đá cúp c2 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 đá cúp c2 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 đá cúp c2 cơ sở dữ liệu mới bằng cách sử dụng tham số được lấy từ chuỗiConninfo.

38367_38567Từ khóa = value. Không gian xung quanh dấu hiệu bằng nhau là tùy chọn. Để viết một Giá trị trống hoặc giá trị chứa khoảng trống, bao quanh nó với Báo giá đơn, ví dụ:Từ khóa = 'a giá trị'. Báo giá đơn và dấu gạch chéo ngược trong giá trị Phải được thoát ra bằng một dấu gạch chéo ngược, tức là,\ 'và38977_38981.

kèo bóng đá cúp c2 từ khóa tham số hiện được nhận dạng là kèo bóng đá cúp c2 từ Giống như trên.

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

PGCONN *PQSetDbLogin (const char *
                     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ộ cố định tham số. Nó có cùng chức năng ngoại trừ Thiếu tham số sẽ luôn luôn có kèo bóng đá cúp c2 giá trị mặc định. Viếtnull39903_40001

Nếudbnamechứa=dấu, nó được lấy dưới dạngConninfoChuỗi theo cách tương tự như Nếu nó đã được truyền choPQConnectDBvà kèo bóng đá cúp c2 tham số còn lại sau đó được áp dụng như trên.

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

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

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

Pgconn *pqconnectStart (const char *conninfo);

PostgrespollingStatusType PQConnectPoll (PGConn *Conn);

41727_42068PQConnectDBParamshoặ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 đá cúp c2 hoạt động khác kèo bóng đá cúp c2 hoạt động.

với42322_42344,, kèo bóng đá cúp c2 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 điều khiển bởiexpand_dbname, như được mô tả ở trên choPQConnectDBParams.

vớiPQConnectStart, The kèo bóng đá cúp c2 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àhosttham số được sử dụng một cách thích hợp để đảm bảo rằng kèo bóng đá cúp c2 truy vấn tên và tên ngược không làm ra. Xem tài liệu của kèo bóng đá cúp c2 tham số này theoPQConnectDBParamsở trên Để biết chi tiết.

• Nếu bạn gọi43674_43683,, đả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 phù 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 đá cúp c2 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 đá cúp c2 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 đá cúp c2. Sử dụngPQSocket (Conn)Để có được bộ mô tả của ổ cắm bên dưới kèo bóng đá cúp c2 cơ sở dữ liệu. Vòng lặp Do đó: nếuPQConnectPoll (Conn)Đã trả lại lần cuốipgres_polling_reading45561_45629select (), 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ả 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, hoạt động 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 đá cúp c2 đã thất bại hoặcPGRES_POLLING_OK, Cho biết kèo bóng đá cúp c2 đã được thực hiện thành công.

Bất cứ lúc nào trong quá trình kèo bóng đá cúp c2, trạng thái của kèo bóng đá cúp c2 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 đá cúp c2 đã thất bại; Nếu cuộc gọi trả vềConnection_ok47035_47154PQConnectPoll, đượ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 đá cúp c2 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 đá cúp c2 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ù kèo bóng đá cúp c2 hằng số này sẽ vẫn còn ( để duy trì khả năng 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 đá cúp c2 ...";
            phá vỡ;

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

TheConnect_Timeoutkèo bóng đá cúp c2 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 người không null con trỏ, bạn phải gọipqfinish50521_50721

Trả về các tùy chọn kèo bóng đá cúp c2 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 đá cúp c2. 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 đá cúp c2. Đ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 đá cúp c2 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 đá cúp c2 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 đá cúp c2 phân tích cú pháp từ được cung cấp chuỗi kèo bóng đá cúp c2.

53014_53089

Phân tích chuỗi kèo bóng đá cúp c2 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 đá cúp c2. 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 đá cúp c2. Giá trị trả về chỉ ra một mảngPQConninFooptionCấu trúc, kèo bóng đá cúp c2 thúc bằng một mục có nullTừ khóaCon trỏ.

Lưu ý rằng chỉ các tùy chọn được chỉ định rõ ràng trong Chuỗi sẽ có các giá trị được đặt trong mảng kèo bóng đá cúp c2 quả; KHÔNG Mặc định được chèn.

nếuerrmsgkhông phảinull, sau đó*errmsgđược đặt thành53972_53978Thà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à chức kèo bóng đá cúp c2 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 đá cúp c2 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 đá cúp c2 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);

55879_56150

Đặ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 đá cúp c2 với máy chủ và cố gắng thiết lập lại một kèo bóng đá cúp c2 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 đá cúp c2 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. kèo bóng đá cúp c2 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 đá cúp c2, hãy gọiPQResetStart57322_57419pqresetpollTrong chính xác theo cách mà bạn sẽ tạo kèo bóng đá cúp c2 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 đá cúp c2 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ở kèo bóng đá cúp c2 để có được máy chủ trạng thái.

58157_58244

Hàm trả về một trong kèo bóng đá cúp c2 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 đá cúp c2 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ở kèo bóng đá cúp c2 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.