=====find=====
Syntax:

<code>
    #include <map>
    iterator find( const key_type& key );
    const_iterator find( const key_type& key ) const;
</code>

The find() function returns an iterator to the matching key/value pair, or an iterator to the end of
the map if key is not found.

find() runs in [[/complexity|logarithmic time]].

For example, the following code uses the find() function to determine how many
times a user entered a certain word:

<code>
    map<string,int> stringCounts;
    string str;

    while( cin >> str ) ++stringCounts[str];

    map<string,int>::iterator iter = stringCounts.find("spoon");
    if( iter != stringCounts.end() ) {
      cout << "You typed '" << iter->first << "' " << iter->second << " time(s)" << endl;
    }
</code>

When run with this input:

<code terminal>
  my spoon is too big.  my spoon is TOO big!  my SPOON is TOO big!  I am a BANANA!
</code>

...the above code produces this output:

<code terminal>
  You typed 'spoon' 2 time(s)
</code>