|
public static CursorFind ( |
||
| handle | ||
| keydata | byte | |
| recdata | byte | |
| flags | int | |
| return | int | |
/// <summary>
/// Searches for a key and points the Cursor to this key
/// </summary>
/// <remarks>
/// This method wraps the native ups_cursor_find function.
/// <br />
/// Searches for an item in the Database and points the Cursor to this
/// item. If the item could not be found, the Cursor is not modified and the return value is null.
/// <br />
/// If the key has multiple duplicates, the Cursor is positioned
/// on the first duplicate.
/// </remarks>
/// <param name="key">The key to search for</param>
/// <param name="flags">The flags, can be zero</param>
public byte[] TryFind(ref byte[] key, int flags)
{
int st;
byte[] record = null;
lock (db)
{
st = NativeMethods.CursorFind(handle, ref key, ref record, flags);
}
return(record);
}
/// <summary>
/// Searches a key and points the Cursor to this key
/// </summary>
/// <remarks>
/// This method wraps the native ups_cursor_find function.
/// <br />
/// Searches for an item in the Database and points the Cursor to this
/// item. If the item could not be found, the Cursor is not modified.
/// <br />
/// If the key has multiple duplicates, the Cursor is positioned
/// on the first duplicate.
/// </remarks>
/// <param name="key">The key to search for</param>
/// <param name="flags">The flags, can be zero</param>
/// <exception cref="DatabaseException">
/// <list type="bullet">
/// <item><see cref="UpsConst.UPS_KEY_NOT_FOUND"/>
/// if the requested key was not found</item>
/// </list>
/// </exception>
public byte[] Find(ref byte[] key, int flags)
{
int st;
byte[] record = null;
lock (db) {
st = NativeMethods.CursorFind(handle, ref key, ref record, flags);
}
if (st != 0)
{
throw new DatabaseException(st);
}
return(record);
}