OpenCV  5.0.0-pre
Open Source Computer Vision
Loading...
Searching...
No Matches
Public Member Functions | Protected Attributes | List of all members
cv::FileNodeIterator Class Reference

used to iterate through sequences and mappings. More...

#include <opencv2/core/persistence.hpp>

Collaboration diagram for cv::FileNodeIterator:

Public Member Functions

 FileNodeIterator ()
 The constructors.
 
 FileNodeIterator (const FileNode &node, bool seekEnd)
 
 FileNodeIterator (const FileNodeIterator &it)
 
bool equalTo (const FileNodeIterator &it) const
 
FileNode operator* () const
 returns the currently observed element
 
FileNodeIteratoroperator++ ()
 moves iterator to the next node
 
FileNodeIterator operator++ (int)
 moves iterator to the next node
 
FileNodeIteratoroperator+= (int ofs)
 moves iterator forward by the specified offset (possibly negative)
 
FileNodeIteratoroperator= (const FileNodeIterator &it)
 
FileNodeIteratorreadRaw (const String &fmt, void *vec, size_t len=(size_t) INT_MAX)
 Reads node elements to the buffer with the specified format.
 
size_t remaining () const
 returns the number of remaining (not read yet) elements
 

Protected Attributes

size_t blockIdx
 
size_t blockSize
 
FileStorage::Impl * fs
 
size_t idx
 
size_t nodeNElems
 
size_t ofs
 

Detailed Description

used to iterate through sequences and mappings.

A standard STL notation, with node.begin(), node.end() denoting the beginning and the end of a sequence, stored in node. See the data reading sample in the beginning of the section.

Examples
samples/cpp/filestorage.cpp.

Constructor & Destructor Documentation

◆ FileNodeIterator() [1/3]

cv::FileNodeIterator::FileNodeIterator ( )

The constructors.

These constructors are used to create a default iterator, set it to specific element in a file node or construct it from another iterator.

◆ FileNodeIterator() [2/3]

cv::FileNodeIterator::FileNodeIterator ( const FileNode node,
bool  seekEnd 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters
nodeFile node - the collection to iterate over; it can be a scalar (equivalent to 1-element collection) or "none" (equivalent to empty collection).
seekEnd- true if iterator needs to be set after the last element of the node; that is: node.begin() => FileNodeIterator(node, false) node.end() => FileNodeIterator(node, true)

◆ FileNodeIterator() [3/3]

cv::FileNodeIterator::FileNodeIterator ( const FileNodeIterator it)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

Parameters
itIterator to be used as initialization for the created iterator.

Member Function Documentation

◆ equalTo()

bool cv::FileNodeIterator::equalTo ( const FileNodeIterator it) const

◆ operator*()

FileNode cv::FileNodeIterator::operator* ( ) const

returns the currently observed element

◆ operator++() [1/2]

FileNodeIterator & cv::FileNodeIterator::operator++ ( )

moves iterator to the next node

◆ operator++() [2/2]

FileNodeIterator cv::FileNodeIterator::operator++ ( int  )

moves iterator to the next node

◆ operator+=()

FileNodeIterator & cv::FileNodeIterator::operator+= ( int  ofs)

moves iterator forward by the specified offset (possibly negative)

◆ operator=()

FileNodeIterator & cv::FileNodeIterator::operator= ( const FileNodeIterator it)

◆ readRaw()

FileNodeIterator & cv::FileNodeIterator::readRaw ( const String fmt,
void *  vec,
size_t  len = (size_t) INT_MAX 
)

Reads node elements to the buffer with the specified format.

Usually it is more convenient to use operator >> instead of this method.

Parameters
fmtSpecification of each array element. See format specification
vecPointer to the destination array.
lenNumber of bytes to read (buffer size limit). If it is greater than number of remaining elements then all of them will be read.

◆ remaining()

size_t cv::FileNodeIterator::remaining ( ) const

returns the number of remaining (not read yet) elements

Member Data Documentation

◆ blockIdx

size_t cv::FileNodeIterator::blockIdx
protected

◆ blockSize

size_t cv::FileNodeIterator::blockSize
protected

◆ fs

FileStorage::Impl* cv::FileNodeIterator::fs
protected

◆ idx

size_t cv::FileNodeIterator::idx
protected

◆ nodeNElems

size_t cv::FileNodeIterator::nodeNElems
protected

◆ ofs

size_t cv::FileNodeIterator::ofs
protected

The documentation for this class was generated from the following file: