Phiên bản được hỗ trợ:hiện tại(17)16 / 15 / 14 / 13
Phiên bản phát triển:18 / Devel
Phiên bản không đượ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
Tài liệu này dành cho phiên bản không được hỗ trợ của PostgreSQL.
Bạn có thể muốn xem cùng kèo bóng đá hôm nay và ngày mai trang chohiện tạiPhiên bản hoặc một trong kèo bóng đá hôm nay và ngày mai phiên bản được hỗ trợ khác được liệt kê ở trên thay thế.

35.9. kèo bóng đá hôm nay và ngày mai ngữ c

Các chức năng do người dùng xác định có thể được viết bằng C (hoặc một kèo bóng đá hôm nay và ngày mai ngữ mà"ckèo bóng đá hôm nay và ngày mai từ"Nội bộ"kèo bóng đá hôm nay và ngày mai - Mã hóa thực tế

Hai quy ước gọi khác nhau hiện đang được sử dụng cho c"Phiên bản 1"quy ước gọi được biểu thị bằng cách viết Apg_function_info_v1 ()Cuộc gọi macro cho kèo bóng đá hôm nay và ngày mai,"Phiên bản 0") Hàm. kèo bóng đá hôm nay và ngày mai ngữTạo kèo bóng đá hôm nay và ngày maiCTrong cả hai trường hợp. kèo bóng đá hôm nay và ngày mai chức năng kiểu cũ

35.9.1. Tải động

Lần đầu tiên chức năng do người dùng định nghĩa trong kèo bóng đá hôm nay và ngày mai cụ thểTạo kèo bóng đá hôm nay và ngày maicho a

Thuật toán sau được sử dụng để định vị đối tượng chia sẻTạolệnh:

  1. Nếu tên là đường dẫn tuyệt đối, tệp đã cho là

  2. Nếu tên bắt đầu bằng chuỗi$ libdir, phần đó được thay thế bằngPostgreSQLThư viện gói

  3. Nếu tên không chứa phần thư mục, tệpDynamic_l Library_path.

  4. Nếu không (tệp không được tìm thấy trong đường dẫn hoặc nó

Nếu chuỗi này không hoạt động, phần dành riêng cho nền tảng được chia sẻ.so) được gắn vào tên đã cho và cái này

Nên định vị kèo bóng đá hôm nay và ngày mai thư viện được chia sẻ$ libdirhoặc thông qua động lực$ libdircó thể tìm thấypg_config.

ID người dùngPostgreSQLMáy chủ chạy vì phải có thể đi qua đường dẫn đến tệpPostgresNgười dùng là kèo bóng đá hôm nay và ngày mai sai lầm phổ biến.

Trong mọi trường hợp, tên tệp được đưa ra trongTạo kèo bóng đá hôm nay và ngày maiLệnh được ghi lại theo nghĩa đen trong

Lưu ý: PostgreSQLsẽ không tự động biên dịch kèo bóng đá hôm nay và ngày mai C. Đối tượngTạo kèo bóng đá hôm nay và ngày maiLệnh. Nhìn thấyPhần 35.9.6cho

Để đảm bảo rằng kèo bóng đá hôm nay và ngày mai tệp đối tượng được tải động là khôngPostgreSQLKiểm tra xem tệp có chứa"Khối ma thuật"với thích hợpPostgreSQL. kèo bóng đá hôm nay và ngày mai phép thuậtPostgreSQL8.2. Bao gồm kèo bóng đá hôm nay và ngày mai khối ma thuật,fmgr.h:

#ifdef pg_module_magic

The#ifdefCó thể bỏ qua kiểm tra nếuPostgreSQLphát hành.

Sau khi nó được sử dụng lần đầu tiên,

Tùy chọn, kèo bóng đá hôm nay và ngày mai tệp được tải động có thể chứa_pg_init, Đó là_pg_fini, kèo bóng đá hôm nay và ngày mai đó sẽ được gọi_pg_finisẽ chỉ được gọi

35.9.2. kèo bóng đá hôm nay và ngày mai loại cơ sở bằng tiếng c

Để biết cách viết các chức năng kèo bóng đá hôm nay và ngày mai ngữ C, bạn cần biếtPostgreSQLnội bộPostgreSQLcoi kèo bóng đá hôm nay và ngày mai loại cơ sở là"Blob of Memory". Người dùng định nghĩaPostgreSQLCó thể hoạt động trênPostgreSQLWill

kèo bóng đá hôm nay và ngày mai loại cơ sở có thể có một trong ba định dạng nội bộ:

  • Pass by giá trị, độ dài cố định

  • Pass by tham chiếu, độ dài cố định

  • Truyền qua tham chiếu, độ dài biến

kèo bóng đá hôm nay và ngày mai loại giá trị chỉ có thể có chiều dài 1, 2 hoặc 4 byte (cũngsizeof (mốc dữ liệu)là 8 trênLongLoại nguy hiểmintLoại là 4 byte trên hầu hết kèo bóng đá hôm nay và ngày mai UnixINT4gõ trên máy Unix có thể là:

/ * số nguyên 4 byte, được truyền bởi giá trị */

Mặt khác, kèo bóng đá hôm nay và ngày mai loại có độ dài cố định có thểPostgreSQLloại:

/ * Cấu trúc 16 byte, được truyền qua tham chiếu */

Chỉ có thể sử dụng kèo bóng đá hôm nay và ngày mai con trỏ như vậy khi chuyển chúng vàoPostgreSQLchức năng. Để trả về giá trị của kèo bóng đá hôm nay và ngày mai loại như vậy, hãy phân bổ quyềnpalloc, điền vàopallocVà chỉ cần trả lại con trỏ cho

Cuối cùng, tất cả kèo bóng đá hôm nay và ngày mai loại có độ dài thay đổi cũng phải được truyền qua

kèo bóng đá hôm nay và ngày mai điểm quan trọng khác là tránh để lại bất kỳ

Cảnh báo

không bao giờSửa đổi nội dung của giá trị đầu vào ngang qua.Phần.

Ví dụ, chúng ta có thể xác định loạiTextnhư sau:

Typedef Struct

Rõ ràng, trường dữ liệu được khai báo ở đây không đủ dàiC, Chúng tôi dựa vào kiến ​​thức rằngCTrình biên dịch sẽ không kiểm tra phạm vi

Khi thao tác kèo bóng đá hôm nay và ngày mai loại độ dài thay đổi, chúng ta phải cẩn thậnTextcấu trúc, chúng ta có thể sử dụng kèo bóng đá hôm nay và ngày mai

#include "Postgres.h"

Varhdrszgiống nhưsizeof (int4), nhưng nó được coi là phong cách tốt đểVarhdrszđể tham khảophảiBEset_varsizeMacro, không

Bảng 35-1Chỉ định loại c tương ứng với loại SQL khiPOSTGRESQL. The"Được xác định trong"Cột đưa ra tệp tiêu đề màPostgres.hĐầu tiên trong bất kỳ tệp nguồn nào, vì nó

Bảng 35-1. kèo bóng đá hôm nay và ngày mai loại C tương đương cho SQL tích hợp

SQL TYPE C Loại được xác định trong
Abstime Absolutetime Utils/nabstime.h
Boolean bool Postgres.h(có thể
Box Box* UTILS/GEO_DECLS.H
bytea bytea* Postgres.h
"Char" Char (trình biên dịch tích hợp)
ký tự bpchar* Postgres.h
CID CommandID Postgres.h
ngày dateadt Utils/date.h
smallint(INT2) INT2hoặcINT16 Postgres.h
int2Vector int2Vector* Postgres.h
Số nguyên(INT4) INT4hoặcINT32 Postgres.h
Real(float4) float4* Postgres.h
Double Precision(float8) float8* Postgres.h
Khoảng Khoảng* Utils/Timestamp.h
LSEG LSEG* UTILS/GEO_DECLS.H
tên tên Postgres.h
oid OID Postgres.h
oidvector oidvector* Postgres.h
đường dẫn đường dẫn* UTILS/GEO_DECLS.H
điểm điểm* UTILS/GEO_DECLS.H
RegProc RegProc Postgres.h
Relime Relativetime Utils/nabstime.h
Text Text* Postgres.h
TID itempulum lưu trữ/itemptr.h
Thời gian Timeadt Utils/date.h
Thời gian với múi giờ Timetzadt Utils/date.h
Dấu thời gian Dấu thời gian* Utils/Timestamp.h
Tinterval Timeinterval Utils/nabstime.h
Varchar Varchar* Postgres.h
XID Giao dịchID Postgres.h

Bây giờ chúng tôi đã vượt qua tất cả kèo bóng đá hôm nay và ngày mai cấu trúc có thể

35.9.3.

Chúng tôi trình bày"Kiểu cũ"Gọi quy ước trước - mặc dù cách tiếp cận này hiện là

Đây là kèo bóng đá hôm nay và ngày mai số ví dụ:

#include "Postgres.h"

Giả sử rằng mã trên đã được chuẩn bị trong tệpfuncs.cvà biên dịch thành kèo bóng đá hôm nay và ngày mai chia sẻPOSTGRESQLVới kèo bóng đá hôm nay và ngày mai lệnh như thế này:

Tạo hàm add_one (số nguyên) Trả về số nguyênThư mục/funcs ',' add_one 'Thư mục/funcs ',' add_one_float8 'Thư mục/funcs ',' makepoint 'Thư mục/funcs ',' copytext 'Thư mục/funcs ',' concat_text '

ở đây,Thư mụcPhía trênPostgreSQLThư mục hướng dẫn,'funcs'trongASmệnh đề, sau khi đã thêmThư mụcđến đường dẫn tìm kiếm. Trong bất kỳ.sohoặc.SL.)

Lưu ý rằng chúng tôi đã chỉ định kèo bóng đá hôm nay và ngày mai chức năng là"nghiêm ngặt", nghĩa là hệ thống nên

Mặc dù quy ước gọi này là đơn giản để sử dụng, nhưng nó không phảiintCách này. Ngoài ra, không có cách nào đơn giản để

35.9.4.

quy ước gọi phiên bản-1 dựa trên kèo bóng đá hôm nay và ngày mai macro để

Datum funcname (pg_function_args)

Ngoài ra, cuộc gọi macro:

pg_function_info_v1 (funcname);

phải xuất hiện trong cùng kèo bóng đá hôm nay và ngày mai tệp nguồn. (Thông thường, nóNội bộ-LanguagePostgreSQLGiả sử rằng tất cả kèo bóng đá hôm nay và ngày mai chức năng nội bộ đều sử dụng phiên bản-1

Trong hàm phiên bản-1, mỗi đối số thực tế được tìm nạppg_getarg_xxx()Macro tương ứng vớipg_return_xxx()Macro cho loại trả về.pg_getarg_xxx()lấy đối số của nópg_return_xxx()lấy đối số của nó

Ở đây chúng tôi hiển thị kèo bóng đá hôm nay và ngày mai chức năng giống như trên, được mã hóa trong phiên bản-1

#include "Postgres.h"

TheTạo kèo bóng đá hôm nay và ngày maikèo bóng đá hôm nay và ngày mai lệnh là

Thoạt nhìn, kèo bóng đá hôm nay và ngày mai quy ước mã hóa phiên bản-1 có thểadd_one_float8, chúng ta không còn cần phải biếtfloat8là loại tham chiếu qua.GetArgMacro cho kèo bóng đá hôm nay và ngày mai loại có độ dài thay đổi cho phép hiệu quả hơn"Nướng"(nén hoặc

Một cải tiến lớn về kèo bóng đá hôm nay và ngày mai chức năng phiên bản-1 tốt hơnpg_argisnull (n)Cho phép kèo bóng đá hôm nay và ngày mai chức năng kiểm tra"Strict".) Như vớipg_getarg_xxx()macro, kèo bóng đá hôm nay và ngày mai đối số đầu vàopg_getarg_xxx()Cho đến khi người ta xác minh rằngpg_return_null (); Điều này hoạt động trong

kèo bóng đá hôm nay và ngày mai tùy chọn khác được cung cấp trong giao diện kiểu mới là haipg_getarg_xxx()Macros. Cái đầu tiên trong số này,pg_getarg_xxx_copy (), đảm bảo trả lại apg_getarg_xxx_copy ()macro đảm bảo apg_getarg_xxx_slice ()macro lấy"Bên ngoài". (Loại lưu trữThay đổiTableNameCột thay thếcolnameĐặt lưu trữStoragetype. StorAgetypelà kèo bóng đá hôm nay và ngày mai trongtrơn, bên ngoài, mở rộnghoặcchính.)

Cuối cùng, kèo bóng đá hôm nay và ngày mai quy ước gọi chức năng phiên bản-1 làm cho nóPhần 35.9.9) vàChương) và Trình xử lý cuộc gọi bằng kèo bóng đá hôm nay và ngày mai ngữ thủ tục (Chương 49). Mã phiên bản-1 cũng nhiều hơnsrc/backend/utils/fmgr/readmein

35.9.5.

Trước khi chúng ta chuyển sang kèo bóng đá hôm nay và ngày mai chủ đề nâng cao hơn, chúng ta nênPOSTGRESQLC Hàm kèo bóng đá hôm nay và ngày mai ngữ C. Trong khi nóPostgreSQL, this

kèo bóng đá hôm nay và ngày mai quy tắc cơ bản để viết và xây dựng kèo bóng đá hôm nay và ngày mai chức năng C là

  • Sử dụngpg_configĐể tìm ra nơiPostgreSQLkèo bóng đá hôm nay và ngày mai tệp tiêu đề máy chủ là

  • biên dịch và liên kết mã của bạn để có thểPostgreSQLLuôn yêu cầu đặc biệtPhần 35.9.6Để giải thích chi tiết về cách thực hiện cho bạn

  • Hãy nhớ xác định A"Phép thuậtĐối với thư viện chia sẻ của bạn, như được mô tả trongPhần.

  • Khi phân bổ bộ nhớ, hãy sử dụngPostgreSQLkèo bóng đá hôm nay và ngày maiPalloCPFREEThay vì C tương ứngmallocmiễn phí. Bộ nhớ được phân bổ bởiPalloCsẽ được giải phóng

  • Luôn luôn không kèo bóng đá hôm nay và ngày mai byte của cấu trúc của bạn bằng cách sử dụngmemset(hoặc phân bổ chúng bằngPalloC0Ở nơi đầu tiên).

  • Hầu hết kèo bóng đá hôm nay và ngày mai bên trongPostgreSQLkèo bóng đá hôm nay và ngày mai loại được khai báo trongPostgres.h, trong khi kèo bóng đá hôm nay và ngày maipg_function_args, v.v.)fmgr.h, vì vậy bạn sẽ cần phải bao gồm tạiPostgres.h Đầu tiên, trước bất kỳPostgres.hcũng sẽ bao gồmelog.hpalloc.hcho bạn.

  • Tên biểu tượng được xác định trong kèo bóng đá hôm nay và ngày mai tệp đối tượng không đượcPOSTGRESQLMáy chủ

35.9.6. Biên soạn

Trước khi bạn có thể sử dụngPOSTGRESQLkèo bóng đá hôm nay và ngày mai chức năng mở rộng được viết trongThư viện chia sẻCần phải có

Để biết thông tin vượt ra ngoài những gì có trong phần này, bạnCCvà Trình chỉnh sửa liên kết,LD. Ngoài ra,PostgreSQLMã nguồn chứa kèo bóng đá hôm nay và ngày mai sốĐóng gópThư mục. Nếu bạn dựa vào những ví dụ này, bạn sẽ làmPOSTGRESQLTuy nhiên, mã nguồn.

Tạo thư viện chia sẻ thường tương tự như liên kếtMã độc lập vị trí(pic), điều đó có nghĩa là về mặt khái niệm là chúng

Trong kèo bóng đá hôm nay và ngày mai ví dụ sau, chúng tôi cho rằng mã nguồn của bạn làfoo.cvà chúng tôi sẽ tạo kèo bóng đá hôm nay và ngày maifoo.so. kèo bóng đá hôm nay và ngày maifoo.oTrừ khi có ghi chú khác. kèo bóng đá hôm nay và ngày mai thư viện được chia sẻ

BSD/OS

Cờ trình biên dịch để tạopic-FPIC.-shared.

GCC -FPIC -C FOO.C

Điều này được áp dụng như phiên bản 4.0 củaBSD/OS.

FreeBSD

Cờ trình biên dịch để tạopic-FPIC.-shared.

GCC -FPIC -C FOO.C

Điều này được áp dụng kể từ phiên bản 3.0 củaFreeBSD.

HP-UX

Cờ trình biên dịch của trình biên dịch hệ thống để tạopic+Z. Khi sử dụngGCCĐó là-FPIC. Cờ liên kết cho kèo bóng đá hôm nay và ngày mai thư viện được chia sẻ-B. Vì thế:

cc +z -c foo.c

hoặc:

gcc -fpic -c foo.c

và sau đó:

ld -b -o foo.sl foo.o

HP-UXSử dụng.SLđể chia sẻ

IRIX

piclà mặc định,-shared.

CC -C FOO.C
Linux

Cờ trình biên dịch để tạopic-FPIC.-FPICphải được sử dụng nếu-FPICkhông hoạt động. Tham khảo GCC-shared. MỘT

cc -fpic -c foo.c
Mac OS X

Đây là một ví dụ. Nó giả định kèo bóng đá hôm nay và ngày mai công cụ nhà phát triển là

CC -C FOO.C
NetBSD

Cờ trình biên dịch để tạopic-FPIC.elfHệ thống, The-sharedISld -bsharableIS

GCC -FPIC -C FOO.C
OpenBSD

Cờ trình biên dịch để tạopic-FPIC. ld -bsharableđược sử dụng để liên kết

GCC -FPIC -C FOO.C
Solaris

Cờ trình biên dịch để tạopic-KPICVới trình biên dịch mặt trời và-FPICvớiGCC. Để liên kết chia sẻ-gvới trình biên dịch hoặc thay thế-sharedvớiGCC.

CC -KPIC -C FOO.C

hoặc

GCC -FPIC -C FOO.C
TRU64 UNIX

piclà mặc định,LDvới kèo bóng đá hôm nay và ngày mai tùy chọn đặc biệt được sử dụng để thực hiện

CC -C FOO.C

Quy trình tương tự được sử dụng với GCC thay vì

Unixware

Cờ trình biên dịch để tạopic-K picVới trình biên dịch SCO và-FPICvớiGCC. Để liên kết chia sẻ-gVới trình biên dịch SCO và-sharedvớiGCC.

CC -K pic -c foo.c

hoặc

GCC -FPIC -C FOO.C

Tip:Nếu điều này quá phức tạp đối với bạn, bạngnu libtool,,

Tệp thư viện chia sẻ kết quả sau đó có thể được tải vàoPostgreSQL. Khi chỉ địnhTạo kèo bóng đá hôm nay và ngày maiLệnh, người ta phải đặt tên cho tệp thư viện được chia sẻ,.sohoặc.SL) có thểTạo kèo bóng đá hôm nay và ngày maiLệnh và thông thường nên được bỏ qua để tốt nhất

Tham khảo lạiPhầnGiới thiệu về nơi máy chủ mong đợi tìm được chia sẻ

35.9.7.

kèo bóng đá hôm nay và ngày mai loại tổng hợp không có bố cục cố định như CPOSTGRESQLcung cấp kèo bóng đá hôm nay và ngày mai chức năng

Giả sử chúng ta muốn viết kèo bóng đá hôm nay và ngày mai chức năng để trả lời truy vấn:

Chọn Tên, C_OverPaid (EMP, 1500) làm trả quá nhiều tiền

Sử dụng quy ước gọi phiên bản 0, chúng ta có thể xác địnhc_overpaidAs:

#include "Postgres.h"

Trong mã hóa phiên bản-1, ở trên sẽ trông như thế này:

#include "Postgres.h"

GetAttributionByNamePostgreSQLHàm hệ thốngHeaptupleHeaderđược chuyển vào hàm, tênGetAttributionByNameTrả về ADatumGiá trị mà bạn có thể chuyển đổi sang dữ liệu phù hợpDatumgetxxx()Macro. Lưu ý rằng giá trị trả về là vô nghĩa nếu null

còn cóGetAttributebyNum, chọn mục tiêu

Lệnh sau tuyên bố hàmc_overpaidTrong SQL:

Tạo kèo bóng đá hôm nay và ngày mai c_overpaid (EMP, Integer) Trả về BooleanThư mục/funcs ',' c_overpaid '

Thông báo chúng tôi đã sử dụngnghiêm ngặtsao cho

35.9.8.

Để trả lại giá trị loại hoặc loại tổng hợp từ kèo bóng đá hôm nay và ngày mai ngữ c

#include "funcapi.h"

Có hai cách bạn có thể xây dựng giá trị dữ liệu tổng hợp"Tuple"): Bạn có thểtupledescMô tả cho cấu trúc tuple. Khi làm việc với kèo bóng đá hôm nay và ngày mai mốc dữ liệu,tupledescđếnBlesstupledesc, sau đó gọiheap_form_tuplecho mỗi hàng.tupledescđếntupledescgetattinmetadata, rồi gọibuildTupleFromCStringscho mỗi

kèo bóng đá hôm nay và ngày mai số chức năng trợ giúp có sẵn để thiết lậptupledesc. Được đề xuất

62609_62789

Vượt qua cùng kèo bóng đá hôm nay và ngày maifcinfoCấu trúcresultTypeIDcó thể được chỉ định lànullhoặc là địa chỉ của biến cục bộ đểresulttupledescnên là địa chỉ của kèo bóng đá hôm nay và ngày mai địa phươngtupledescBiến. Kiểm tra xemTYPEFUNC_COMPISE; Nếu vậy,resulttupledescđã được lấp đầy bằngtupledesc. (Nếu nó là"Hồ sơ trả về kèo bóng đá hôm nay và ngày mai được gọi trong ngữ cảnh rằng.)

Tip: get_call_result_typeCó thể giải quyếtresultTypeIDĐầu ra chủ yếu hữu ích cho

Lưu ý: GET_CALL_RESULT_TYPECó anh chị emGET_EXPR_RESULT_TYPE, màget_func_result_type, có thể được sử dụngRecordget_func_result_typeKhông thể giải quyếtget_call_result_type.

kèo bóng đá hôm nay và ngày mai chức năng cũ hơn, hiện đang được ghi nhận để có đượctupledescS là:

TUPLEDESC quan hệ

Để có đượctupledesccho hàng

65473_65534

để nhậntupledescdựa trên atupledescĐối với loại cơ sở hoặc loại tổng hợp. NóRecordTuy nhiên, và nó không thể giải quyết

kèo bóng đá hôm nay và ngày mai khi bạn cótupledesc,

65975_66022

Nếu bạn có kế hoạch làm việc với kèo bóng đá hôm nay và ngày mai mốc dữ liệu, hoặc:

AttinMetadata *tupledescgetatto

Nếu bạn có kế hoạch làm việc với kèo bóng đá hôm nay và ngày mai chuỗi C. Nếu bạn đang viết mộtfunccallcontextCấu trúc - Sử dụngTuple_deschoặcAttinMetatrường tương ứng.

Khi làm việc với mốc dữ liệu, sử dụng:

66577_66654

Để xây dựng AHeaptupleNgười dùng đã cho

Khi làm việc với kèo bóng đá hôm nay và ngày mai chuỗi C, sử dụng:

66833_66910

Để xây dựng AHeaptupleNgười dùng đã choGiá trịlà kèo bóng đá hôm nay và ngày maiGiá trịMảng phải được đặt thànhnull. kèo bóng đá hôm nay và ngày mai này sẽ cần phải

kèo bóng đá hôm nay và ngày mai khi bạn đã xây dựng kèo bóng đá hôm nay và ngày mai tuple để trở về từ chức năng của mình, nóDatum. Sử dụng:

67652_67690

Để chuyển đổi Athành aDatumcó thể được trả lại

kèo bóng đá hôm nay và ngày mai ví dụ xuất hiện trong phần tiếp theo.

35.9.9. Trả về kèo bóng đá hôm nay và ngày mai bộ

Ngoài ra còn có API đặc biệt cung cấp hỗ trợ chofuncapi.h, như trên.

Hàm hoàn trả SET (SRF) được gọi kèo bóng đá hôm nay và ngày mai lần cho mỗi mục nóSRFPhảifunccallcontextđược cung cấp để giúp kiểm soátfcinfo- flinfo- fn_extrađược sử dụng để giữ kèo bóng đá hôm nay và ngày maifunccallcontextBên kia

Cấu trúc typedef

ANSRFSử dụng kèo bóng đá hôm nay và ngày mai sốfunccallcontextCấu trúc (vàfn_extra).

srf_is_firstcall ()

Để xác định xem kèo bóng đá hôm nay và ngày mai của bạn có được gọi cho lần đầu tiên

srf_firstcall_init ()

Để khởi tạofunccallcontext. Trên mọi cuộc gọi kèo bóng đá hôm nay và ngày mai,

srf_percall_setup ()

Để thiết lập đúng cách sử dụngfunccallcontextvà xóa bất kỳ trước đó

Nếu kèo bóng đá hôm nay và ngày mai của bạn có dữ liệu để trả về, hãy sử dụng:

srf_return_next (funcctx, result)

Để trả lại cho người gọi. (resultPhải loạiDatum, hoặc là kèo bóng đá hôm nay và ngày mai

srf_return_done (funcctx)

Để dọn dẹp và kết thúcSRF.

Bối cảnh bộ nhớ hiện tại khiSRFđược gọi là bối cảnh thoáng qua màPFREETrên mọi thứ bạnPalloC; nó sẽMulti_call_memory_ctxlà kèo bóng đá hôm nay và ngày mai vị trí phù hợpSRFđược hoàn thành chạy. Trong hầu hết kèo bóng đá hôm nay và ngày mai trường hợp,Multi_call_memory_ctxTrong khi làm

kèo bóng đá hôm nay và ngày mai ví dụ giả giả hoàn chỉnh trông giống như sau:

Datumkhai báo thêm khi cầnif (srf_is_firstcall ())Mã người dùng
        Nếu trả về composite
            Build tupledesc và có lẽ là attinmetadata
        endif trả về composite
        Mã người dùngMemoryContextSwitchto (OldContext);Mã người dùngfuncctx = srf_percall_setup ();Mã người dùng/ * Đây chỉ là kèo bóng đá hôm nay và ngày mai cách chúng ta có thể kiểm tra xem chúng ta đã hoàn thành: */Mã người dùng
        có được dữ liệu kết quảsrf_return_next (funcctx, result);Mã người dùngsrf_return_done (funcctx);

kèo bóng đá hôm nay và ngày mai ví dụ hoàn chỉnh về đơn giảnSRFTrả về kèo bóng đá hôm nay và ngày mai loại tổng hợp trông

pg_function_info_v1 (retcposite);

kèo bóng đá hôm nay và ngày mai cách để khai báo chức năng này trong SQL là:

Tạo loại __retComposite AS (số nguyên F1, số nguyên F2, số nguyên F3);FileName',' retcposite '

Một cách khác là sử dụng kèo bóng đá hôm nay và ngày mai tham số:

Tạo hoặc thay thế kèo bóng đá hôm nay và ngày mai retcposite (in Integer, in Integer,FileName',' retcposite '

Lưu ý rằng trong phương pháp này, loại đầu ra của hàmRecordLoại.

Thư mục79045_79064Mô -đun trong phân phối nguồn chứa nhiều ví dụ hơn về

35.9.10.

Các hàm kèo bóng đá hôm nay và ngày mai ngữ C có thể được tuyên bố để chấp nhận và trả lạiAnyEuity, AnyArray, AnynonarrayAnyenum. Nhìn thấyPhầnĐể giải thích chi tiết hơn về đa hìnhfmgr.hĐể cho phép kèo bóng đá hôm nay và ngày mai phiên bản-1 Cget_fn_expr_rettype (fmgrinfo *flinfo)get_fn_expr_argtype (fmgrinfo *flinfo, int. Họ trả về kết quả hoặc loại đối số oid hoặckhông hợp lệNếu thông tin khôngflinfoISfcinfo- flinfo. Tham sốargnumlà không dựa trên.get_call_result_typecũng có thể được sử dụng như kèo bóng đá hôm nay và ngày maiget_fn_expr_rettype.

Ví dụ, giả sử chúng ta muốn viết kèo bóng đá hôm nay và ngày mai chức năng để chấp nhận a

pg_function_info_v1 (make_array);

Lệnh sau tuyên bố hàmmake_arrayTrong SQL:

Tạo kèo bóng đá hôm nay và ngày mai Make_array (AnyEuity) trả về AnyArrayThư mục/funcs ',' make_array '

Có kèo bóng đá hôm nay và ngày mai biến thể đa hình chỉ có sẵn để"Any". (Lưu ý rằng loại nàyAnyEuityngoại trừ"Any"đối số là cùng loại, cũng khôngVariadic "Any". Điều này sẽ phù hợp với kèo bóng đá hôm nay và ngày mai hoặc nhiềukhôngđược thu thập thành kèo bóng đá hôm nay và ngày mai mảng làPG_NARGS ()Macro và kèo bóng đá hôm nay và ngày mai phương pháp được mô tả

35.9.11.

add-ins có thể bảo lưu lwlocks và phân bổ chia sẻ83894_83920.

void requestAddInshmemSpace (int size)

Từ bạn_pg_initkèo bóng đá hôm nay và ngày mai.

LWlocks được bảo lưu bằng cách gọi:

void requestAddInlWlocks (int n)

từ_pg_init.

Để tránh điều kiện chủng tộc có thể, mỗi phụ trợ nên sử dụngAddInshmeminitLockKhi kết nối và khởi tạo phân bổ chia sẻ của nó

MyStruct static *ptr = null;

35.9.12.

mặc dùPOSTGRESQLphụ trợ được viết bằng C, có thể ghi kèo bóng đá hôm nay và ngày mai phần mở rộng vào

  • Tất cả kèo bóng đá hôm nay và ngày mai chức năng được truy cập bởi phần phụ trợ phải trình bày một cExternLiên kết là cần thiết cho kèo bóng đá hôm nay và ngày mai chức năng được truy cập phụ trợ.

  • Bộ nhớ miễn phí bằng phương pháp phân giải thích hợp.palloc (), vì vậy hãy sử dụngpfree ()Để giải phóng nó. Sử dụng C ++XóaTrong những trường hợp như vậy sẽ

  • Ngăn chặn kèo bóng đá hôm nay và ngày mai ngoại lệ truyền vào mã C (Sử dụngExtern Ckèo bóng đá hôm nay và ngày mai). Điều này là cần thiết thậm chí-FNO-EXCEPTIONđếnnew ().

  • Nếu gọi kèo bóng đá hôm nay và ngày mai chức năng phụ trợ từ mã C ++, hãy chắc chắn rằngPod). Điều này là cần thiếtlongjmp ()Điều đó không đúng

Tóm lại, tốt nhất là đặt mã C ++ phía sau kèo bóng đá hôm nay và ngày mai bức tường củaExtern Ckèo bóng đá hôm nay và ngày mai chức năng giao diện với