public method IO2GOffersTable.getNextRowByColumnValue

Brief

Gets the next row from IO2GOffersTable based on the column value.

Declaration
C++
virtual bool  getNextRowByColumnValue (const char *columnID, const void *columnValueAsVariant, IO2GTableIterator &iterator, IO2GOfferTableRow *&row) = 0

Parameters
columnID

The name of a column in the Offers table. For example, InstrumentType.
columnValueAsVariant

The value of the column specified by the columnId parameter. For example, if you want to search the Offers table for Forex instruments only, the columnId parameter value is InstrumentType, the columnValue parameter value is 1.
iterator

The table iterator.
row

[out] The row fetched.

Details

This method allows finding all rows that contain the specified column value.
If the row is not found, the method returns false.

Example

Get Forex instruments from the Offers table [hide]

    O2G2Ptr<IO2GOffersTable> offersTable = (IO2GOffersTable *)tableManager->getTable(Offers);
    bool found = false;
    IO2GTableIterator iterator;
    IO2GOfferTableRow *offer = NULL;
    while (offersTable->getNextRowByColumnValue("InstrumentType", "1", iterator, offer))
    {
        found = true;
        std::cout << "Instrument: " << offer->getInstrument() <<
                     " Bid = " << offer->getBid() <<
                     " Ask = " << offer->getAsk() << std::endl;
        offer->release();
    }
    if (!found)
        std::cout << "No Forex instruments found." << std:endl;

Note: The returned row contains the current column values. The values are not automatically updated. To monitor changes, use IO2GTableListener.onChanged. The row interface is thread-safe. The returned row can be used in different threads without synchronization.

Declared in IO2GOffersTable

back