Imports
Classes:
-
ImportInfo–Represents an imported function/symbol.
-
ImportModuleInfo–Represents an imported module (DLL/shared library).
-
Imports–Provides access to imports in the IDA database.
dataclass
ImportInfo(
address: ea_t,
name: Optional[str],
ordinal: int,
module_index: int,
module_name: str,
)
Represents an imported function/symbol.
Methods:
-
has_name–Check if this import has a name (not ordinal-only).
Attributes:
-
address(ea_t) – -
module_index(int) – -
module_name(str) – -
name(Optional[str]) – -
ordinal(int) –
instance-attribute
address: ea_t
instance-attribute
module_index: int
instance-attribute
module_name: str
instance-attribute
name: Optional[str]
instance-attribute
ordinal: int
has_name() -> bool
Check if this import has a name (not ordinal-only).
dataclass
ImportModuleInfo(index: int, name: str)
Imports(database: Database)
Bases: DatabaseEntity
Provides access to imports in the IDA database.
Can be used to iterate over all import modules in the opened database.
Args: database: Reference to the active IDA database.
Methods:
-
exists–Check if an import with the given qualified name exists (case-insensitive).
-
get_all_imports–Get all imports from all modules (flattened).
-
get_all_modules–Get all import modules.
-
get_import_addresses–Get all import addresses.
-
get_import_at–Get import at a specific address.
-
get_import_by_name–Find import by qualified name (case-insensitive).
-
get_import_count–Get the total number of imports across all modules.
-
get_import_names–Get all import names in qualified format.
-
get_imports_for_module–Get all imports from a specific module.
-
get_module_at_index–Get import module by its index.
-
get_module_by_name–Find import module by name (case-insensitive).
-
get_module_count–Get the total number of import modules.
-
get_module_names–Get all module names.
Attributes:
-
database(Database) –Get the database reference, guaranteed to be non-None when called from
-
m_database–
property
database: Database
Get the database reference, guaranteed to be non-None when called from methods decorated with @check_db_open.
Returns: The active database instance.
Note: This property should only be used in methods decorated with @check_db_open, which ensures m_database is not None.
instance-attribute
m_database = database
exists(name: str) -> bool
Check if an import with the given qualified name exists (case-insensitive).
Args: name: Import name in 'module!symbol' or 'module!#ordinal' format.
Returns: True if import exists.
get_all_imports() -> Iterator[ImportInfo]
Get all imports from all modules (flattened).
Yields: Each import in the program.
get_all_modules() -> Iterator[ImportModuleInfo]
Get all import modules.
Yields: Each import module in the program.
get_import_addresses() -> Iterator[ea_t]
Get all import addresses.
Yields: Each import address.
get_import_at(ea: ea_t) -> Optional[ImportInfo]
Get import at a specific address.
Args: ea: Linear address to search for.
Returns: The import at the specified address, or None if not found.
get_import_by_name(name: str) -> Optional[ImportInfo]
Find import by qualified name (case-insensitive).
Args: name: Import name in 'module!symbol' format (e.g., 'kernel32.dll!CreateFileW') or 'module!#ordinal' format (e.g., 'kernel32.dll!#42').
Returns: The import with the specified name, or None if not found.
get_import_count() -> int
Get the total number of imports across all modules.
Returns: Total number of imports.
get_import_names() -> Iterator[str]
Get all import names in qualified format.
Yields: Each import in 'module!symbol' or 'module!#ordinal' format.
get_imports_for_module(
module_index: int,
) -> Iterator[ImportInfo]
Get all imports from a specific module.
Args: module_index: Index of the module.
Yields: Each import from the specified module.
Raises: IndexError: If module_index is out of range.
get_module_at_index(index: int) -> ImportModuleInfo
Get import module by its index.
Args: index: Module index (0 to get_module_count()-1)
Returns: The import module at the specified index.
Raises: IndexError: If index is out of range.
get_module_by_name(name: str) -> Optional[ImportModuleInfo]
Find import module by name (case-insensitive).
Args: name: Module name to search for.
Returns: The import module with the specified name, or None if not found.
get_module_count() -> int
Get the total number of import modules.
Returns: Number of import modules in the program.
get_module_names() -> Iterator[str]
Get all module names.
Yields: Each module name.