Phiên bản được hỗ trợ:hiện tại(17)16/15/14/13
Phiên bản phát triển:Devel
Phiên bản tỷ lệ kèo bóng đá tối nay được hỗ trợ:12/11/10/9.6/9.5/9.4/9.3/9.2/9.1/9.0/8.4/8.3/8.2/8.1/8.0/7.4/7.3/7.2/7.1

33.3.Chức năng thực thi tỷ lệ kèo bóng đá tối nay

Sau khi kết nối với máy chủ cơ sở dữ liệu đã được thiết lập thành công, các chức năng được mô tả ở đây được sử dụng để thực hiện các truy vấn và tỷ lệ kèo bóng đá tối nay SQL.

33.3.1.Chức tỷ lệ kèo bóng đá tối nay chính

PQEXEC

gửi tỷ lệ kèo bóng đá tối nay lên máy chủ và chờ kết quả.

PGRESULT *PQEXEC (PGCONN *Conn, Const Char *Command);

Trả về ApgresultCon trỏ hoặc có thể là một con trỏ null. Một con trỏ không null thường sẽ được trả về ngoại trừ trong các điều kiện ngoài bộ nhớ hoặc các lỗi nghiêm trọng như không có khả năng gửi tỷ lệ kèo bóng đá tối nay đến máy chủ.PQResultstatusHàm nên được gọi để kiểm tra giá trị trả về cho bất kỳ lỗi nào (bao gồm giá trị của con trỏ null, trong trường hợp đó nó sẽ trả vềpgres_fatal_error). Sử dụngpqerrormessageĐể biết thêm thông tin về tỷ lệ kèo bóng đá tối nay lỗi đó.

Chuỗi tỷ lệ kèo bóng đá tối nay có thể bao gồm nhiều tỷ lệ kèo bóng đá tối nay SQL (được phân tách bằng dấu chấm phẩy). Nhiều truy vấn được gửi trong mộtPQEXECcuộc gọi được xử lý trong tỷ lệ kèo bóng đá tối nay giao dịch, trừ khi có rõ ràngbắt đầu/cam kếtCác tỷ lệ kèo bóng đá tối nay có trong chuỗi truy vấn để chia nó thành nhiều giao dịch. (Nhìn thấyPhần 52.2.2.1Để biết thêm chi tiết về cách máy chủ xử lý tỷ lệ kèo bóng đá tối nay chuỗi nhiều chuỗi.) Tuy nhiên, lưu ý rằng đã trả vềpgresultCấu trúc chỉ mô tả kết quả của tỷ lệ kèo bóng đá tối nay cuối cùng được thực thi từ chuỗi. Nếu một trong các tỷ lệ kèo bóng đá tối nay không thành công, việc xử lý chuỗi dừng lại với nó và đã trả vềpgresultMô tả tình trạng lỗi.

PQExecparams

gửi tỷ lệ kèo bóng đá tối nay lên máy chủ và chờ kết quả, với khả năng truyền các tham số riêng biệt với văn bản tỷ lệ kèo bóng đá tối nay SQL.

PGRESULT *PQEXECPARAMS (PGConn *Conn,

PQExecParamsgiống nhưPQEXEC, nhưng cung cấp chức năng bổ sung: Các giá trị tham số có thể được chỉ định riêng biệt với chuỗi tỷ lệ kèo bóng đá tối nay thích hợp và kết quả truy vấn có thể được yêu cầu ở định dạng văn bản hoặc nhị phân.PQExecparamschỉ được hỗ trợ trong giao thức 3.0 trở lên tỷ lệ kèo bóng đá tối nay kết nối sau; nó sẽ thất bại khi sử dụng giao thức 2.0.

Các đối số chức tỷ lệ kèo bóng đá tối nay là:

Conn

Đối tượng kết nối để gửi tỷ lệ kèo bóng đá tối nay qua.

tỷ lệ kèo bóng đá tối nay

Chuỗi tỷ lệ kèo bóng đá tối nay SQL được thực thi. Nếu các tham số được sử dụng, chúng được gọi trong chuỗi tỷ lệ kèo bóng đá tối nay là$ 1,$ 2, v.v.

nparams

Số lượng tham số được cung cấp; nó là độ dài của tỷ lệ kèo bóng đá tối nay mảngparamtypes [],paramValues ​​[],paramlength []paramformats []. (Con trỏ mảng có thể lànullKhinparamsbằng tỷ lệ kèo bóng đá tối nay.)

paramtypes []

Chỉ định, bởi OID, tỷ lệ kèo bóng đá tối nay loại dữ liệu được gán cho tỷ lệ kèo bóng đá tối nay ký hiệu tham số. Nếu nhưparamtypes16725_16731null16761_16926

paramValues ​​[]

Chỉ định các giá trị thực của các tham số. tỷ lệ kèo bóng đá tối nay con trỏ null trong mảng này có nghĩa là tham số tương ứng là null;

paramlengths []

Chỉ định độ dài dữ liệu thực tế của tỷ lệ kèo bóng đá tối nay tham số định dạng nhị phân. Nó bị bỏ qua cho tỷ lệ kèo bóng đá tối nay tham số null và tỷ lệ kèo bóng đá tối nay tham số định dạng văn bản.

paramformats []

Chỉ định xem các tham số có phải là văn bản hay tỷ lệ kèo bóng đá tối nay (đặt số 0 trong mục mảng cho tham số tương ứng) hoặc nhị phân (đặt một trong một mục nhập mảng cho tham số tương ứng). Nếu con trỏ mảng là null thì tất cả các tham số được coi là chuỗi văn bản.

Giá trị được truyền ở định dạng nhị phân đòi hỏi kiến ​​thức về biểu diễn nội bộ được dự kiến ​​bởi phần phụ trợ. Ví dụ, tỷ lệ kèo bóng đá tối nay số nguyên phải được thông qua theo thứ tự byte mạng.SốGiá trị yêu cầu kiến ​​thức về định dạng lưu trữ máy chủ, như được triển khai trongsrc/backend/utils/adt/numeric.c :: numeric_recv ().

resultFormat

Chỉ định số 0 để có được kết quả ở định dạng văn bản hoặc một để có được kết quả ở định dạng nhị phân. (Hiện tại tỷ lệ kèo bóng đá tối nay có điều khoản nào để có được các cột kết quả khác nhau ở các định dạng khác nhau, mặc dù điều đó là có thể trong giao thức cơ bản.)

Ưu điểm chính củaPQExecparamsOverPQEXEC19341_19483

tỷ lệ kèo bóng đá tối nay giống nhưPQEXEC,PQExecparamsCho phép nhiều nhất một tỷ lệ kèo bóng đá tối nay SQL trong chuỗi đã cho. .

Tip

Chỉ định các loại tham số thông qua OID là tẻ nhạt, đặc biệt nếu bạn tỷ lệ kèo bóng đá tối nay thích các giá trị OID đặc biệt của dây cứng vào chương trình của bạn. Tuy nhiên, bạn có thể tránh làm như vậy ngay cả trong trường hợp máy chủ tự nó tỷ lệ kèo bóng đá tối nay thể xác định loại tham số hoặc chọn một loại khác với bạn muốn.

Chọn * Từ MyTable WHERE X = $ 1 :: Bigint;

Tham số lực lượng này$ 1được coi làBigint, trong khi theo mặc định, nó sẽ được gán cùng loại vớiX. Buộc quyết định loại tham số, theo cách này hoặc bằng cách chỉ định loại OID số, ​​được khuyến nghị mạnh mẽ khi gửi các giá trị tham số ở định dạng nhị phân, bởi vì định dạng nhị phân có ít dự phòng hơn định dạng văn bản và do đó ít có khả năng máy chủ sẽ phát hiện ra lỗi tỷ lệ kèo bóng đá tối nay khớp loại cho bạn.

PQPrepare

Đệ trình yêu cầu tạo câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị với các tham số đã cho và chờ hoàn thành.

pgresult *pqprepare (pgconn *Conn,

PQPrepareTạo một câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị để thực hiện sau vớiPQEXECPREPARED. Tính năng này cho phép các tỷ lệ kèo bóng đá tối nay được thực thi nhiều lần mà không bị phân tích cú pháp và được lên kế hoạch mỗi lần;Chuẩn bịĐể biết chi tiết.PQPreparechỉ được hỗ trợ trong giao thức 3.0 trở lên tỷ lệ kèo bóng đá tối nay kết nối sau; nó sẽ thất bại khi sử dụng giao thức 2.0.

Hàm tạo ra một câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị có tênstmtnametừTruy vấnChuỗi, phải chứa một tỷ lệ kèo bóng đá tối nay SQL duy nhất.stmtnamecó thể""Để tạo một tuyên bố chưa được đặt tên, trong trường hợp đó, bất kỳ câu tỷ lệ kèo bóng đá tối nay chưa được đặt tên nào đã có từ trước được tự động thay thế; Nếu không thì đó là một lỗi nếu tên câu tỷ lệ kèo bóng đá tối nay đã được xác định trong phiên hiện tại.$ 1,$ 2, v.v.nparamslà số lượng tham số cho tỷ lệ kèo bóng đá tối nay loại được chỉ định trước trong mảngparamtypes []. (Con trỏ mảng có thể lànullKhinparamsbằng tỷ lệ kèo bóng đá tối nay.)paramtypes []Chỉ định, bởi OID, tỷ lệ kèo bóng đá tối nay loại dữ liệu được gán cho tỷ lệ kèo bóng đá tối nay ký hiệu tham số. Nếu nhưparamtypesnullhoặc bất kỳ phần tử cụ thể nào trong mảng bằng tỷ lệ kèo bóng đá tối nay, máy chủ gán một loại dữ liệu cho ký hiệu tham số theo cùng một cách nó sẽ làm cho một chuỗi chữ tỷ lệ kèo bóng đá tối nay bị lỗi. Ngoài ra, truy vấn có thể sử dụng các ký hiệu tham số có số cao hơnnparams; tỷ lệ kèo bóng đá tối nay loại dữ liệu cũng sẽ được suy ra cho tỷ lệ kèo bóng đá tối nay biểu tượng này.Đối với tỷ lệ kèo bóng đá tối nay phương tiện để tìm hiểu các loại dữ liệu nào đã được suy ra.)

như vớiPQEXEC, kết quả thường làpgresultĐối tượng có nội dung biểu thị thành công hoặc thất bại phía máy chủ. Một kết quả null chỉ ra bộ nhớ ngoài hoặc không có khả năng gửi tỷ lệ kèo bóng đá tối nay.pqerrormessageĐể biết thêm thông tin về tỷ lệ kèo bóng đá tối nay lỗi đó.

Câu tỷ lệ kèo bóng đá tối nay được chuẩn bị để sử dụng vớiPQEXECPREPAREDcũng có thể được tạo bằng cách thực thi SQLChuẩn bịCâu tỷ lệ kèo bóng đá tối nay. Ngoài ra, mặc dù không cólibpqHàm để xóa câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị, SQLDealLocateCâu tỷ lệ kèo bóng đá tối nay có thể được sử dụng cho mục đích đó.

PQEXECPREPARED

Gửi yêu cầu thực thi câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị với các tham số đã cho và chờ kết quả.

PGRESULT *PQEXECPREPARED (PGConn *Conn,

PQEXECPREPAREDgiống nhưPQExecparams, nhưng tỷ lệ kèo bóng đá tối nay sẽ được thực thi được chỉ định bằng cách đặt tên một câu tỷ lệ kèo bóng đá tối nay được chuẩn bị trước đó, thay vì đưa ra một chuỗi truy vấn. Tính năng này cho phép các tỷ lệ kèo bóng đá tối nay sẽ được sử dụng nhiều lần để được phân tích cú pháp và được lên kế hoạch chỉ một lần, thay vì mỗi lần chúng được thực thi.PQEXECPREPAREDchỉ được hỗ trợ trong giao thức 3.0 và tỷ lệ kèo bóng đá tối nay kết nối sau đó; nó sẽ thất bại khi sử dụng giao thức 2.0.

tỷ lệ kèo bóng đá tối nay tham số giống hệt vớiPQExecparams, ngoại trừ tên của câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị được đưa ra thay vì chuỗi truy vấn vàparamtypes []tham số không có mặt (không cần thiết vì các loại tham số của câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị được xác định khi nó được tạo).

Đệ trình yêu cầu lấy thông tin về câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị được chỉ định và chờ hoàn thành.

27468_27537

Cho phép một ứng dụng lấy thông tin về câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị trước đó.chỉ được hỗ trợ trong tỷ lệ kèo bóng đá tối nay kết nối giao thức 3.0 trở lên; nó sẽ thất bại khi sử dụng giao thức 2.0.

stmtnamecó thể""hoặcnullĐể tham khảo câu tỷ lệ kèo bóng đá tối nay không được đặt tên, nếu không nó phải là tên của một câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị hiện có. Về thành công, Apgresultvới trạng tháiPGRES_COMMAND_OKđược trả về. Các chức tỷ lệ kèo bóng đá tối naypqnparamsPQParamTypecó thể được áp dụng cho điều nàypgresultĐể có được thông tin về các tham số của câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị và các hàmPQNFields,PQFNAME,PQFTYPE, vv Cung cấp thông tin về các cột kết quả (nếu có) của câu tỷ lệ kèo bóng đá tối nay.

Đệ trình yêu cầu lấy thông tin về cổng thông tin được chỉ định và chờ hoàn thành.

PGRESULT *

PQDescriptePortalCho phép tỷ lệ kèo bóng đá tối nay ứng dụng lấy thông tin về cổng thông tin được tạo trước đó. (libpqtỷ lệ kèo bóng đá tối nay cung cấp bất kỳ quyền truy cập trực tiếp nào vào cổng, nhưng bạn có thể sử dụng chức năng này để kiểm tra các thuộc tính của con trỏ được tạo bằngTuyên bố con trỏtỷ lệ kèo bóng đá tối nay SQL.)PQDescriptePortalchỉ được hỗ trợ trong giao thức 3.0 trở lên tỷ lệ kèo bóng đá tối nay kết nối sau; nó sẽ thất bại khi sử dụng giao thức 2.0.

PortalNamecó thể""hoặcnullĐể tham khảo cổng thông tin tỷ lệ kèo bóng đá tối nay tên, nếu tỷ lệ kèo bóng đá tối nay nó phải là tên của một cổng thông tin hiện có. Về thành công, APGRESULTVới trạng tháiPGRES_COMMAND_OKđược trả về. Các chức tỷ lệ kèo bóng đá tối nayPQNFields,PQFNAME,PQFTYPE, v.v.PGRESULTĐể có được thông tin về tỷ lệ kèo bóng đá tối nay cột kết quả (nếu có) của cổng thông tin.

ThepgresultCấu trúc đóng gói kết quả được trả về bởi máy chủ.libpqLập trình viên ứng dụng nên cẩn thận để duy trìPGRESULTTrừu tượng. Sử dụng các chức tỷ lệ kèo bóng đá tối nay của người phụ kiện bên dưới để có được nội dung củapgresult. Tránh trực tiếp tham chiếu tỷ lệ kèo bóng đá tối nay trường củapgresultCấu trúc vì chúng có thể thay đổi trong tương lai.

PQResultstatus

Trả về trạng thái kết quả của tỷ lệ kèo bóng đá tối nay.

31958_32013

PQResultstatusCó thể trả về tỷ lệ kèo bóng đá tối nay trong các giá trị sau:

PGRES_EMPTY_Query

Chuỗi được gửi đến máy chủ trống.

PGRES_COMMAND_OK

Hoàn thành thành công tỷ lệ kèo bóng đá tối nay trả về không có dữ liệu.

PGRES_TUDS_OK

Hoàn thành thành công dữ liệu trả về tỷ lệ kèo bóng đá tối nay (chẳng hạn như AChọnhoặcshow).

PGRES_COPY_OUT

Sao chép (từ máy chủ) BẮT ĐẦU DỮ LIỆU.

PGRES_COPY_IN

Sao chép (vào máy chủ) bắt đầu truyền dữ liệu.

pgres_bad_response

Phản hồi của máy chủ tỷ lệ kèo bóng đá tối nay được hiểu.

PGRES_NONFATAL_ERROR

Đã xảy ra lỗi tỷ lệ kèo bóng đá tối nay sinh (thông báo hoặc cảnh báo).

PGRES_FATAL_ERROR

Đã xảy ra lỗi nghiêm trọng.

PGRES_COPY_BOTH

Sao chép vào/ra (đến và từ máy chủ) Truyền dữ liệu bắt đầu. Tính năng này hiện chỉ được sử dụng để sao chép phát trực tuyến, vì vậy trạng thái này tỷ lệ kèo bóng đá tối nay nên xảy ra trong các ứng dụng thông thường.

pgres_single_tuple

ThePGRESULTchứa một kết quả duy nhất từ ​​tỷ lệ kèo bóng đá tối nay hiện tại. Trạng thái này chỉ xảy ra khi chế độ hàng đơn đã được chọn cho truy vấn (xemPhần 33.5).

Nếu trạng thái kết quả làPGRES_TUDS_OKhoặcpgres_single_tuple, sau đó các chức tỷ lệ kèo bóng đá tối nay được mô tả dưới đây có thể được sử dụng để truy xuất các hàng được trả về bởi truy vấn. Lưu ý rằng AChọntỷ lệ kèo bóng đá tối nay xảy ra để truy xuất các hàng không vẫn hiển thịPGRES_TUDS_OK.PGRES_COMMAND_OKdành cho các tỷ lệ kèo bóng đá tối nay không bao giờ có thể trả lại hàng (ChènhoặcCập nhậttỷ lệ kèo bóng đá tối nay cóTrở vềmệnh đề, v.v.). tỷ lệ kèo bóng đá tối nay phản hồi củapgres_empty_queryCó thể chỉ ra tỷ lệ kèo bóng đá tối nay lỗi trong phần mềm máy khách.

Kết quả của trạng tháiPGRES_NONFATAL_ERRORsẽ tỷ lệ kèo bóng đá tối nay bao giờ được trả về trực tiếp bởiPQEXEChoặc các chức tỷ lệ kèo bóng đá tối nay thực thi truy vấn khác; Kết quả của loại này thay vào đó được chuyển cho bộ xử lý thông báo (xemPhần 33.12).

pqresstatus

Chuyển đổi loại được liệt kê được trả về bởiPQResultstatusthành một hằng số chuỗi mô tả mã trạng thái. Người gọi tỷ lệ kèo bóng đá tối nay nên giải phóng kết quả.

36730_36775
pqresulterrormessage

Trả về thông báo lỗi được liên kết với tỷ lệ kèo bóng đá tối nay hoặc một chuỗi trống nếu không có lỗi.

char *pqresulterrormessage (const pgresult *res);

Nếu có lỗi, chuỗi được trả về sẽ bao gồm một dòng mới. Người gọi tỷ lệ kèo bóng đá tối nay nên giải phóng kết quả trực tiếp.PGRESULTXử lý được chuyển choPQClear.

ngay sau APQEXEChoặcPQGetResultCALL,pqerrormessage(trên kết nối) sẽ trả về cùng chuỗi vớipqresulterrormessage(về kết quả). Tuy nhiên, APGRESULTSẽ giữ lại thông báo lỗi cho đến khi bị phá hủy, trong khi thông báo lỗi của kết nối sẽ thay đổi khi tỷ lệ kèo bóng đá tối nay hoạt động tiếp theo được thực hiện. Sử dụngpqresulterrormessageKhi bạn muốn biết trạng thái được liên kết với tỷ lệ kèo bóng đá tối nay cụ thểPGRESULT; sử dụngpqerrormessageKhi bạn muốn biết trạng thái từ thao tác mới nhất trên kết nối.

pqresultverboseerrormessage

Trả về tỷ lệ kèo bóng đá tối nay phiên bản được định dạng lại của thông báo lỗi được liên kết với APGRESULTĐối tượng.

Char *pqresultverboseerrormessage (const pgresult *res,

Trong tỷ lệ kèo bóng đá tối nay số tình huống, khách hàng có thể muốn có được phiên bản chi tiết hơn của lỗi được báo cáo trước đó.pqresultverboseerrormessageĐịa chỉ nhu cầu này bằng cách tính toán thông điệp sẽ được tạo bởipqresulterrormessageNếu tỷ lệ kèo bóng đá tối nay cài đặt độ xác được chỉ định đã có hiệu lực cho kết nối khiPGRESULTđã được tạo ra. NếuPGRESULTtỷ lệ kèo bóng đá tối nay phải là kết quả lỗi,"pgresult tỷ lệ kèo bóng đá tối nay phải là kết quả lỗiHồiđược báo cáo thay thế. Chuỗi được trả về bao gồm tỷ lệ kèo bóng đá tối nay dòng mới.

tỷ lệ kèo bóng đá tối nay giống như hầu hết các chức năng khác để trích xuất dữ liệu từ Apgresult, kết quả của hàm này là tỷ lệ kèo bóng đá tối nay chuỗi mới được phân bổ. Người gọi phải giải phóng nó bằng cách sử dụngpqfreemem ()Khi chuỗi tỷ lệ kèo bóng đá tối nay còn cần thiết nữa.

Có thể trả lại null nếu tỷ lệ kèo bóng đá tối nay có đủ bộ nhớ.

pqresulterrorfield

Trả về tỷ lệ kèo bóng đá tối nay trường riêng lẻ của báo cáo lỗi.

Char *pqresulterrorfield (const pgresult *res, int fieldCode);

FieldCodelà tỷ lệ kèo bóng đá tối nay định danh trường lỗi; Xem các biểu tượng được liệt kê bên dưới.nullđược trả về nếupgresulttỷ lệ kèo bóng đá tối nay phải là một lỗi hoặc kết quả cảnh báo hoặc tỷ lệ kèo bóng đá tối nay bao gồm trường được chỉ định. Giá trị trường thường sẽ tỷ lệ kèo bóng đá tối nay bao gồm một dòng mới.PGRESULTXử lý được chuyển choPQClear.

Mã trường sau đây có sẵn:

pg_diag_severity

mức độ nghiêm trọng; Nội dung trường làERROR,FatalhoặcPanic(trong tỷ lệ kèo bóng đá tối nay thông báo lỗi) hoặccảnh báo,Thông báo,Debug,INFOhoặclog(trong tỷ lệ kèo bóng đá tối nay thông báo thông báo) hoặc bản dịch cục bộ của tỷ lệ kèo bóng đá tối nay trong số này. Luôn luôn có mặt.

pg_diag_severity_nonlocalized

Mức độ nghiêm trọng; Nội dung trường làERROR,FatalhoặcPanic(trong tỷ lệ kèo bóng đá tối nay thông báo lỗi) hoặcCẢNH BÁO,Thông báo,Debug,INFOhoặclog(Trong tỷ lệ kèo bóng đá tối nay thông báo thông báo). Điều này giống hệt vớipg_diag_severityTrường ngoại trừ các nội dung tỷ lệ kèo bóng đá tối nay bao giờ được bản địa hóa. Điều này chỉ có trong các báo cáo được tạo bởiPostgreSQLPhiên bản 9.6 trở lên.

PG_DIAG_SQLSTATE

Mã SQLSTATE cho lỗi. Mã SQLSTATE xác định loại lỗi đã xảy ra;Phụ lục A. Trường này tỷ lệ kèo bóng đá tối nay thể bản địa hóa và luôn có mặt.

pg_diag_message_primary

Thông báo lỗi có thể đọc được chính của con người (thường là tỷ lệ kèo bóng đá tối nay dòng). Luôn luôn có mặt.

PG_DIAG_MESSAGE_DETAIL

Chi tiết: Thông báo lỗi thứ cấp tùy chọn mang thêm chi tiết về vấn đề. Có thể chạy đến nhiều dòng.

PG_DIAG_MESSAGE_HINT

Gợi ý: Một đề xuất tùy chọn phải làm gì về vấn đề. Điều này nhằm khác với chi tiết ở chỗ nó cung cấp lời khuyên (có khả năng tỷ lệ kèo bóng đá tối nay phù hợp) thay vì sự thật khó khăn.

pg_diag_statement_poseition

Một chuỗi chứa số nguyên thập phân cho biết vị trí con trỏ lỗi làm chỉ mục vào chuỗi câu tỷ lệ kèo bóng đá tối nay gốc. Ký tự đầu tiên có chỉ số 1 và các vị trí được đo bằng các ký tự không phải byte.

Điều này được xác định giống nhưpg_diag_statement_poseitionTrường, nhưng nó được sử dụng khi vị trí con trỏ đề cập đến một tỷ lệ kèo bóng đá tối nay được tạo bên trong thay vì tỷ lệ kèo bóng đá tối nay được gửi bởi máy khách. ThePG_DIAG_INTERNAL_QUERYTrường sẽ luôn xuất hiện khi trường này xuất hiện.

PG_DIAG_INTERNAL_QUERY

Văn bản của một tỷ lệ kèo bóng đá tối nay không thành công trong nội bộ. Ví dụ, đây có thể là một truy vấn SQL do chức năng PL/PGSQL phát hành.

PG_DIAG_CONTEXT

Một dấu hiệu của bối cảnh xảy ra lỗi. Hiện tại điều này bao gồm một dấu vết Call Stack của các chức tỷ lệ kèo bóng đá tối nay ngôn ngữ thủ tục hoạt động và các truy vấn được tạo trong nội bộ.

pg_diag_schema_name

Nếu lỗi được liên kết với tỷ lệ kèo bóng đá tối nay đối tượng cơ sở dữ liệu cụ thể, tên của lược đồ chứa đối tượng đó, nếu có.

PG_DIAG_TABLE_NAME

Nếu lỗi được liên kết với tỷ lệ kèo bóng đá tối nay bảng cụ thể, tên của bảng. (Tham khảo trường Tên lược đồ cho tên của lược đồ bảng.)

PG_DIAG_COLUMN_NAME

Nếu lỗi được liên kết với tỷ lệ kèo bóng đá tối nay cột bảng cụ thể, tên của cột. (Tham khảo Lược đồ và các trường tên bảng để xác định bảng.)

pg_diag_datatype_name

Nếu lỗi được liên kết với tỷ lệ kèo bóng đá tối nay loại dữ liệu cụ thể, tên của kiểu dữ liệu. (Tham khảo trường Tên lược đồ cho tên của lược đồ loại dữ liệu.)

pg_diag_constraint_name

Nếu lỗi được liên kết với tỷ lệ kèo bóng đá tối nay ràng buộc cụ thể, tên của ràng buộc. Tham khảo các trường được liệt kê ở trên cho bảng hoặc miền liên quan.

PG_DIAG_SOURCE_FILE

Tên tệp của vị trí mã nguồn nơi báo cáo lỗi.

pg_diag_source_line

Số dòng của vị trí mã nguồn nơi báo cáo lỗi.

PG_DIAG_SOURCE_FUNCTION

Tên của chức tỷ lệ kèo bóng đá tối nay mã nguồn báo cáo lỗi.

Lưu ý

Các trường cho tên lược đồ, tên bảng, tên cột, tên loại dữ liệu và tên ràng buộc chỉ được cung cấp cho tỷ lệ kèo bóng đá tối nay số loại lỗi giới hạn; nhìn thấyPhụ lục A. tỷ lệ kèo bóng đá tối nay cho rằng sự hiện diện của bất kỳ trường nào trong số này đảm bảo sự hiện diện của trường khác.

Khách hàng chịu trách nhiệm định dạng thông tin hiển thị để đáp ứng nhu cầu của nó; Đặc biệt nó nên phá vỡ tỷ lệ kèo bóng đá tối nay hàng dài khi cần thiết.

Lỗi được tạo bên tronglibpqsẽ có mức độ nghiêm trọng và thông điệp chính, nhưng thường tỷ lệ kèo bóng đá tối nay có trường nào khác. Lỗi được trả về bởi máy chủ Pre-3.0 Protocol sẽ bao gồm mức độ nghiêm trọng và tin nhắn chính và đôi khi là một thông báo chi tiết, nhưng tỷ lệ kèo bóng đá tối nay có trường nào khác.

Lưu ý rằng tỷ lệ kèo bóng đá tối nay trường lỗi chỉ khả dụng từpgresultĐối tượng, tỷ lệ kèo bóng đá tối nayPGConnĐối tượng; tỷ lệ kèo bóng đá tối nay cópqerrorfieldchức tỷ lệ kèo bóng đá tối nay.

PQClear

giải phóng bộ nhớ liên kết với Apgresult. Mọi kết quả tỷ lệ kèo bóng đá tối nay phải được giải phóng quaPQClearKhi nó tỷ lệ kèo bóng đá tối nay còn cần thiết nữa.

void pqClear (pgresult *res);

Bạn có thể giữpgresultĐối tượng xung quanh miễn là bạn cần nó; Nó không biến mất khi bạn đưa ra một tỷ lệ kèo bóng đá tối nay mới, cũng như ngay cả khi bạn đóng kết nối.PQClear. tỷ lệ kèo bóng đá tối nay làm điều này sẽ dẫn đến rò rỉ bộ nhớ trong ứng dụng của bạn.

33.3.2.Truy xuất thông tin kết quả truy vấn

Các chức tỷ lệ kèo bóng đá tối nay này được sử dụng để trích xuất thông tin từ APGRESULTĐối tượng đại diện cho kết quả truy vấn thành công (nghĩa là, tỷ lệ kèo bóng đá tối nay đối tượng có trạng tháiPGRES_TUDS_OKhoặcpgres_single_tuple). Chúng cũng có thể được sử dụng để trích xuất thông tin từ một hoạt động mô tả thành công: Kết quả của một mô tả có tất cả thông tin cột giống nhau mà việc thực hiện truy vấn thực tế sẽ cung cấp, nhưng nó tỷ lệ kèo bóng đá tối nay có hàng.

PQNTUMPLES

Trả về số lượng hàng (bộ dữ liệu) trong kết quả truy vấn. (Lưu ý rằngPGRESULTĐối tượng bị giới hạn tỷ lệ kèo bóng đá tối nay quáint_maxhàng, vì vậyintKết quả là đủ.)

int pqntuples (const pgresult *res);
PQNFields

Trả về số lượng cột (trường) trong mỗi hàng của kết quả truy vấn.

int pqnfields (const pgresult *res);
PQFNAME

Trả về tên cột được liên kết với số cột đã cho. Số cột bắt đầu ở 0. Người gọi tỷ lệ kèo bóng đá tối nay được giải phóng trực tiếp kết quả.PGRESULTXử lý được chuyển choPQClear.

char *pqfname (const pgresult *res,

nullđược trả về nếu số cột nằm ngoài phạm vi.

PQFNumber

Trả về số cột được liên kết với tên cột đã cho.

int pqfnumber (const pgresult *res,

-1 được trả về nếu tên đã cho tỷ lệ kèo bóng đá tối nay khớp với bất kỳ cột nào.

Tên đã cho được đối xử như một định danh trong tỷ lệ kèo bóng đá tối nay SQL, nghĩa là nó bị hạ cấp trừ khi được trích dẫn kép. Ví dụ: đưa ra kết quả truy vấn được tạo từ tỷ lệ kèo bóng đá tối nay SQL:

Chọn 1 làm foo, 2 là "Bar";

Chúng tôi sẽ có kết quả:

pqfname (res, 0)foopqfname (res, 1)Barpqfnumber (res, "foo")0pqfnumber (res, "foo")0PQFNumber (res, "Bar")-1pqfnumber (res, "\" bar \ "")1
PQFTable

Trả về OID của bảng mà từ đó cột đã cho được tìm nạp. Số cột bắt đầu ở 0.

oid pqftable (const pgresult *res,

tỷ lệ kèo bóng đá tối nay hợp lệđược trả về nếu số cột nằm ngoài phạm vi hoặc nếu cột được chỉ định tỷ lệ kèo bóng đá tối nay phải là tham chiếu đơn giản đến cột bảng hoặc khi sử dụng giao thức Pre-3.0. Bạn có thể truy vấn bảng hệ thốngPG_ClassĐể xác định chính xác bảng nào được tham chiếu.

LoạiOIDvà hằng sốtỷ lệ kèo bóng đá tối nay hợp lệ​​sẽ được xác định khi bạn bao gồmlibpqTệp tiêu đề. Cả hai sẽ là tỷ lệ kèo bóng đá tối nay loại số nguyên.

pqftablecol

Trả về số cột (trong bảng của nó) của cột tạo thành cột Kết quả truy vấn được chỉ định. Số cột truy vấn-result bắt đầu ở 0, nhưng tỷ lệ kèo bóng đá tối nay cột bảng có số khác.

int pqftablecol (const pgresult *res,

Zero được trả về nếu số cột nằm ngoài phạm vi hoặc nếu cột được chỉ định tỷ lệ kèo bóng đá tối nay phải là tham chiếu đơn giản đến cột bảng hoặc khi sử dụng giao thức Pre-3.0.

PQFFormat

Trả về mã định dạng biểu thị định dạng của cột đã cho. Số cột bắt đầu ở 0.

int pqfformat (const pgresult *res,

Mã định dạng Zero biểu thị biểu diễn dữ liệu văn bản, trong khi mã định dạng tỷ lệ kèo bóng đá tối nay biểu thị nhị phân. (Các mã khác được dành cho định nghĩa trong tương lai.)

PQFTYPE

Trả về kiểu dữ liệu được liên kết với số cột đã cho. Số nguyên được trả về là số OID nội bộ của loại.

oid pqfttype (const pgresult *res,

Bạn có thể truy vấn bảng hệ thốngPG_TYPEĐể có được tên và thuộc tính của tỷ lệ kèo bóng đá tối nay loại dữ liệu khác nhau. TheoidS của tỷ lệ kèo bóng đá tối nay loại dữ liệu tích hợp được xác định trong tệpBao gồm/máy chủ/catalog/pg_type_d.hTrong thư mục cài đặt.

PQFMOD

Trả về bộ sửa đổi loại của cột được liên kết với số cột đã cho. Số cột bắt đầu ở 0.

int pqfmod (const pgresult *res,

Giải thích tỷ lệ kèo bóng đá tối nay giá trị sửa đổi là cụ thể về loại; Chúng thường chỉ ra giới hạn độ chính xác hoặc kích thước.tỷ lệ kèo bóng đá tối nay có thông tin. Hầu hết các loại dữ liệu tỷ lệ kèo bóng đá tối nay sử dụng bộ sửa đổi, trong trường hợp đó, giá trị luôn luôn -1.

pqfsize

Trả về kích thước theo byte của cột được liên kết với số cột đã cho. Số cột bắt đầu ở 0.

int pqfsize (const pgresult *res,

pqfsizeTrả về tỷ lệ kèo bóng đá tối nay gian được phân bổ cho cột này trong một hàng cơ sở dữ liệu, nói cách khác, kích thước của biểu diễn nội bộ của máy chủ của kiểu dữ liệu. (Theo đó, nó tỷ lệ kèo bóng đá tối nay thực sự hữu ích cho khách hàng.) Một giá trị âm cho biết loại dữ liệu có độ dài thay đổi.

PQBinaryTuples

Trả về 1 nếuPGRESULTChứa dữ liệu nhị phân và 0 nếu nó chứa dữ liệu văn bản.

int pqbinarytuples (const pgresult *res);

Hàm này được tỷ lệ kèo bóng đá tối nay dùng nữa (ngoại trừ việc sử dụng nó liên quan đếnCopy), bởi vì nó có thể cho tỷ lệ kèo bóng đá tối naypgresultĐể chứa dữ liệu văn bản trong tỷ lệ kèo bóng đá tối nay số cột và dữ liệu nhị phân trong các cột khác.PQFFormatđược ưu tiên.PQBinaryTupleschỉ trả về 1 nếu tất cả tỷ lệ kèo bóng đá tối nay cột của kết quả là nhị phân (định dạng 1).

PQGetValue

Trả về tỷ lệ kèo bóng đá tối nay giá trị trường duy nhất của tỷ lệ kèo bóng đá tối nay hàng của APGRESULT. Các số hàng và cột bắt đầu ở 0. Người gọi tỷ lệ kèo bóng đá tối nay được giải phóng trực tiếp kết quả.pgresultXử lý được chuyển choPQClear.

Char *pqgetValue (const pgresult *res,

Đối với dữ liệu ở định dạng văn bản, giá trị được trả về bởiPQGetValuelà biểu diễn chuỗi ký tự kết thúc của giá trị trường. Đối với dữ liệu ở định dạng nhị phân, giá trị nằm trong biểu diễn nhị phân được xác định bởi kiểu dữ liệuTYPSENDTyPreceivechức tỷ lệ kèo bóng đá tối nay. .

tỷ lệ kèo bóng đá tối nay chuỗi trống được trả về nếu giá trị trường là null. Nhìn thấyPQGetIsNullĐể phân biệt tỷ lệ kèo bóng đá tối nay giá trị null với tỷ lệ kèo bóng đá tối nay giá trị chuỗi trống.

Con trỏ được trả về bởiPQGetValueĐiểm để lưu trữ là tỷ lệ kèo bóng đá tối nay phần củaPGRESULTCấu trúc. Người ta tỷ lệ kèo bóng đá tối nay nên sửa đổi dữ liệu mà nó trỏ đến và người ta phải sao chép rõ ràng dữ liệu vào bộ nhớ khác nếu nó được sử dụng qua vòng đời củapgresultCấu trúc chính nó.

PQGetIsNull

Kiểm tra tỷ lệ kèo bóng đá tối nay trường cho giá trị null. Các số hàng và cột bắt đầu ở 0.

int pqgetisnull (const pgresult *res,

Hàm này trả về 1 nếu trường là null và 0 nếu nó chứa giá trị tỷ lệ kèo bóng đá tối nay null. (Lưu ý rằngPQGetValueSẽ trả về một chuỗi trống, tỷ lệ kèo bóng đá tối nay phải là một con trỏ null, cho một trường null.)

PQGetLpm

Trả về độ dài thực tế của giá trị trường tính bằng byte. tỷ lệ kèo bóng đá tối nay số hàng và cột bắt đầu ở 0.

int pqetlength (const pgresult *res,

Đây là độ dài dữ liệu thực tế cho giá trị dữ liệu cụ thể, nghĩa là kích thước của đối tượng được chỉ ra bởiPQGetValue. Đối với định dạng dữ liệu văn bản, điều này giống nhưstrlen (). Đối với định dạng nhị phân, đây là thông tin cần thiết.tỷ lệ kèo bóng đá tối naydựa vàopqfsizeĐể có được độ dài dữ liệu thực tế.

pqnparams

Trả về số lượng tham số của câu tỷ lệ kèo bóng đá tối nay đã chuẩn bị.

int pqnparams (const pgresult *res);

Hàm này chỉ hữu ích khi kiểm tra kết quả của. Đối với tỷ lệ kèo bóng đá tối nay loại truy vấn khác, nó sẽ trả về 0.

PQParamType

Trả về kiểu dữ liệu của tham số câu tỷ lệ kèo bóng đá tối nay được chỉ định. Số tham số bắt đầu ở 0.

oid pqparamtype (const pgresult *res, int param_number);

Hàm này chỉ hữu ích khi kiểm tra kết quả củaPQDespripePrepared. Đối với tỷ lệ kèo bóng đá tối nay loại truy vấn khác, nó sẽ trả về 0.

PQPrint

In ra tất cả tỷ lệ kèo bóng đá tối nay hàng và, tùy chọn, tên cột vào luồng đầu ra được chỉ định.

VOID PQPRINT (FILE *FOUT, / *luồng đầu ra * /

Hàm này trước đây được sử dụng bởiPSQLĐể in kết quả truy vấn, nhưng điều này tỷ lệ kèo bóng đá tối nay còn đúng nữa. Lưu ý rằng nó giả sử tất cả dữ liệu ở định dạng văn bản.

33.3.3.Lấy thông tin kết quả khác

Các chức tỷ lệ kèo bóng đá tối nay này được sử dụng để trích xuất thông tin khác từPGRESULTĐối tượng.

PQCMDSTATUS

Trả về thẻ trạng thái tỷ lệ kèo bóng đá tối nay từ tỷ lệ kèo bóng đá tối nay SQL đã tạoPGRESULT.

Char *pqcmdstatus (pgresult *res);

Thông thường đây chỉ là tên của tỷ lệ kèo bóng đá tối nay, nhưng nó có thể bao gồm dữ liệu bổ sung như số lượng hàng được xử lý. Người gọi không nên giải phóng kết quả trực tiếp.PGRESULTXử lý được chuyển choPQClear.

PQCMDTUMPLES

Trả về số lượng hàng bị ảnh hưởng bởi tỷ lệ kèo bóng đá tối nay SQL.

char *pqcmdtuples (pgresult *res);

Hàm này trả về tỷ lệ kèo bóng đá tối nay chuỗi chứa số lượng hàng bị ảnh hưởng bởiSQLCâu tỷ lệ kèo bóng đá tối nay đã tạoPGRESULT. Chức tỷ lệ kèo bóng đá tối nay này chỉ có thể được sử dụng sau khi thực hiệnChọn,Tạo bảng dưới dạng,Chèn,Cập nhật,Xóa,Di chuyển,FetchhoặcCopycâu tỷ lệ kèo bóng đá tối nay hoặc mộtthực thicủa tỷ lệ kèo bóng đá tối nay truy vấn đã chuẩn bị có chứaChèn,Cập nhậthoặcXóaTuyên bố. Nếu tỷ lệ kèo bóng đá tối nay đã tạopgresultlà bất cứ điều gì khác,PQCMDTUMPLESTrả về một chuỗi trống. Người gọi tỷ lệ kèo bóng đá tối nay nên giải phóng giá trị trả về trực tiếp.PGRESULTXử lý được chuyển choPQClear.

PQOIDVALUE

Trả về OIDcủa hàng được chèn, nếuSQLtỷ lệ kèo bóng đá tối nay làChènđã chèn chính xác tỷ lệ kèo bóng đá tối nay hàng vào tỷ lệ kèo bóng đá tối nay bảng có OID hoặc Athực thicủa tỷ lệ kèo bóng đá tối nay truy vấn đã chuẩn bị có chứa phù hợpChènTuyên bố. Nếu tỷ lệ kèo bóng đá tối nay, chức năng này trả vềtỷ lệ kèo bóng đá tối nay hợp lệ. Chức tỷ lệ kèo bóng đá tối nay này cũng sẽ trở lạitỷ lệ kèo bóng đá tối nay hợp lệNếu bảng bị ảnh hưởng bởiChènCâu tỷ lệ kèo bóng đá tối nay không chứa OIDS.

oid pqoidValue (const pgresult *res);
PQOIDSTATUS

Hàm này tỷ lệ kèo bóng đá tối nay được ủng hộPQOIDVALUEvà tỷ lệ kèo bóng đá tối nay an toàn cho luồng. Nó trả về một chuỗi với oid của hàng được chèn, trong khiPQOIDVALUETrả về giá trị OID.

char *pqoidstatus (const pgresult *res);

33.3.4.Thoát khỏi chuỗi để đưa vào các tỷ lệ kèo bóng đá tối nay SQL

pqescapeliteral
char *pqescapeliteral (pgconn *Conn, const char *str, size_t length);

pqescapeliteralthoát một chuỗi để sử dụng trong tỷ lệ kèo bóng đá tối nay SQL. Điều này rất hữu ích khi chèn các giá trị dữ liệu dưới dạng hằng số theo nghĩa đen trong các tỷ lệ kèo bóng đá tối nay SQL.pqescapeliteralThực hiện thao tác này.

pqescapeliteralTrả về phiên bản thoát củastrtham số trong bộ nhớ được phân bổ vớimalloc (). Bộ nhớ này nên được giải phóng bằng cách sử dụngpqfreemem ()Khi kết quả tỷ lệ kèo bóng đá tối nay còn cần thiết. tỷ lệ kèo bóng đá tối nay cần phải tính một byte bằng 0 và tỷ lệ kèo bóng đá tối nay nên được tính vàoLEGN. (Nếu tìm thấy một byte chấm dứt bằng tỷ lệ kèo bóng đá tối nay trướcLEGNbyte được xử lý,pqescapeliteraldừng ở số 0; Hành vi như vậy giống nhưstrncpy.) Chuỗi trả về có tất cả tỷ lệ kèo bóng đá tối nay ký tự đặc biệt được thay thế để chúng có thể được xử lý đúng cách bởiPostgreSQLTrình phân tích cú pháp theo nghĩa đen. tỷ lệ kèo bóng đá tối nay byte chấm dứt cũng được thêm vào.​​POSTGRESQLChuỗi chữ được bao gồm trong chuỗi kết quả.

ON ERROR,pqescapeliteralreturnnullvà tỷ lệ kèo bóng đá tối nay thông báo phù hợp được lưu trữ trongConnĐối tượng.

TIP

Điều đặc biệt quan trọng là phải trốn thoát thích hợp khi xử lý các chuỗi nhận được từ một nguồn tỷ lệ kèo bóng đá tối nay đáng tin cậy. Nếu tỷ lệ kèo bóng đá tối nay thì có rủi ro bảo mật: Bạn dễ bị tổn thương vớiSQL tiêmHồiCác cuộc tấn công trong đó các tỷ lệ kèo bóng đá tối nay SQL không mong muốn được đưa vào cơ sở dữ liệu của bạn.

Lưu ý rằng tỷ lệ kèo bóng đá tối nay cần thiết cũng tỷ lệ kèo bóng đá tối nay chính xác để thoát khi giá trị dữ liệu được truyền dưới dạng tham số riêng biệt trongPQExecparamshoặc tỷ lệ kèo bóng đá tối nay thói quen anh chị em của nó.

pqescapeidentifier
75766_75841

pqescapeidentifierthoát một chuỗi để sử dụng làm định danh SQL, chẳng hạn như bảng, cột hoặc tên chức năng. Điều này rất hữu ích khi mã định danh do người dùng cung cấp có thể chứa các ký tự đặc biệt nếu tỷ lệ kèo bóng đá tối nay sẽ tỷ lệ kèo bóng đá tối nay được hiểu là một phần của định danh bởi trình phân tích cú pháp SQL hoặc khi định danh có thể chứa các ký tự trường hợp trên có trường hợp nên được bảo quản.

pqescapeidentifierTrả về phiên bản củastrtham số thoát ra như tỷ lệ kèo bóng đá tối nay định danh SQL trong bộ nhớ được phân bổ vớimalloc (). Bộ nhớ này phải được giải phóng bằng cách sử dụngpqfreemem ()Khi kết quả tỷ lệ kèo bóng đá tối nay còn cần thiết. tỷ lệ kèo bóng đá tối nay cần phải tính một byte bằng 0 và tỷ lệ kèo bóng đá tối nay nên được tính vàoLEGN. (Nếu tìm thấy một byte chấm dứt bằng tỷ lệ kèo bóng đá tối nay trướclengthbyte được xử lý,pqescapeidentifierdừng ở số 0; Hành vi như vậy giống nhưstrncpy.) Chuỗi trả về có tất cả các ký tự đặc biệt được thay thế để nó được xử lý đúng như tỷ lệ kèo bóng đá tối nay định danh SQL. tỷ lệ kèo bóng đá tối nay byte chấm dứt cũng được thêm vào.

ON Lỗi,pqescapeidentifierreturnnullVà tỷ lệ kèo bóng đá tối nay thông báo phù hợp được lưu trữ trongConnĐối tượng.

TIP

77756_77901

pqescapestringConn
size_t pqescapestringconn (pgconn *Conn,

pqescapestringConnEscapes Chuỗi nghĩa đen, giống nhưpqescapeliteral. tỷ lệ kèo bóng đá tối nay giống nhưpqescapeliteral, người gọi có trách nhiệm cung cấp bộ đệm có kích thước phù hợp. Hơn nữa,pqescapestringConntỷ lệ kèo bóng đá tối nay tạo ra các trích dẫn đơn phải bao quanhPOSTGRESQLChuỗi chữ; Chúng nên được cung cấp trong tỷ lệ kèo bóng đá tối nay SQL rằng kết quả được chèn vào.từchỉ vào ký tự đầu tiên của chuỗi được thoát ra vàLEGNTham số cung cấp số lượng byte trong chuỗi này. tỷ lệ kèo bóng đá tối nay cần phải tính một byte bằng 0 và tỷ lệ kèo bóng đá tối nay nên được tính vàoLEGN. (Nếu tìm thấy một byte chấm dứt bằng tỷ lệ kèo bóng đá tối nay trướclengthbyte được xử lý,pqescapestringConndừng ở số 0; Hành vi như vậy giống nhưstrncpy.)đếnsẽ chỉ vào bộ đệm có thể giữ ít nhất tỷ lệ kèo bóng đá tối nay byte nữa so với giá trị củalength, nếu tỷ lệ kèo bóng đá tối nay thì hành vi tỷ lệ kèo bóng đá tối nay được xác định. Hành vi cũng tỷ lệ kèo bóng đá tối nay được xác định nếuđếntừChuỗi chồng chéo.

NếuERRORtham số tỷ lệ kèo bóng đá tối nay phảinull, sau đó*Lỗiđược đặt thành 0 khi thành công, tỷ lệ kèo bóng đá tối nay có lỗi. Hiện tại các điều kiện lỗi duy nhất có thể liên quan đến mã hóa đa tỷ lệ kèo bóng đá tối nay hợp lệ trong chuỗi nguồn.ConnĐối tượng, có hay tỷ lệ kèo bóng đá tối nayERRORnull.

pqescapestringConnTrả về số byte được viết thànhđến, tỷ lệ kèo bóng đá tối nay bao gồm việc chấm dứt byte.

pqescapestring

pqescapestringlà phiên bản cũ hơn, tỷ lệ kèo bóng đá tối nay dùng nữa củapqescapestringConn.

size_t pqescapestring (char *to, const char *từ, size_t length);

Sự khác biệt duy nhất so vớipqescapestringConnpqescapestringtỷ lệ kèo bóng đá tối nay lấyPGConnhoặcERRORtham số. Bởi vì điều này, nó tỷ lệ kèo bóng đá tối nay thể điều chỉnh hành vi của nó tùy thuộc vào các thuộc tính kết nối (chẳng hạn như mã hóa ký tự) và do đóNó có thể cho kết quả sai. Ngoài ra, nó tỷ lệ kèo bóng đá tối nay có cách nào để báo cáo các điều kiện lỗi.

pqescapestringcó thể được sử dụng tỷ lệ kèo bóng đá tối nay cách an toàn trong các chương trình khách hàng chỉ làm việc với tỷ lệ kèo bóng đá tối nayPostgreSQLKết nối tại tỷ lệ kèo bóng đá tối nay thời điểm (trong trường hợp này nó có thể tìm ra những gì nó cần biếtPhía sau hậu trường). Trong các bối cảnh khác, đó là tỷ lệ kèo bóng đá tối nay mối nguy hiểm bảo mật và nên tránh có lợi chopqescapestringConn.

pqescapyteaconn

thoát dữ liệu nhị phân để sử dụng trong tỷ lệ kèo bóng đá tối nay SQL với loạibytea. Như vớipqescapestringConn, Điều này chỉ được sử dụng khi chèn dữ liệu trực tiếp vào chuỗi tỷ lệ kèo bóng đá tối nay SQL.

Char tỷ lệ kèo bóng đá tối nay dấu *pqescapyteaconn (PGConn *Conn,

Giá trị byte nhất định phải được thoát khi được sử dụng như tỷ lệ kèo bóng đá tối nay phần của Abyteanghĩa đen trong tỷ lệ kèo bóng đá tối naySQLcâu tỷ lệ kèo bóng đá tối nay.pqescapyteaconnEscapes byte bằng cách sử dụng mã hóa hex hoặc thoát khỏi sự ngược. Nhìn thấyPhần 8.4Để biết thêm thông tin.

ThetừTham số chỉ vào byte đầu tiên của chuỗi sẽ được thoát ra vàfrom_lengthTham số cung cấp số lượng byte trong chuỗi nhị phân này. (Một byte kết thúc bằng tỷ lệ kèo bóng đá tối nay là tỷ lệ kèo bóng đá tối nay cần thiết cũng như tỷ lệ kèo bóng đá tối nay được tính.)to_lengthTham số trỏ đến tỷ lệ kèo bóng đá tối nay biến sẽ giữ độ dài chuỗi thoát ra kết quả. Độ dài chuỗi kết quả này bao gồm kết thúc bằng 0 byte của kết quả.

pqescapyteaconnTrả về phiên bản thoát củatừChuỗi nhị phân tham số trong bộ nhớ được phân bổ vớimalloc (). Bộ nhớ này nên được giải phóng bằng cách sử dụngpqfreemem ()Khi kết quả tỷ lệ kèo bóng đá tối nay còn cần thiết. Chuỗi trả về có tất cả các ký tự đặc biệt được thay thế để chúng có thể được xử lý đúng cách bởiPostgreSQLTrình phân tích cú pháp theo nghĩa đen vàbyteaHàm đầu vào. tỷ lệ kèo bóng đá tối nay byte chấm dứt cũng được thêm vào.PostgreSQLChuỗi chữ tỷ lệ kèo bóng đá tối nay phải là một phần của chuỗi kết quả.

Khi lỗi, tỷ lệ kèo bóng đá tối nay con trỏ null được trả về và thông báo lỗi phù hợp được lưu trữ trongConnĐối tượng. Hiện tại, lỗi duy nhất có thể là tỷ lệ kèo bóng đá tối nay đủ bộ nhớ cho chuỗi kết quả.

pqescapytea

PQESCAPHYTEAlà phiên bản cũ hơn, tỷ lệ kèo bóng đá tối nay dùng nữa củapqescapyteaconn.

Char tỷ lệ kèo bóng đá tối nay dấu *pqescapytea (const tỷ lệ kèo bóng đá tối nay dấu char *từ,

Sự khác biệt duy nhất so vớipqescapyteaconnPQESCAPHERTEAtỷ lệ kèo bóng đá tối nay lấyPGConnTham số. Vì điều này,pqescapyteaChỉ có thể được sử dụng tỷ lệ kèo bóng đá tối nay cách an toàn trong các chương trình khách hàng sử dụng tỷ lệ kèo bóng đá tối nayPostgreSQLKết nối tại tỷ lệ kèo bóng đá tối nay thời điểm (trong trường hợp này nó có thể tìm ra những gì nó cần biếtPhía sau hậu trường). Nócó thể đưa ra kết quả saiNếu được sử dụng trong tỷ lệ kèo bóng đá tối nay chương trình sử dụng nhiều kết nối cơ sở dữ liệu (sử dụngpqescapyteaconnTrong những trường hợp như vậy).

PQUNESCAPHERTEA

Chuyển đổi biểu diễn chuỗi của dữ liệu nhị phân thành dữ liệu nhị phân - ngược lạiPQESCAPHYTEA. Điều này là cần thiết khi lấy lạibyteaDữ liệu ở định dạng văn bản, nhưng tỷ lệ kèo bóng đá tối nay phải khi truy xuất nó ở định dạng nhị phân.

87981_88062

Thetừtham số chỉ vào tỷ lệ kèo bóng đá tối nay chuỗi như có thể được trả về bởiPQGetValueKhi áp dụng cho AbyteaCột.PQUNESCAPHERTEAChuyển đổi biểu diễn chuỗi này thành biểu diễn nhị phân của nó. Nó trả về tỷ lệ kèo bóng đá tối nay con trỏ cho bộ đệm được phân bổ vớimalloc ()hoặcnulltrên lỗi và đặt kích thước của bộ đệm vàoto_length. Kết quả phải được giải phóng bằng cách sử dụngPQFreememKhi nó tỷ lệ kèo bóng đá tối nay còn cần thiết nữa.

Chuyển đổi này tỷ lệ kèo bóng đá tối nay chính xác là nghịch đảo củapqescapytea, vì chuỗi dự kiến ​​sẽ làEscapedKhănKhi nhận được từPQGetValue. Cụ thể, điều này có nghĩa là tỷ lệ kèo bóng đá tối nay cần xem xét trích dẫn chuỗi, và vì vậy tỷ lệ kèo bóng đá tối nay cần phảiPGConntham số.

Gửi hiệu chỉnh

Nếu bạn thấy bất cứ điều gì trong tài liệu tỷ lệ kèo bóng đá tối nay chính xác, tỷ lệ kèo bóng đá tối nay khớpMẫu nàyĐể báo cáo vấn đề tài liệu.