An Information Portal to Biological Macromolecular Structures
PDB Home | Contact Us		Software Tools Home  |  Dictionary Home  |  PDBML Home

SearchLessThanEqual

NAME SearchLessThanEqual

PROTOTYPE

#include "ISTable.h"

ReVarPCifArray<int> * ISTable::SearchLessThanEqual(
                                  ReVarCifArray<CifString> &targets, 
                                  ReVarCifArray<CifString> & colNames,
                                  int & errCode);

ReVarPCifArray<int> * ISTable::SearchLessThanEqual(
                                  ReVarCifArray<CifString> &targets, 
                                  ReVarPCifArray<int> & colIds,
                                  int & errCode);

ReVarPCifArray<int> * ISTable::SearchLessThanEqual(
                                  CifString indexName, 
                                  ReVarCifArray<CifString> &targets, 
                                  ReVarCifArray<CifString> & colNames,
                                  int & errCode);

ReVarPCifArray<int> * ISTable::SearchLessThanEqual(
                                  CifString indexName, 
                                  ReVarCifArray<CifString> &targets, 
                                  ReVarPCifArray<int> & colIds,
                                  int & errCode);

EXAMPLE

#include "ISTable.h"

CifString cs("30.00"), col1("twist");
int errCode = 0;
ISTable s("MyTable");
...
s.SetFlags(ISTable::DT_DOUBLE, s.GetColumnIndex(col1.Text()));
s.SetPrecision(2, s.GetColumnIndex(col1.Text()));

ReVarCifArray<CifString> vals, names;
vals.Add(cs);
names.Add(col1); 
s->CreateIndex("index0",names);

ReVarPCifArray<int> * iArray;
iArray = s.SearchLessThanEqual(vals, names, errCode);
if (iArray) {
  for (int i = 0; i < iArray->Length(); i++) {
    // do something to each row with twist <= 30.00
  }
}

PURPOSE

SearchLessThanEqual returns the row indices of cells in a column that are less than or equal the target value.

RECEIVES

SearchLessThanEqual(ReVarCifArray<CifString>&, ReVarCifArray<CifString>&, int &)

targets	An array of target strings to search for.
colNames	The names of the columns to search.
errCode	A reference to an integer holding the error code resulting from this operation.

SearchLessThanEqual(ReVarCifArray<CifString>&, ReVarCifArray<int>&, int &)

targets	An array of target strings to search for.
colIds	The indices of the columns to search.
errCode	A reference to an integer holding the error code resulting from this operation.

SearchLessThanEqual(CifString, ReVarCifArray<CifString>&,
ReVarCifArray<CifString>&, int &)

indexName	Name of the index used for searching.
targets	An array of target strings to search for.
colNames	The names of the columns to search.
errCode	A reference to an integer holding the error code resulting from this operation.

SearchLessThanEqual(CifString, ReVarCifArray<CifString>&,
ReVarCifArray<int>&, int &)

indexName	Name of the index used for searching.
targets	An array of target strings to search for.
colIds	The indices of the columns to search.
errCode	A reference to an integer holding the error code resulting from this operation.

RETURN VALUE

A pointer to a ReVarPCifArray<int> holding the row indices of the cells containing a value less than the target.
A NULL value indicates a possible error or an unsuccessful search.
A negative value in errCode indicates an error or warning.

REMARKS

See also:	SearchLessThan
	SearchGreaterThan
	SearchGreaterThanEqual
	SearchBetween

 

© RCSB PDB