kèo bóng đá việt namlà ứng dụng C Giao diện của lập trình viên vớiPostgres. kèo bóng đá việt namlà a Đặt các thói quen thư viện cho phép các chương trình khách hàng vượt qua các truy vấn đếnPostgresMáy chủ phụ trợ và để nhận kèo bóng đá việt nam quả của các truy vấn này.kèo bóng đá việt namcũng là công cụ cơ bản cho kèo bóng đá việt nam số khácPostgresỨng dụng giao diện, bao gồmkèo bóng đá việt nam ++(C ++),libpgtcl(TCL),perl5vàECPG. Vì vậy, một số Các khía cạnh của hành vi của kèo bóng đá việt nam sẽ rất quan trọng đối với bạn nếu bạn sử dụng một của các gói đó. Ba chương trình ngắn được bao gồm ở cuối Phần này để chỉ ra cách viết các chương trình sử dụngkèo bóng đá việt nam. Có kèo bóng đá việt nam số ví dụ đầy đủ vềkèo bóng đá việt namỨng dụng theo sau thư mục:
../ SRC/TEST/THAM GIA
../src/test/examples
../src/bin/psql
Chương trình Frontend sử dụngkèo bóng đá việt namPhải Bao gồm tệp tiêu đềkèo bóng đá việt nam-fe.hvà Phải liên kèo bóng đá việt nam vớikèo bóng đá việt namThư viện.
Các thói quen sau giải quyết việc tạo kèo bóng đá việt nam với APostgresMáy chủ phụ trợ. Các Chương trình ứng dụng có thể mở một số kèo bóng đá việt nam phụ trợ tại một lần. (Một lý do để làm điều đó là truy cập nhiều hơn một cơ sở dữ liệu.) Mỗi kèo bóng đá việt nam được biểu thị bằng một đối tượng PGConn được lấy từ pqconnectdb () hoặc pqsetdblogin (). Lưu ý rằng những điều này Các chức năng sẽ luôn trả về một con trỏ đối tượng không null, trừ khi Có lẽ có quá ít bộ nhớ thậm chí để phân bổ PGConn sự vật. Hàm pqstatus nên được gọi để kiểm tra xem có kèo bóng đá việt nam đã được thực hiện thành công trước khi các truy vấn được gửi qua đối tượng kèo bóng đá việt nam.
PQSetDbLoginlàm cho một mới kèo bóng đá việt nam với phụ trợ.
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)Nếu bất kỳ đối số nào là NULL, thì môi trường tương ứng
Biến (xem phần "Biến môi trường") được kiểm tra. Nếu
Biến môi trường cũng không được đặt, sau đó mặc định cứng
đã sử dụng. Giá trị trả về là một con trỏ tới một cấu trúc trừu tượng
biểu thị kèo bóng đá việt nam với phụ trợ.PQSetDBTạo kèo bóng đá việt nam mới với một phụ trợ.
pgconn *pqsetdb (char *pghost,
char *pgport,
char *pgoptions,
char *pgtty,
char *dbname)Đây là kèo bóng đá việt nam macro gọi pqsetDblogin () với các con trỏ null
Đối với các tham số đăng nhập và PWD. Nó được cung cấp chủ yếu cho
Khả năng tương thích ngược với các chương trình cũ.PQConnectDBTạo kèo bóng đá việt nam mới để phụ trợ.
PGConn *PQConnectDB (const char *Conninfo)thói quen này mở kèo bóng đá việt nam cơ sở dữ liệu mới bằng cách sử dụng tham số lấy từ một chuỗi. Không giống như pqsetdblogin (), bộ tham số có thể được mở rộng mà không thay đổi chữ ký chức năng, vì vậy hãy sử dụng điều này Thường xuyên được khuyến khích cho lập trình ứng dụng mới. Đã qua Chuỗi có thể trống để sử dụng tất cả các 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. Mỗi cài đặt tham số nằm trong từ khóa biểu mẫu = value. (Để viết a giá trị null hoặc giá trị chứa khoảng trống, bao quanh nó với một Báo giá, ví dụ, từ khóa = 'một giá trị'. Báo giá đơn trong giá trị Phải được viết là \ '. Không gian xung quanh dấu hiệu bằng nhau là tùy chọn.) Từ khóa tham số hiện được nhận dạng là:
host- máy chủ để kết nối với. Nếu một chuỗi dài không có chiều dài được chỉ định, TCP/IP Giao tiếp được sử dụng. Không có tên máy chủ, kèo bóng đá việt nam sẽ kết nối bằng ổ cắm miền unix cục bộ.
Cổng- Số cổng đến kèo bóng đá việt nam với máy chủ máy chủ hoặc tiện ích mở rộng FileName của máy chủ cho các kèo bóng đá việt nam miền đơn vị.
dbname- Cơ sở dữ kèo bóng đá việt nam tên.
user- Tên người dùng cho xác thực.
Mật khẩu- Mật khẩu được sử dụng Nếu phụ trợ yêu cầu xác thực mật khẩu.
authType- ủy quyền kiểu. (Không còn được sử dụng nữa, vì phần phụ trợ bây giờ chọn cách Xác thực người dùng. kèo bóng đá việt nam vẫn chấp nhận và bỏ qua điều này Từ khóa để tương thích ngược.)
Tùy chọn- Trace/Debug các tùy chọn để gửi đến phụ trợ.
tty- Tệp hoặc TTY cho đầu ra gỡ lỗi tùy chọn từ phụ trợ.
như pqsetdblogin, pqconnectdb sử dụng các biến môi trường hoặc Các giá trị mặc định tích hợp cho các tùy chọn không xác định.
PQConnDefaultsTrả về mặc định Tùy chọn kèo bóng đá việt nam.
PQConnInfooption *PQConnDefaults (void)
struct pqconninfooption
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ị của tùy chọn */
Nhãn char *; / * Nhãn cho trường trong hộp thoại Connect */
char *vua; /* Ký tự để hiển thị cho 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
Tạo một trường 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 */
;Trả về địa chỉ của cấu trúc tùy chọn kèo bóng đá việt nam. Cái này
có thể được sử dụng để xác định tất cả các tùy chọn PQConnectDB có thể có và
Giá trị mặc định hiện tại. Giá trị trả về chỉ vào một mảng
PQConninFooption Structs, kết thúc bằng một mục có một null
con trỏ từ khóa. Lưu ý rằng các giá trị mặc định (các trường "Val") sẽ
phụ thuộc vào các biến môi trường và bối cảnh khác. Người gọi phải
xử lý dữ liệu tùy chọn kèo bóng đá việt nam là chỉ đọc.pqfinishĐóng kèo bóng đá việt nam với phụ trợ. Cũng giải phóng bộ nhớ được sử dụng bởi đối tượng PGConn.
void pqfinish (pgconn *Conn)Lưu ý rằng ngay cả khi cố gắng kèo bóng đá việt nam phụ trợ không thành công (như Được chỉ định bởi pqstatus), ứng dụng nên gọi pqfinish thành Miễn phí bộ nhớ được sử dụng bởi đối tượng PGConn. Con trỏ PGConn không nên được sử dụng sau khi pqfinish được gọi.
pqresetĐặt lại giao tiếp Cổng có phụ trợ.
VOID PQRESET (PGCONN *Conn)Hàm này sẽ đóng kèo bóng đá việt nam với phần phụ trợ 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 bưu điện, 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 Để phục hồi lỗi nếu mất kèo bóng đá việt nam làm việc.
kèo bóng đá việt namlập trình viên ứng dụng nên Hãy cẩn thận để duy trì sự trừu tượng PGConn. Sử dụng người truy cập Các chức năng dưới đây để có được nội dung của PGConn. Tránh trực tiếp tham chiếu các trường của cấu trúc PGConn vì chúng là có thể thay đổi trong tương lai. (Bắt đầu trongPostgresPhát hành 6.4, Định nghĩa của Struct PGConn thậm chí không được cung cấp trong kèo bóng đá việt nam-fe.h. Nếu bạn có mã cũ truy cập trực tiếp vào các trường PGConn, bạn có thể tiếp tục sử dụng nó bằng cách bao gồm cả kèo bóng đá việt nam-int.h nữa, nhưng bạn được khuyến khích sửa mã sớm.)
PQDBTrả về tên cơ sở dữ liệu của kèo bóng đá việt nam.
Char *PQDB (PGConn *Conn)PQDB và một số chức năng tiếp theo trả về các giá trị Được thành lập tại kèo bóng đá việt nam. Các giá trị này được cố định cho cuộc sống của Đối tượng PGConn.
pquserTrả về tên người dùng của kèo bóng đá việt nam.
char *pquser (pgconn *Conn)
PQPassTrả về mật khẩu của sự liên quan.
Char *PQPass (PGConn *Conn)
PQHOSTTrả về máy chủ máy chủ Tên của kèo bóng đá việt nam.
char *pqhost (pgconn *Conn)
PQPortTrả về cổng của sự liên quan.
Char *PQPort (PGConn *Conn)
PQTTYTrả về bản gỡ lỗi của tty của sự liên quan.
char *pqtty (pgconn *Conn)
PQOptionsTrả về phần phụ trợ các tùy chọn được sử dụng trong kèo bóng đá việt nam.
Char *PQOptions (PGConn *Conn)
pqstatusTrả về trạng thái của sự liên quan. Trạng thái có thể là Connection_ok hoặc Connection_bad.
ConnstatusType *PQStatus (PGConn *Conn)
Một nỗ lực kèo bóng đá việt nam thất bại được báo hiệu bởi trạng thái Connection_bad. Thông thường, trạng thái OK sẽ vẫn như vậy cho đến khi Pqfinish, nhưng một thất bại truyền thông có thể dẫn đến Trạng thái thay đổi thành Connection_Bad sớm. Trong trường hợp đó Ứng dụng có thể cố gắng khôi phục bằng cách gọi PQReset.
pqerrormessageTrả về lỗi thông báo gần đây nhất được tạo bởi kèo bóng đá việt nam hoạt động trên sự liên quan.
char * pqerrormessage (pgconn * Conn);
Gần như tất cả các chức năng kèo bóng đá việt nam sẽ đặt pqerrormessage nếu chúng thất bại. Lưu ý rằng theo quy ước kèo bóng đá việt nam, một pqerrormessage không trống sẽ bao gồm một dòng mới.
PQBackendPidTrả về quy trình Id của máy chủ phụ trợ xử lý kèo bóng đá việt nam này.
int pqbackendPid (pgconn *Conn);PID phụ trợ rất hữu ích cho mục đích gỡ lỗi và cho so sánh với thông báo thông báo (bao gồm PID của thông báo phụ trợ). Lưu ý rằng PID thuộc về một quá trình Thực hiện trên máy chủ máy chủ cơ sở dữ kèo bóng đá việt nam, không phải máy chủ cục bộ!