company logo

Property :: next - Try selecting next instance in collection

The function locates the next instance in a collection starting from the currently located one. When no instance is located, the function selects the first valid instance. In case of ordered access, the function allows locating the next instance, that differs in a certain key component.

When a filter has been defined for the collection, the function returns the next valid instance according to the filter condition.

The function returns true, when next instance has been located successfully. Otherwise it returns false. In case of read errors or when the property handle is not accessible the function throws an exception.
Return value:  Success ( bool  )

The value is true when the function was executed successfully. Otherwise the value is set to false.

Implementation overview

Implementation details

  1. Locate next instance
    bool Property  :: next (  )

    The function locates the first instance in the property handle without reading it. The instance might be selected when a filter has been set for the property handle.

    In order to make sure that the instance is selected, one may call get() or next(true).
    2. to list
  2. Locate next instance for key level
    bool Property  :: next ( int32 iKeyLevel, bool bRead )

    The switch level (iKeyLevel) allows defining the last key components that must alter. This allows e.g. reading all key values without duplicates when fixing the last key component.
    • iKeyLevel - Number of fixed key component

      The switch level defines the key component number that need not change when calling next() or locateKey() beginning with 1 for the first key component.
    • bRead - Read option

      The option forces the function to read the instance when it could be located.
    3. to list
  3. Locate and read next instance
    bool Property  :: next ( bool bRead )

    The function locates and reads the next instance, when passing true in bRead. When passing false, the function tries to locate the instance without reading.
    • bRead - Read option

      The option forces the function to read the instance when it could be located.
    4. to list
to top previous next upper table of contents Comment