Package ghidra.program.util

# Class DefinedDataIterator

java.lang.Object
ghidra.program.util.DefinedDataIterator

All Implemented Interfaces:
  `DataIterator`, `Iterable<Data>`, `Iterator<Data>`

public class DefinedDataIterator extends Object implements DataIterator
Iterator that visits each defined data instance in the initialized memory of a Program or in the footprint of a specified data element.

Data elements that are nested inside of composites or arrays are visited, not just the parent/containing data element.

- ## Nested Class Summary

  ## Nested classes/interfaces inherited from interface ghidra.program.model.listing.DataIterator

  `DataIterator.IteratorWrapper`

- ## Field Summary

  ### Fields inherited from interface ghidra.program.model.listing.DataIterator

  `EMPTY`

- ## Method Summary

  Modifier and Type
  Method
  Description
  `static DefinedDataIterator`
  `byDataInstance(Program program, Predicate<Data> dataInstancePredicate)`
  Creates a new iterator that traverses the entire Program's address space, returning data instances that successfully match the predicate.
  `static DefinedDataIterator`
  `byDataType(Program program, AddressSetView addresses, Predicate<DataType> dataTypePredicate)`
  Creates a new iterator that traverses a portion of the Program's address space, returning data instances that successfully match the predicate.
  `static DefinedDataIterator`
  `byDataType(Program program, Predicate<DataType> dataTypePredicate)`
  Creates a new iterator that traverses the entire Program's address space, returning data instances that successfully match the predicate.
  `static DefinedDataIterator`
  `definedStrings(Data singleDataInstance)`
  Creates a new iterator that traverses the address space of a single data item (ie.
  `static DefinedDataIterator`
  `definedStrings(Program program)`
  Creates a new iterator that traverses the entire Program's address space returning data instances that are strings.
  `static DefinedDataIterator`
  `definedStrings(Program program, AddressSetView addrs)`
  Creates a new iterator that traverses a portion of the Program's address space returning data instances that are strings.
  `boolean`
  `hasNext()`
  `Data`
  `next()`

  ### Methods inherited from class java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

  ### Methods inherited from interface ghidra.program.model.listing.DataIterator

  `iterator`

  ### Methods inherited from interface java.lang.Iterable

  `forEach, spliterator`

  ### Methods inherited from interface java.util.Iterator

  `forEachRemaining, remove`

- ## Method Details

  - ### byDataType

    public static DefinedDataIterator byDataType(Program program, Predicate<DataType> dataTypePredicate)
    Creates a new iterator that traverses the entire Program's address space, returning data instances that successfully match the predicate.
    Parameters:
      `program` - Program to search
      `dataTypePredicate` - `Predicate` that tests each data instance's `DataType`
    Returns:
      new iterator

  - ### byDataType

    public static DefinedDataIterator byDataType(Program program, AddressSetView addresses, Predicate<DataType> dataTypePredicate)
    Creates a new iterator that traverses a portion of the Program's address space, returning data instances that successfully match the predicate.
    Parameters:
      `program` - Program to search
      `addresses` - addresses to limit the iteration to
      `dataTypePredicate` - `Predicate` that tests each data instance's `DataType`
    Returns:
      new iterator

  - ### byDataInstance

    public static DefinedDataIterator byDataInstance(Program program, Predicate<Data> dataInstancePredicate)
    Creates a new iterator that traverses the entire Program's address space, returning data instances that successfully match the predicate.
    Parameters:
      `program` - Program to search
      `dataInstancePredicate` - `Predicate` that tests each data instance's properties
    Returns:
      new iterator

  - ### definedStrings

    public static DefinedDataIterator definedStrings(Program program)
    Creates a new iterator that traverses the entire Program's address space returning data instances that are strings.
    Parameters:
      `program` - Ghidra `Program` to search
    Returns:
      new iterator

  - ### definedStrings

    public static DefinedDataIterator definedStrings(Program program, AddressSetView addrs)
    Creates a new iterator that traverses a portion of the Program's address space returning data instances that are strings.
    Parameters:
      `program` - Ghidra `Program` to search
      `addrs` - addresses to limit the iteration to
    Returns:
      new iterator

  - ### definedStrings

    public static DefinedDataIterator definedStrings(Data singleDataInstance)
    Creates a new iterator that traverses the address space of a single data item (ie. a composite or array data instance that needs to be recursed into).
    Parameters:
      `singleDataInstance` - Data instance
    Returns:
      new iterator

  - ### hasNext

    public boolean hasNext()
    Specified by:
      `hasNext` in interface `DataIterator`
    Specified by:
      `hasNext` in interface `Iterator<Data>`

  - ### next

    public Data next()
    Specified by:
      `next` in interface `DataIterator`
    Specified by:
      `next` in interface `Iterator<Data>`