function: map_sss_findlibrary: avlmap

Name

map_sss_find

Synopsis

int map_sss_find( MAP mapping, const signed short * key, int direction )

Description

map_sss_find finds a member of a mapping that matches or nearly matches a given key of type string of signed short, and selects that member to become the active member of this mapping.

Arguments

  1. mapping is the handle of the specified mapping.
  2. key is the pointer to the key string to search for
  3. direction is the indication of the search orientation to apply:
    • -2 : match the lowest exact, or nearest lower key
    • -1 : match the lowest exact key only
    • 0 : match any exact key
    • 1 : match the highest exact key only
    • 2 : match the highest exact, or nearest higher key

Return values

Errors

The errno value is set by system functions when an error occurs.

See also

avlmap index page


The documentation, source code, and derived compilations are
Copyright © 2000 by Philip Howard.
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA