tỷ lệ kèo bóng đáGiao diện

Các cơ sởPostgresCung cấp để truy cập các đối tỷ lệ kèo bóng đá, cả hai trong phần phụ trợ như một phần của Các chức năng do người dùng xác định hoặc đầu tiên là một phần của ứng dụng Sử dụng giao diện, được mô tả dưới đây. Cho người dùng quen thuộc vớiPostgres 4.2, PostgreSQLCó một bộ chức năng mới Cung cấp giao diện mạch lạc hơn.

Lưu ý:Tất cả các thao tác đối tỷ lệ kèo bóng đáphảidiễn ra trong một giao dịch SQL. Cái này Yêu cầu được thực thi nghiêm ngặt như Postgres v6.5, mặc dù nó đã là một yêu cầu ngầm trong các phiên bản trước, kết quả trong hành vi sai trái nếu bị bỏ qua.

ThePostgresĐối tỷ lệ kèo bóng đá Giao diện được mô hình hóa sauUNIXGiao diện hệ thống tệp, với các chất tương tựMở (2), Đọc (2), Viết (2), LSEEK (2)6365_6891CCác chương trình khách hàng hoặc cơ sở dữ liệu liên kết thư viện.Postgrescung cấp một tập hợp các thói quen hỗ trợ mở, đọc, viết, đóng và tìm kiếm trên các đối tỷ lệ kèo bóng đá.

Tạo ra một tỷ lệ kèo bóng đá Sự vật

thói quen

oid lo_creat (pgconn *Conn, intMode)

Tạo một đối tỷ lệ kèo bóng đá mới.Modelà một bitmask mô tả một số Các thuộc tính khác nhau của đối tỷ lệ kèo bóng đá mới. Các hằng số tỷ lệ kèo bóng đá trưng được liệt kê ở đây được xác định trong$PGROOT/src/backend/libpq/libpq-fs.hTruy cập loại (đọc, viết hoặc cả hai) được kiểm soát bởi hoặc ing cùng nhau bitinv_readvàinv_write. Nếu đối tỷ lệ kèo bóng đá nên được lưu trữ - nghĩa là, nếu các phiên bản lịch sử của nó nên được di chuyển định kỳ đến một mối quan hệ lưu trữ đặc biệt - sau đóinv_archiveBit nên được đặt. Thứ tự thấp Mười sáu bit của mặt nạ là số Trình quản lý lưu trữ mà trên đó Đối tỷ lệ kèo bóng đá nên cư trú. Cho các trang web khác ngoài Berkeley, những thứ này bit phải luôn luôn bằng không. Các lệnh bên dưới tạo một (Đảo ngược) Đối tỷ lệ kèo bóng đá:

inv_oid = lo_creat (inv_read | inv_write | inv_archive);

nhập a Đối tỷ lệ kèo bóng đá

Để nhập AUNIXTệp dưới dạng lớn đối tỷ lệ kèo bóng đá, gọi

oid lo_import (pgconn *Conn, const char *FileName)

FileNameChỉ địnhUNIXTên đường dẫn của tệp sẽ được được nhập dưới dạng một đối tỷ lệ kèo bóng đá.

Xuất a Đối tỷ lệ kèo bóng đá

Để xuất một đối tỷ lệ kèo bóng đá thànhUNIXTệp, gọi

int lo_export (pgconn *Conn, OIDlobjid, const char *FileName)

Đối số lobjid chỉ định oid của đối tỷ lệ kèo bóng đá để xuất và đối số tên tệp chỉ địnhUNIXTên đường dẫn của tệp.

Mở một Đối tỷ lệ kèo bóng đá hiện có

Để mở một đối tỷ lệ kèo bóng đá hiện có, hãy gọi

int lo_open (pgconn *Conn, oid lobjid, mode int)

9542_9756LO_OPENTrả về a Bộ mô tả đối tỷ lệ kèo bóng đá để sử dụng saulo_read, lo_write, lo_lseek, LO_TELLvàLO_CLOSE.

Viết dữ liệu vào một đối tỷ lệ kèo bóng đá

thói quen

int lo_write (pgconn *Conn, int fd, const char *buf, size_t len)

Viết các byte len từ BUF đến đối tỷ lệ kèo bóng đá FD. Đối số FD Phải được trả lại bởi trước đólo_open. Số lượng byte thực sự được viết là trả lại. Trong trường hợp lỗi, giá trị trả về là âm.

Đọc dữ liệu từ một đối tỷ lệ kèo bóng đá

thói quen

int lo_read (pgconn *Conn, int fd, char *buf, size_t len)

Đọc các byte len từ đối tỷ lệ kèo bóng đá FD thành BYF. FD Đối số phải được trả lại bởi trước đólo_open. Số lượng byte thực sự đọc là trả lại. Trong trường hợp lỗi, giá trị trả về là âm.

Tìm kiếm trên a Đối tỷ lệ kèo bóng đá

Để thay đổi vị trí đọc hoặc ghi hiện tại trên một đối tỷ lệ kèo bóng đá, gọi

int lo_lseek (pgconn *Conn, int fd, int offset, int whence)

thói quen này di chuyển con trỏ vị trí hiện tại cho lớn Đối tỷ lệ kèo bóng đá được mô tả bởi FD đến vị trí mới được chỉ định bởi Offset. Các Các giá trị hợp lệ cho các giá trị là tìm kiếm, seek_cur và seek_end.

Đóng một lớn Mô tả đối tỷ lệ kèo bóng đá

Một đối tỷ lệ kèo bóng đá có thể được đóng bằng cách gọi

int lo_close (pgconn *Conn, int fd)

Trong đó FD là một mô tả đối tỷ lệ kèo bóng đá được trả về bởilo_open. Về thành công,lo_closeTrả về 0. Do lỗi, giá trị trả về là tiêu cực.