ffi-clang 0.8.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 49fb826573fff8e593fdd5671533332527ac2284b50740700134ddd7425d22dd
-  data.tar.gz: 00ad98e0fe43999cb523be92b759cb5c4973d9ba24726420e97d98470c734eb1
+  metadata.gz: eed14776878ea1dd5fe61ec2b8c9bb57be78116944d5943722077dd958e65b90
+  data.tar.gz: 15acda164aae15f941ae12031e1f68a8a220f0b5e48c6ed07737e0d8a733893d
 SHA512:
-  metadata.gz: 3ebff7af9edbd58036a10ca360c801ddf1b9a8e251f6a869f48371a971e3497186d5abc52aa2bf9d883e7207f769973b0e998fae98d7d5ef2c0f6df989de6a17
-  data.tar.gz: bbb56cd257720aa7fa87e12f068f9899b8f254b9cdc5d5036419744c4362f14eb21d48049418a4fa7f11ea6769806b6b758baab09c0c63a7b5ce4f2bf269b455
+  metadata.gz: bb918188b02394a8d21f863f1b989a2cb96789f11c97d83c417258ac25a590e63297daf7e7fb6851f06e4890051f9130b9c75d850f1662ad29f6652a244bceb4
+  data.tar.gz: 6b48dabf35dc7606859f18f4267800f4e6de1a2eec1496e3e89cbad282727cb8f80c4820b1405e772bad59bfd8559a98076804e2320b453d65e0d22104ba9bd0

data/lib/ffi/clang/clang_version.rb

@@ -1,7 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2016-2022, by Samuel Williams.
+# Copyright, 2016-2024, by Samuel Williams.
+# Copyright, 2023, by Charlie Savage.
 
 require_relative 'lib/clang_version'
 

data/lib/ffi/clang/code_completion.rb

@@ -2,7 +2,8 @@
 
 # Released under the MIT License.
 # Copyright, 2014, by Masahiro Sano.
-# Copyright, 2014-2022, by Samuel Williams.
+# Copyright, 2014-2024, by Samuel Williams.
+# Copyright, 2023-2024, by Charlie Savage.
 
 require_relative 'lib/code_completion'
 
@@ -10,7 +11,7 @@ module FFI
 	module Clang
 		class CodeCompletion
 			def self.default_code_completion_options
-				Lib.opts_from Lib::CodeCompleteFlags, Lib.default_code_completion_options
+				Lib.opts_from(Lib::CodeCompleteFlags, Lib.default_code_completion_options)
 			end
 
 			class Results < FFI::AutoPointer
@@ -27,7 +28,8 @@ module FFI
 				end
 
 				def self.release(pointer)
-					Lib.dispose_code_complete_results(pointer)
+          results = Lib::CXCodeCompleteResults.new(pointer)
+					Lib.dispose_code_complete_results(results)
 				end
 
 				def each(&block)

data/lib/ffi/clang/cursor.rb

@@ -2,7 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2013, by Garry Marshall.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Carlos Martín Nieto.
 # Copyright, 2013, by Dave Wilkinson.
 # Copyright, 2013, by Takeshi Watanabe.
@@ -11,18 +11,21 @@
 # Copyright, 2014, by Niklas Therning.
 # Copyright, 2019, by Michael Metivier.
 # Copyright, 2022, by Motonori Iwamuro.
+# Copyright, 2023-2024, by Charlie Savage.
 
 require_relative 'lib/cursor'
 require_relative 'lib/code_completion'
 
+require_relative 'printing_policy'
 require_relative 'source_location'
 require_relative 'source_range'
 require_relative 'comment'
-require_relative 'type'
 
 module FFI
 	module Clang
 		class Cursor
+			include Enumerable
+
 			attr_reader :cursor
 			attr_reader :translation_unit
 
@@ -60,6 +63,14 @@ module FFI
 				CodeCompletion::String.new Lib.get_cursor_completion_string(@cursor)
 			end
 
+			def anonymous?
+				Lib.cursor_is_anonymous(@cursor) != 0
+			end
+
+			def anonymous_record_declaration?
+				Lib.cursor_is_anonymous_record_decl(@cursor) != 0
+			end
+
 			def declaration?
 				Lib.is_declaration(kind) != 0
 			end
@@ -108,9 +119,22 @@ module FFI
 				Lib.is_unexposed(kind) != 0
 			end
 
-			def location
+			def expansion_location
 				ExpansionLocation.new(Lib.get_cursor_location(@cursor))
 			end
+			alias :location :expansion_location
+
+			def presumed_location
+				PresumedLocation.new(Lib.get_cursor_location(@cursor))
+			end
+
+			def spelling_location
+				SpellingLocation.new(Lib.get_cursor_location(@cursor))
+			end
+
+			def file_location
+				FileLocation.new(Lib.get_cursor_location(@cursor))
+			end
 
 			def extent
 				SourceRange.new(Lib.get_cursor_extent(@cursor))
@@ -120,16 +144,27 @@ module FFI
 				Lib.extract_string Lib.get_cursor_display_name(@cursor)
 			end
 
+			def qualified_name
+				if self.kind != :cursor_translation_unit
+					result = self.semantic_parent.qualified_name
+					result ? "#{result}::#{self.spelling}" : self.spelling
+				end
+			end
+
 			def spelling
 				Lib.extract_string Lib.get_cursor_spelling(@cursor)
 			end
 
+			def printing_policy
+				PrintingPolicy.new(cursor)
+			end
+
 			def usr
 				Lib.extract_string Lib.get_cursor_usr(@cursor)
 			end
 
 			def kind
-				@cursor[:kind]
+				@cursor ? @cursor[:kind] : nil
 			end
 
 			def kind_spelling
@@ -137,23 +172,15 @@ module FFI
 			end
 
 			def type
-				Type.new Lib.get_cursor_type(@cursor), @translation_unit
+				Types::Type.create Lib.get_cursor_type(@cursor), @translation_unit
 			end
 
 			def result_type
-				Type.new Lib.get_cursor_result_type(@cursor), @translation_unit
+				Types::Type.create Lib.get_cursor_result_type(@cursor), @translation_unit
 			end
 
 			def underlying_type
-				Type.new Lib.get_typedef_decl_underlying_type(@cursor), @translation_unit
-			end
-
-			def enum_decl_integer_type
-				Type.new Lib.get_enum_decl_integer_type(@cursor), @translation_unit
-			end
-
-			def typedef_type
-				Type.new Lib.get_typedef_decl_unerlying_type(@cursor), @translation_unit
+				Types::Type.create Lib.get_typedef_decl_underlying_type(@cursor), @translation_unit
 			end
 
 			def virtual_base?
@@ -193,7 +220,7 @@ module FFI
 			end
 
 			def enum_type
-				Type.new Lib.get_enum_type(@cursor), @translation_unit
+				Types::Type.create Lib.get_enum_decl_integer_type(@cursor), @translation_unit
 			end
 
 			def specialized_template
@@ -208,6 +235,21 @@ module FFI
 				Cursor.new Lib.get_cursor_definition(@cursor), @translation_unit
 			end
 
+			def opaque_declaration?
+				# Is this a declaration that does not have a definition in the translation unit
+				self.declaration? && !self.definition? && self.definition.invalid?
+			end
+
+			def forward_declaration?
+				# Is this a forward declaration for a definition contained in the same translation_unit?
+				# https://joshpeterson.github.io/identifying-a-forward-declaration-with-libclang
+				#
+				# Possible alternate implementations?
+				# self.declaration? && !self.definition? && self.definition
+				# !self.definition? && self.definition
+				self.declaration? && !self.eql?(self.definition) && !self.definition.invalid?
+			end
+
 			def referenced
 				Cursor.new Lib.get_cursor_referenced(@cursor), @translation_unit
 			end
@@ -236,14 +278,53 @@ module FFI
 				Lib.get_num_args @cursor
 			end
 
-			def visit_children(&block)
+			def each(recurse = true, &block)
+				return to_enum(:each, recurse) unless block_given?
+
 				adapter = Proc.new do |cxcursor, parent_cursor, unused|
-					block.call Cursor.new(cxcursor, @translation_unit), Cursor.new(parent_cursor, @translation_unit)
+					# Call the block and capture the result. This lets advanced users
+					# modify the recursion on a case by case basis if needed
+					result = block.call Cursor.new(cxcursor, @translation_unit), Cursor.new(parent_cursor, @translation_unit)
+					case result
+						when :continue
+							:continue
+						when :recurse
+							:recurse
+						else
+							recurse ? :recurse : :continue
+					end
 				end
-				
+
 				Lib.visit_children(@cursor, adapter, nil)
 			end
 
+      def ancestors_by_kind(*kinds)
+        result = Array.new
+
+        parent = self
+        while parent != self.semantic_parent
+          parent = self.semantic_parent
+          if kinds.include?(parent.kind)
+            result << parent
+          end
+        end
+        result
+      end
+
+			def find_by_kind(recurse, *kinds)
+        unless (recurse == nil || recurse == true || recurse == false)
+          raise("Recurse parameter must be nil or a boolean value. Value was: #{recurse}")
+        end
+
+				result = Array.new
+				self.each(recurse) do |child, parent|
+					if kinds.include?(child.kind)
+						result << child
+					end
+				end
+				result
+			end
+
 			def find_references_in_file(file = nil, &block)
 				file ||= Lib.extract_string Lib.get_translation_unit_spelling(@translation_unit)
 
@@ -351,40 +432,8 @@ module FFI
 				Lib.get_cursor_hash(@cursor)
 			end
 
-			def find_all(*kinds)
-				filter do |child, parent|
-					kinds.include?(child.kind)
-				end
-			end
-
-			def find_first(*kinds)
-				find_all(*kinds).first
-			end
-
-			def filter
-				return to_enum(:select) unless block_given?
-				
-				matching = []
-
-				self.visit_children do |child, parent|
-					if yield(child, parent)
-						matching << child
-					end
-
-					:recurse
-				end
-
-				return matching
-			end
-
-			def select
-				filter do |child, parent|
-					yield(child)
-				end
-			end
-
-			def to_a
-				filter.collect{|child, parent| child}
+			def to_s
+				"Cursor <#{self.kind.to_s.gsub(/^cursor_/, '')}: #{self.spelling}>"
 			end
 
 			def references(file = nil)

data/lib/ffi/clang/diagnostic.rb

@@ -3,9 +3,10 @@
 # Released under the MIT License.
 # Copyright, 2010, by Jari Bakken.
 # Copyright, 2012, by Hal Brodigan.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Garry Marshall.
 # Copyright, 2014, by Masahiro Sano.
+# Copyright, 2023, by Charlie Savage.
 
 require_relative 'lib/diagnostic'
 require_relative 'source_range'
@@ -14,7 +15,7 @@ module FFI
 	module Clang
 		class Diagnostic < AutoPointer
 			def self.default_display_opts
-				Lib.opts_from Lib::DiagnosticDisplayOptions, Lib.default_diagnostic_display_options
+				Lib.opts_from(Lib::DiagnosticDisplayOptions, Lib.default_diagnostic_display_options)
 			end
 
 			def initialize(translation_unit, pointer)
@@ -96,7 +97,7 @@ module FFI
 				if opts.empty?
 					Lib.default_diagnostic_display_options
 				else
-					Lib.bitmask_from Lib::DiagnosticDisplayOptions, opts
+					Lib.bitmask_from(Lib::DiagnosticDisplayOptions, opts)
 				end
 			end
 		end

data/lib/ffi/clang/index.rb

@@ -3,11 +3,12 @@
 # Released under the MIT License.
 # Copyright, 2010, by Jari Bakken.
 # Copyright, 2012, by Hal Brodigan.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Carlos Martín Nieto.
 # Copyright, 2013, by Dave Wilkinson.
 # Copyright, 2013, by Takeshi Watanabe.
 # Copyright, 2014, by Masahiro Sano.
+# Copyright, 2023, by Charlie Savage.
 
 require_relative 'lib/index'
 
@@ -26,10 +27,16 @@ module FFI
 				command_line_args = Array(command_line_args)
 				unsaved_files = UnsavedFile.unsaved_pointer_from(unsaved)
 
-				translation_unit_pointer = Lib.parse_translation_unit(self, source_file, args_pointer_from(command_line_args), command_line_args.size, unsaved_files, unsaved.length, options_bitmask_from(opts))
+				translation_unit_pointer_out = FFI::MemoryPointer.new(:pointer)
 
-				raise Error, "error parsing #{source_file.inspect}" if translation_unit_pointer.null?
+				error_code = Lib.parse_translation_unit2(self, source_file, args_pointer_from(command_line_args), command_line_args.size, unsaved_files, unsaved.length, options_bitmask_from(opts), translation_unit_pointer_out)
+				if error_code != :cx_error_success
+					error_name = Lib::ErrorCodes.from_native(error_code, nil)
+					message = "Error parsing file. Code: #{error_name}. File: #{source_file.inspect}"
+					raise(Error, message)
+				end
 
+				translation_unit_pointer = translation_unit_pointer_out.read_pointer
 				TranslationUnit.new translation_unit_pointer, self
 			end
 
@@ -53,7 +60,7 @@ module FFI
 			end
 
 			def options_bitmask_from(opts)
-				Lib.bitmask_from Lib::TranslationUnitFlags, opts
+				Lib.bitmask_from(Lib::TranslationUnitFlags, opts)
 			end
 		end
 	end

data/lib/ffi/clang/lib/code_completion.rb

@@ -3,6 +3,7 @@
 # Released under the MIT License.
 # Copyright, 2014, by Masahiro Sano.
 # Copyright, 2014-2022, by Samuel Williams.
+# Copyright, 2024, by Charlie Savage.
 
 require_relative 'cursor'
 require_relative 'diagnostic'
@@ -96,16 +97,16 @@ module FFI
 			attach_function :get_completion_brief_comment, :clang_getCompletionBriefComment, [:CXCompletionString], CXString.by_value
 
 			# CXCodeCompleteResults functions
-			attach_function :get_code_complete_get_num_diagnostics, :clang_codeCompleteGetNumDiagnostics, [CXCodeCompleteResults.ptr], :uint
-			attach_function :get_code_complete_get_diagnostic, :clang_codeCompleteGetDiagnostic, [CXCodeCompleteResults.ptr, :uint], :CXDiagnostic
-			attach_function :get_code_complete_get_contexts, :clang_codeCompleteGetContexts, [CXCodeCompleteResults.ptr], :ulong_long
-			attach_function :get_code_complete_get_container_kind, :clang_codeCompleteGetContainerKind, [CXCodeCompleteResults.ptr, :pointer], :cursor_kind
-			attach_function :get_code_complete_get_container_usr, :clang_codeCompleteGetContainerUSR, [CXCodeCompleteResults.ptr], CXString.by_value
-			attach_function :get_code_complete_get_objc_selector, :clang_codeCompleteGetObjCSelector, [CXCodeCompleteResults.ptr], CXString.by_value
+			attach_function :get_code_complete_get_num_diagnostics, :clang_codeCompleteGetNumDiagnostics, [CXCodeCompleteResults.by_ref], :uint
+			attach_function :get_code_complete_get_diagnostic, :clang_codeCompleteGetDiagnostic, [CXCodeCompleteResults.by_ref, :uint], :CXDiagnostic
+			attach_function :get_code_complete_get_contexts, :clang_codeCompleteGetContexts, [CXCodeCompleteResults.by_ref], :ulong_long
+			attach_function :get_code_complete_get_container_kind, :clang_codeCompleteGetContainerKind, [CXCodeCompleteResults.by_ref, :pointer], :cursor_kind
+			attach_function :get_code_complete_get_container_usr, :clang_codeCompleteGetContainerUSR, [CXCodeCompleteResults.by_ref], CXString.by_value
+			attach_function :get_code_complete_get_objc_selector, :clang_codeCompleteGetObjCSelector, [CXCodeCompleteResults.by_ref], CXString.by_value
 
 			# Other functions
-			attach_function :code_complete_at, :clang_codeCompleteAt, [:CXTranslationUnit, :string, :uint, :uint, :pointer, :uint, :uint], CXCodeCompleteResults.ptr
-			attach_function :dispose_code_complete_results, :clang_disposeCodeCompleteResults, [CXCodeCompleteResults.ptr], :void
+			attach_function :code_complete_at, :clang_codeCompleteAt, [:CXTranslationUnit, :string, :uint, :uint, :pointer, :uint, :uint], CXCodeCompleteResults.by_ref
+			attach_function :dispose_code_complete_results, :clang_disposeCodeCompleteResults, [CXCodeCompleteResults.by_ref], :void
 			attach_function :get_cursor_completion_string, :clang_getCursorCompletionString, [CXCursor.by_value], :CXCompletionString
 			attach_function :default_code_completion_options, :clang_defaultCodeCompleteOptions, [], :uint
 			attach_function :sort_code_completion_results, :clang_sortCodeCompletionResults, [:pointer, :uint], :void

data/lib/ffi/clang/lib/cursor.rb

@@ -2,7 +2,7 @@
 
 # Released under the MIT License.
 # Copyright, 2013, by Garry Marshall.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Carlos Martín Nieto.
 # Copyright, 2013, by Dave Wilkinson.
 # Copyright, 2013, by Takeshi Watanabe.
@@ -10,7 +10,8 @@
 # Copyright, 2014, by George Pimm.
 # Copyright, 2014, by Niklas Therning.
 # Copyright, 2019, by Michael Metivier.
-# Copyright, 2020, by Luikore.
+# Copyright, 2020, by Zete Lui.
+# Copyright, 2023-2024, by Charlie Savage.
 
 require_relative 'translation_unit'
 require_relative 'diagnostic'
@@ -26,9 +27,9 @@ module FFI
 			enum :cursor_kind, [
 				:cursor_unexposed_decl, 1,
 				:cursor_struct, 2,
-				# :cusor_struct_decl, :cursor_struct
+				# :cursor_struct_decl, :cursor_struct
 				:cursor_union, 3,
-				# :cusor_union_decl, :cursor_union
+				# :cursor_union_decl, :cursor_union
 				:cursor_class_decl, 4,
 				:cursor_enum_decl, 5,
 				:cursor_field_decl, 6,
@@ -440,6 +441,8 @@ module FFI
 			attach_function :find_references_in_file, :clang_findReferencesInFile, [CXCursor.by_value, :CXFile, CXCursorAndRangeVisitor.by_value], :result
 
 			attach_function :get_cursor_type, :clang_getCursorType, [CXCursor.by_value], CXType.by_value
+			attach_function :cursor_is_anonymous, :clang_Cursor_isAnonymous, [CXCursor.by_value], :uint
+			attach_function :cursor_is_anonymous_record_decl, :clang_Cursor_isAnonymousRecordDecl, [CXCursor.by_value], :uint
 			attach_function :get_cursor_result_type, :clang_getCursorResultType, [CXCursor.by_value], CXType.by_value
 			attach_function :get_typedef_decl_underlying_type, :clang_getTypedefDeclUnderlyingType, [CXCursor.by_value], CXType.by_value
 			attach_function :get_enum_decl_integer_type, :clang_getEnumDeclIntegerType, [CXCursor.by_value], CXType.by_value
@@ -471,28 +474,90 @@ module FFI
 			attach_function :get_overridden_cursors, :clang_getOverriddenCursors, [CXCursor.by_value, :pointer, :pointer], :void
 			attach_function :dispose_overridden_cursors, :clang_disposeOverriddenCursors, [:pointer], :void
 
-			attach_function :get_typedef_decl_unerlying_type, :clang_getTypedefDeclUnderlyingType, [CXCursor.by_value], CXType.by_value
-
-			attach_function :get_enum_type, :clang_getEnumDeclIntegerType, [CXCursor.by_value], CXType.by_value
-
 			attach_function :get_num_args, :clang_Cursor_getNumArguments, [CXCursor.by_value], :int
 
-      attach_function :is_converting_constructor, :clang_CXXConstructor_isConvertingConstructor, [CXCursor.by_value], :uint
-      attach_function :is_copy_constructor, :clang_CXXConstructor_isCopyConstructor, [CXCursor.by_value], :uint
-      attach_function :is_default_constructor, :clang_CXXConstructor_isDefaultConstructor, [CXCursor.by_value], :uint
-      attach_function :is_move_constructor, :clang_CXXConstructor_isMoveConstructor, [CXCursor.by_value], :uint
-      attach_function :is_mutable, :clang_CXXField_isMutable, [CXCursor.by_value], :uint
-      attach_function :is_defaulted, :clang_CXXMethod_isDefaulted, [CXCursor.by_value], :uint
-      attach_function :is_abstract, :clang_CXXRecord_isAbstract, [CXCursor.by_value], :uint
-      attach_function :is_enum_scoped, :clang_EnumDecl_isScoped, [CXCursor.by_value], :uint
-      attach_function :is_const, :clang_CXXMethod_isConst, [CXCursor.by_value], :uint
-
-      if Clang.clang_version >= Gem::Version.new('16.0.0')
-        attach_function :is_deleted, :clang_CXXMethod_isDeleted, [CXCursor.by_value], :uint
-        attach_function :is_copy_assignment_operator, :clang_CXXMethod_isCopyAssignmentOperator, [CXCursor.by_value], :uint
-        attach_function :is_move_assignment_operator, :clang_CXXMethod_isMoveAssignmentOperator, [CXCursor.by_value], :uint
-        attach_function :is_explicit, :clang_CXXMethod_isExplicit, [CXCursor.by_value], :uint
-      end
+			attach_function :is_converting_constructor, :clang_CXXConstructor_isConvertingConstructor, [CXCursor.by_value], :uint
+			attach_function :is_copy_constructor, :clang_CXXConstructor_isCopyConstructor, [CXCursor.by_value], :uint
+			attach_function :is_default_constructor, :clang_CXXConstructor_isDefaultConstructor, [CXCursor.by_value], :uint
+			attach_function :is_move_constructor, :clang_CXXConstructor_isMoveConstructor, [CXCursor.by_value], :uint
+			attach_function :is_mutable, :clang_CXXField_isMutable, [CXCursor.by_value], :uint
+			attach_function :is_defaulted, :clang_CXXMethod_isDefaulted, [CXCursor.by_value], :uint
+			attach_function :is_abstract, :clang_CXXRecord_isAbstract, [CXCursor.by_value], :uint
+			attach_function :is_enum_scoped, :clang_EnumDecl_isScoped, [CXCursor.by_value], :uint
+			attach_function :is_const, :clang_CXXMethod_isConst, [CXCursor.by_value], :uint
+
+			if Clang.clang_version >= Gem::Version.new('16.0.0')
+				attach_function :get_unqualified_type, :clang_getUnqualifiedType, [CXType.by_value], CXType.by_value
+				attach_function :get_non_reference_type, :clang_getNonReferenceType, [CXType.by_value], CXType.by_value
+				attach_function :is_deleted, :clang_CXXMethod_isDeleted, [CXCursor.by_value], :uint
+				attach_function :is_copy_assignment_operator, :clang_CXXMethod_isCopyAssignmentOperator, [CXCursor.by_value], :uint
+				attach_function :is_move_assignment_operator, :clang_CXXMethod_isMoveAssignmentOperator, [CXCursor.by_value], :uint
+			end
+
+			if Clang.clang_version >= Gem::Version.new('17.0.0')
+				attach_function :is_explicit, :clang_CXXMethod_isExplicit, [CXCursor.by_value], :uint
+
+				enum :binary_operator_kind, [
+					:binary_operator_invalid,
+					:binary_operator_ptr_mem_d,
+					:binary_operator_ptr_mem_i,
+					:binary_operator_mul,
+					:binary_operator_div,
+					:binary_operator_rem,
+					:binary_operator_add,
+					:binary_operator_sub,
+					:binary_operator_shl,
+					:binary_operator_shr,
+					:binary_operator_cmp,
+					:binary_operator_lt,
+					:binary_operator_gt,
+					:binary_operator_le,
+					:binary_operator_ge,
+					:binary_operator_eq,
+					:binary_operator_ne,
+					:binary_operator_and,
+					:binary_operator_xor,
+					:binary_operator_or,
+					:binary_operator_l_and,
+					:binary_operator_l_or,
+					:binary_operator_assign,
+					:binary_operator_mul_assign,
+					:binary_operator_div_assign,
+					:binary_operator_rem_assign,
+					:binary_operator_add_assign,
+					:binary_operator_sub_assign,
+					:binary_operator_shl_assign,
+					:binary_operator_shr_assign,
+					:binary_operator_and_assign,
+					:binary_operator_xor_assign,
+					:binary_operator_or_assign,
+					:binary_operator_comma
+				]
+
+				attach_function :get_binary_operator_kind_spelling, :clang_getBinaryOperatorKindSpelling, [:binary_operator_kind], CXString.by_value
+				attach_function :get_cursor_binary_operator_kind, :clang_getCursorBinaryOperatorKind, [CXCursor.by_value], :binary_operator_kind
+
+				enum :unary_operator_kind, [
+					:unary_operator_Invalid,
+					:unary_operator_PostInc,
+					:unary_operator_PostDec,
+					:unary_operator_PreInc,
+					:unary_operator_PreDec,
+					:unary_operator_AddrOf,
+					:unary_operator_Deref,
+					:unary_operator_Plus,
+					:unary_operator_Minus,
+					:unary_operator_Not,
+					:unary_operator_LNot,
+					:unary_operator_Real,
+					:unary_operator_Imag,
+					:unary_operator_Extension,
+					:unary_operator_Coawait
+				]
+
+				attach_function :get_unary_operator_kind_spelling, :clang_getUnaryOperatorKindSpelling, [:unary_operator_kind], CXString.by_value
+				attach_function :get_cursor_unary_operator_kind, :clang_getCursorUnaryOperatorKind, [CXCursor.by_value], :unary_operator_kind
+			end
 		end
 	end
 end

data/lib/ffi/clang/lib/diagnostic.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Garry Marshall.
 # Copyright, 2014, by Masahiro Sano.
-# Copyright, 2020, by Luikore.
+# Copyright, 2020, by Zete Lui.
 
 require_relative 'translation_unit'
 require_relative 'source_location'

data/lib/ffi/clang/lib/file.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2010, by Jari Bakken.
+# Copyright, 2012, by Hal Brodigan.
+# Copyright, 2013-2024, by Samuel Williams.
 # Copyright, 2013, by Carlos Martín Nieto.
 # Copyright, 2014, by Masahiro Sano.
 

data/lib/ffi/clang/lib/index.rb

@@ -4,6 +4,7 @@
 # Copyright, 2010, by Jari Bakken.
 # Copyright, 2012, by Hal Brodigan.
 # Copyright, 2013-2022, by Samuel Williams.
+# Copyright, 2024, by Charlie Savage.
 
 module FFI
 	module Clang
@@ -13,6 +14,24 @@ module FFI
 			# Source code index:
 			attach_function :create_index, :clang_createIndex, [:int, :int], :CXIndex
 			attach_function :dispose_index, :clang_disposeIndex, [:CXIndex], :void
+
+			if Clang.clang_version >= Gem::Version.new('17.0.0')
+				class CXIndexOptions < FFI::Struct
+					layout(
+						:size, :uint,
+						:thread_background_priority_for_indexing, :uchar,
+						:thread_background_priority_for_editing, :uchar,
+						:exclude_declarations_from_pch, :uint,
+						:display_diagnostics, :uint,
+						:store_preambles_in_memory, :uint,
+						:reserved, :uint,
+						:preamble_storage_path, :string,
+						:invocation_emission_path, :string
+					)
+				end
+
+				attach_function :create_index_with_options, :clang_createIndexWithOptions, [CXIndexOptions.by_ref], :CXIndex
+			end
 		end
 	end
 end

data/lib/ffi/clang/lib/printing_policy.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2024, by Charlie Savage.
+# Copyright, 2024, by Samuel Williams.
+
+module FFI
+	module Clang
+		module Lib
+      typedef :pointer, :CXPrintingPolicy
+
+      PrintingPolicyProperty = enum [:printing_policy_indentation,
+                                     :printing_policy_suppress_specifiers,
+                                     :printing_policy_suppress_tag_keyword,
+                                     :printing_policy_include_tag_definition,
+                                     :printing_policy_suppress_scope,
+                                     :printing_policy_suppress_unwritten_scope,
+                                     :printing_policy_suppress_initializers,
+                                     :printing_policy_constant_array_aize_as_written,
+                                     :printing_policy_anonymous_tag_locations,
+                                     :printing_policy_suppress_strong_lifetime,
+                                     :printing_policy_suppress_lifetime_qualifiers,
+                                     :printing_policy_suppress_template_args_in_cxx_constructors,
+                                     :printing_policy_bool,
+                                     :printing_policy_restrict,
+                                     :printing_policy_alignof,
+                                     :printing_policy_underscore_alignof,
+                                     :printing_policy_use_void_for_zero_params,
+                                     :printing_policy_terse_output,
+                                     :printing_policy_polish_for_declaration,
+                                     :printing_policy_half,
+                                     :printing_policy_msw_char,
+                                     :printing_policy_include_new_lines,
+                                     :printing_policy_msvc_formatting,
+                                     :printing_policy_constants_as_written,
+                                     :printing_policy_suppress_implicit_base,
+                                     :printing_policy_fully_qualified_name,
+                                     :printing_policy_last_property]
+
+      attach_function :printing_policy_get_property, :clang_PrintingPolicy_getProperty, [:CXPrintingPolicy, PrintingPolicyProperty], :uint
+      attach_function :printing_policy_set_property, :clang_PrintingPolicy_setProperty, [:CXPrintingPolicy, PrintingPolicyProperty, :uint], :void
+      attach_function :get_printing_policy, :clang_getCursorPrintingPolicy, [CXCursor.by_value], :CXPrintingPolicy
+      attach_function :dispose_printing_policy, :clang_PrintingPolicy_dispose, [:CXPrintingPolicy], :void
+      attach_function :pretty_print, :clang_getCursorPrettyPrinted, [CXCursor.by_value, :CXPrintingPolicy], CXString.by_value
+		end
+	end
+end