Trả về một mảng palloc'd gồm các khóa được cung cấp một soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran. Số lượng khóa trả về phải được lưu trữ thành*NKEYS. Nếu bất kỳ phím nào có thể là null, cũng palloc soi kèo bóng đá truoctran mảng*NKEYS boolTrường, lưu trữ địa chỉ của nó tại*nullflags, và đặt soi kèo bóng đá truoctran cờ null này khi cần.*nullflagscó thể để lạinull(giá trị ban đầu của nó) nếu tất cả soi kèo bóng đá truoctran khóa không có null. Giá trị trả về có thể lànullNếu soi kèo bóng đá truoctran không chứa khóa.

Trả về soi kèo bóng đá truoctran mảng palloc'd gồm các khóa được cung cấp soi kèo bóng đá truoctran giá trị được truy vấn; đó là,Truy vấnlà giá trị ở phía bên phải của toán tử có thể lập chỉ soi kèo bóng đá truoctran có phía bên trái là cột được lập chỉ soi kèo bóng đá truoctran.nlà số chiến lược của toán tử trong lớp toán tử (xemPhần 38.16.2). Thường,Trích xuấtSẽ cần tham khảo ý kiếnnĐể xác định loại dữ liệu củaTruy vấnvà phương pháp nên sử dụng để trích xuất soi kèo bóng đá truoctran giá trị khóa. Số lượng khóa trả về phải được lưu trữ thành*NKEYS. Nếu bất kỳ phím nào có thể là null, cũng palloc soi kèo bóng đá truoctran mảng*NKEYS boolTrường, lưu trữ địa chỉ của nó tại*nullflags, và đặt soi kèo bóng đá truoctran cờ null này khi cần.*nullflagscó thể để lạinull(giá trị ban đầu của nó) nếu tất cả soi kèo bóng đá truoctran khóa không phải là null. Giá trị trả về có thể lànullNếuTruy vấnkhông chứa khóa.

SearchModelà đối số đầu ra cho phépTrích xuấtĐể chỉ định chi tiết về cách tìm kiếm sẽ được thực hiện. Nếu như*SearchModeđược đặt thànhGin_Search_Mode_Default(là giá trị mà nó được khởi tạo trước khi gọi), chỉ các soi kèo bóng đá truoctran phù hợp với ít nhất một trong các khóa trả về được coi là phù hợp ứng cử viên. Nếu như*SearchModeđược đặt thànhgin_search_mode_include_empty, sau đó ngoài các soi kèo bóng đá truoctran chứa ít nhất một phím phù hợp, các soi kèo bóng đá truoctran không chứa khóa nào được coi là phù hợp ứng cử viên. (Ví dụ: Chế độ này rất hữu ích để triển khai các toán tử là bộ phận của các toán tử.) Nếu*SearchModeđược đặt thànhGIN_SEARCH_MODE_ALL, thì tất cả các soi kèo bóng đá truoctran không null trong chỉ soi kèo bóng đá truoctran được coi là phù hợp với ứng cử viên, cho dù chúng có khớp với bất kỳ khóa nào được trả về hay không. .access/gin.h.

pmatchlà soi kèo bóng đá truoctran đối số đầu ra để sử dụng khi hỗ trợ kết hợp soi kèo bóng đá truoctran phần. Để sử dụng nó,Trích xuấtPhải phân bổ soi kèo bóng đá truoctran mảng*NKEYS boolS và lưu trữ địa chỉ của nó tại*pmatch. Mỗi phần tử của mảng phải được đặt thành true nếu khóa tương ứng yêu cầu khớp soi kèo bóng đá truoctran phần, sai nếu không.*pmatchđược đặt thànhnullSau đó, Gin giả định rằng không cần phải kết hợp soi kèo bóng đá truoctran phần. Biến được khởi tạo thànhnullTrước khi gọi, vì vậy đối số này có thể bị bỏ qua bởi các lớp toán tử không hỗ trợ khớp soi kèo bóng đá truoctran phần.

Extra_Datalà đối số đầu ra cho phépTrích xuấtĐể truyền dữ liệu bổ sung chonhất quánvàSo sánhpartialPhương pháp. Để sử dụng nó,Trích xuấtphải phân bổ soi kèo bóng đá truoctran mảng*NKEYSCon trỏ và lưu trữ địa chỉ của nó tại*Extra_data, sau đó lưu trữ bất cứ điều gì nó muốn vào soi kèo bóng đá truoctran con trỏ riêng lẻ. Biến được khởi tạo thànhnullTrước khi gọi, vì vậy đối số này có thể bị bỏ qua bởi soi kèo bóng đá truoctran lớp toán tử không yêu cầu thêm dữ liệu. Nếu như*Extra_datađược đặt, toàn bộ mảng được chuyển chonhất quánPhương thức và phần tử thích hợp choSo sánhpartialPhương pháp.

Trả về đúng nếu một soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran thỏa mãn toán tử truy vấn với số chiến lượcn(hoặc có thể thỏa mãn nó, nếu chỉ báo kiểm tra lại). Chức soi kèo bóng đá truoctran này không có quyền truy cập trực tiếp vào giá trị của mục được lập chỉ mục, vìGinKhông lưu trữ các soi kèo bóng đá truoctran một cách rõ ràng. Thay vào đó, những gì có sẵn là kiến ​​thức về giá trị khóa nào được trích xuất từ ​​truy vấn xuất hiện trong một soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran nhất định.Kiểm tramảng có độ dàiNKEYS, giống như số lượng khóa trước được trả về trướcTrích xuấtcho điều nàyTruy vấnDatum. Mỗi yếu tố củaKiểm traMảng là đúng nếu soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran chứa khóa truy vấn tương ứng, tức là, nếu (kiểm tra [i] == true) phím thứ i củaTrích xuấtmảng kết quả có mặt trong soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran. Bản gốcTruy vấnDatum được truyền trong trường hợpnhất quánPhương pháp cần tham khảo nó, và cũng vậyTruy vấn []vànullflags []mảng được trả về trước đóTrích xuất.Extra_Datalà mảng dữ liệu thêm được trả về bởiTrích xuấthoặcnullNếu không.

KhiTrích xuấtTrả về phím null trongTruy vấn [], tương ứngKiểm tra []Phần tử là đúng nếu soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran chứa khóa null; đó là ngữ nghĩa củaKiểm tra []giống nhưkhông khác biệt với. Thenhất quánHàm có thể kiểm tra tương ứngnullflags []Phần tử nếu cần phải nói sự khác biệt giữa khớp giá trị thông thường và khớp null.

Khi thành công,*Rechecknên được đặt thành true nếu tple heap cần được kiểm tra lại đối với toán tử truy vấn hoặc sai nếu kiểm tra chỉ soi kèo bóng đá truoctran là chính xác. Đó là, một giá trị trả về sai đảm bảo rằng Tuple Heap không khớp với truy vấn;*RecheckĐặt thành sự bảo đảm sai rằng Tuple Heap không khớp với truy vấn; và giá trị trả về thực sự với*RebheckĐặt thành True có nghĩa là Tuple Heap có thể khớp với truy vấn, do đó, nó cần được tìm nạp và kiểm tra lại bằng cách đánh giá toán tử truy vấn trực tiếp với soi kèo bóng đá truoctran được lập chỉ soi kèo bóng đá truoctran ban đầu.

Triconsistentgiống vớinhất quán, nhưng thay vì booleans trongKiểm traVector, có ba giá trị có thể cho mỗi khóa:gin_true,Gin_FalsevàGin_Maybe.Gin_FalsevàGin_TrueCó ý nghĩa tương tự như soi kèo bóng đá truoctran giá trị boolean thông thường, trong khiGin_Maybecó nghĩa là sự hiện diện của khóa đó không được biết đến. Khigin_maybeGiá trị có mặt, hàm chỉ nên trả vềgin_trueNếu soi kèo bóng đá truoctran chắc chắn khớp với việc soi kèo bóng đá truoctran chỉ soi kèo bóng đá truoctran có chứa các khóa truy vấn tương ứng hay không. Tương tự như vậy, hàm phải trả vềGin_FalseChỉ khi mặt hàng chắc chắn không khớp, dù nó có chứa hay khôngGin_MaybeKhóa. Nếu kết quả phụ thuộc vàogin_maybeMục nhập, tức là, trận đấu không thể được xác nhận hoặc bác bỏ dựa trên các khóa truy vấn đã biết, chức soi kèo bóng đá truoctran phải trả vềgin_maybe.

Khi không cóGin_Maybegiá trị trongKiểm traVector, Agin_maybeGiá trị trả về tương đương với việc cài đặtRecheckcờ trong booleannhất quánchức soi kèo bóng đá truoctran.

20492_20729

So sánh khóa truy vấn khớp một phần với khóa chỉ soi kèo bóng đá truoctran. Trả về một số nguyên có dấu cho biết kết quả: nhỏ hơn 0 có nghĩa là khóa chỉ soi kèo bóng đá truoctran không khớp với truy vấn, nhưng việc quét chỉ soi kèo bóng đá truoctran sẽ tiếp tục;ncủa toán tử tạo truy vấn khớp soi kèo bóng đá truoctran phần được cung cấp, trong trường hợp ngữ nghĩa của nó là cần thiết để xác định khi nào nên kết thúc quá trình quét. Cũng,Extra_Datalà phần tử tương ứng của mảng dữ liệu phụ được thực hiện bởiTrích xuấthoặcNULLNếu không có. Các phím null không bao giờ được truyền cho chức soi kèo bóng đá truoctran này.

Xác định soi kèo bóng đá truoctran tập hợp các tham số có thể nhìn thấy người dùng có thể điều khiển hành vi của lớp toán tử.

TheTùy chọnHàm được chuyển soi kèo bóng đá truoctran con trỏ đến Alocal_reloptsstruct, cần được lấp đầy bằng một tập hợp các tùy chọn cụ thể của lớp vận hành. Các tùy chọn có thể được truy cập từ các chức soi kèo bóng đá truoctran hỗ trợ khác bằng cách sử dụngPG_HAS_OPCLASS_OPTES ()vàPG_GET_OPCLASS_OPTES ()Macros.

Vì cả hai trích xuất chính của các giá trị được lập chỉ soi kèo bóng đá truoctran và biểu diễn của khóa trongGinlà linh hoạt, chúng có thể phụ thuộc vào soi kèo bóng đá truoctran tham số do người dùng chỉ định.