2013-08-30 02:14:14 +00:00
2013-08-22 15:08:35 +00:00
< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2013-08-30 02:14:14 +00:00
2013-08-22 15:08:35 +00:00
< html xmlns = "http://www.w3.org/1999/xhtml" >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=utf-8" / >
2013-08-30 02:14:14 +00:00
< title > equal_range — Sprout 1.0 documentation< / title >
2013-08-25 15:09:33 +00:00
< link rel = "stylesheet" href = "../../../_static/sphinxdoc.css" type = "text/css" / >
2013-08-22 15:08:35 +00:00
< link rel = "stylesheet" href = "../../../_static/pygments.css" type = "text/css" / >
2013-08-30 02:14:14 +00:00
2013-08-22 15:08:35 +00:00
< script type = "text/javascript" >
var DOCUMENTATION_OPTIONS = {
URL_ROOT: '../../../',
VERSION: '1.0',
2013-08-30 02:14:14 +00:00
COLLAPSE_INDEX: false,
2013-08-22 15:08:35 +00:00
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
< / script >
< script type = "text/javascript" src = "../../../_static/jquery.js" > < / script >
2013-08-30 02:14:14 +00:00
< script type = "text/javascript" src = "../../../_static/underscore.js" > < / script >
2013-08-22 15:08:35 +00:00
< script type = "text/javascript" src = "../../../_static/doctools.js" > < / script >
2013-08-30 02:14:14 +00:00
< link rel = "top" title = "Sprout 1.0 documentation" href = "../../../index.html" / >
2013-08-22 15:08:35 +00:00
< link rel = "up" title = "Sprout.Algorithm" href = "index.html" / >
< link rel = "next" title = "binary_search" href = "binary_search.html" / >
< link rel = "prev" title = "upper_bound" href = "upper_bound.html" / >
< / head >
< body >
< div class = "related" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../../../genindex.html" title = "General Index"
accesskey="I">index< / a > < / li >
< li class = "right" >
< a href = "binary_search.html" title = "binary_search"
accesskey="N">next< / a > |< / li >
< li class = "right" >
< a href = "upper_bound.html" title = "upper_bound"
accesskey="P">previous< / a > |< / li >
2013-08-30 02:14:14 +00:00
< li > < a href = "../../../index.html" > Sprout 1.0 documentation< / a > » < / li >
2013-08-22 15:08:35 +00:00
< li > < a href = "../../index.html" > Sprout C++ Libraries< / a > » < / li >
< li > < a href = "../../libraries.html" > Libraries< / a > » < / li >
< li > < a href = "index.html" accesskey = "U" > Sprout.Algorithm< / a > » < / li >
< / ul >
2013-08-25 15:09:33 +00:00
< / div >
< div class = "sphinxsidebar" >
< div class = "sphinxsidebarwrapper" >
2013-08-30 02:14:14 +00:00
< h3 > < a href = "../../../index.html" > Table Of Contents< / a > < / h3 >
< ul >
< li > < a class = "reference internal" href = "#" > equal_range< / a > < ul >
< li > < a class = "reference internal" href = "#interface" > Interface< / a > < / li >
< li > < a class = "reference internal" href = "#requires" > Requires< / a > < / li >
< li > < a class = "reference internal" href = "#returns" > Returns< / a > < / li >
< li > < a class = "reference internal" href = "#examples" > Examples< / a > < / li >
< li > < a class = "reference internal" href = "#complexity" > Complexity< / a > < / li >
< li > < a class = "reference internal" href = "#header" > Header< / a > < / li >
2013-08-25 15:09:33 +00:00
< / ul >
< / li >
< / ul >
2013-08-30 02:14:14 +00:00
< h4 > Previous topic< / h4 >
< p class = "topless" > < a href = "upper_bound.html"
title="previous chapter">upper_bound< / a > < / p >
< h4 > Next topic< / h4 >
< p class = "topless" > < a href = "binary_search.html"
title="next chapter">binary_search< / a > < / p >
< h3 > This Page< / h3 >
< ul class = "this-page-menu" >
< li > < a href = "../../../_sources/libs/sprout/algorithm/equal_range.txt"
rel="nofollow">Show Source< / a > < / li >
< / ul >
< div id = "searchbox" style = "display: none" >
< h3 > Quick search< / h3 >
< form class = "search" action = "../../../search.html" method = "get" >
< input type = "text" name = "q" / >
< input type = "submit" value = "Go" / >
< input type = "hidden" name = "check_keywords" value = "yes" / >
< input type = "hidden" name = "area" value = "default" / >
< / form >
< p class = "searchtip" style = "font-size: 90%" >
Enter search terms or a module, class or function name.
< / p >
< / div >
< script type = "text/javascript" > $ ( '#searchbox' ) . show ( 0 ) ; < / script >
2013-08-25 15:09:33 +00:00
< / div >
< / div >
2013-08-22 15:08:35 +00:00
< div class = "document" >
< div class = "documentwrapper" >
< div class = "bodywrapper" >
< div class = "body" >
< div class = "section" id = "equal-range" >
< h1 > equal_range< a class = "headerlink" href = "#equal-range" title = "Permalink to this headline" > ¶< / a > < / h1 >
< div class = "section" id = "interface" >
< h2 > Interface< a class = "headerlink" href = "#interface" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-c++" > < div class = "highlight" > < pre > < span class = "k" > template< / span > < span class = "o" > < < / span > < span class = "k" > typename< / span > < span class = "n" > ForwardIterator< / span > < span class = "p" > ,< / span > < span class = "k" > typename< / span > < span class = "n" > T< / span > < span class = "o" > > < / span >
< span class = "kr" > inline< / span > < span class = "n" > SPROUT_CONSTEXPR< / span > < span class = "n" > sprout< / span > < span class = "o" > ::< / span > < span class = "n" > pair< / span > < span class = "o" > < < / span > < span class = "n" > ForwardIterator< / span > < span class = "p" > ,< / span > < span class = "n" > ForwardIterator< / span > < span class = "o" > > < / span >
< span class = "n" > equal_range< / span > < span class = "p" > (< / span > < span class = "n" > ForwardIterator< / span > < span class = "n" > first< / span > < span class = "p" > ,< / span > < span class = "n" > ForwardIterator< / span > < span class = "n" > last< / span > < span class = "p" > ,< / span > < span class = "n" > T< / span > < span class = "k" > const< / span > < span class = "o" > & < / span > < span class = "n" > value< / span > < span class = "p" > );< / span >
< span class = "k" > template< / span > < span class = "o" > < < / span > < span class = "k" > typename< / span > < span class = "n" > ForwardIterator< / span > < span class = "p" > ,< / span > < span class = "k" > typename< / span > < span class = "n" > T< / span > < span class = "p" > ,< / span > < span class = "k" > typename< / span > < span class = "n" > Compare< / span > < span class = "o" > > < / span >
< span class = "kr" > inline< / span > < span class = "n" > SPROUT_CONSTEXPR< / span > < span class = "n" > sprout< / span > < span class = "o" > ::< / span > < span class = "n" > pair< / span > < span class = "o" > < < / span > < span class = "n" > ForwardIterator< / span > < span class = "p" > ,< / span > < span class = "n" > ForwardIterator< / span > < span class = "o" > > < / span >
< span class = "n" > equal_range< / span > < span class = "p" > (< / span > < span class = "n" > ForwardIterator< / span > < span class = "n" > first< / span > < span class = "p" > ,< / span > < span class = "n" > ForwardIterator< / span > < span class = "n" > last< / span > < span class = "p" > ,< / span > < span class = "n" > T< / span > < span class = "k" > const< / span > < span class = "o" > & < / span > < span class = "n" > value< / span > < span class = "p" > ,< / span > < span class = "n" > Compare< / span > < span class = "n" > comp< / span > < span class = "p" > );< / span >
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "requires" >
< h2 > Requires< a class = "headerlink" href = "#requires" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "line-block" >
< div class = "line" > The elements e of [first,last) shall be partitioned with respect to the expressions < tt class = "docutils literal" > < span class = "pre" > e< / span > < span class = "pre" > < < / span > < span class = "pre" > value< / span > < / tt > and < tt class = "docutils literal" > < span class = "pre" > !(value< / span > < span class = "pre" > < < / span > < span class = "pre" > e)< / span > < / tt > or < tt class = "docutils literal" > < span class = "pre" > comp(e,< / span > < span class = "pre" > value)< / span > < / tt > and < tt class = "docutils literal" > < span class = "pre" > !comp(value,< / span > < span class = "pre" > e)< / span > < / tt > .< / div >
< div class = "line" > Also, for all elements e of [first, last), < tt class = "docutils literal" > < span class = "pre" > e< / span > < span class = "pre" > < < / span > < span class = "pre" > value< / span > < / tt > shall imply < tt class = "docutils literal" > < span class = "pre" > !(value< / span > < span class = "pre" > < < / span > < span class = "pre" > e)< / span > < / tt > or < tt class = "docutils literal" > < span class = "pre" > comp(e,< / span > < span class = "pre" > value)< / span > < / tt > shall imply < tt class = "docutils literal" > < span class = "pre" > !comp(value,< / span > < span class = "pre" > e)< / span > < / tt > .< / div >
< / div >
< / div >
< div class = "section" id = "returns" >
< h2 > Returns< a class = "headerlink" href = "#returns" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "line-block" >
< div class = "line" > < tt class = "docutils literal" > < span class = "pre" > make_pair(lower_bound(first,< / span > < span class = "pre" > last,< / span > < span class = "pre" > value),< / span > < span class = "pre" > upper_bound(first,< / span > < span class = "pre" > last,< / span > < span class = "pre" > value))< / span > < / tt > < / div >
< div class = "line" > or< / div >
< div class = "line" > < tt class = "docutils literal" > < span class = "pre" > make_pair(lower_bound(first,< / span > < span class = "pre" > last,< / span > < span class = "pre" > value,< / span > < span class = "pre" > comp),< / span > < span class = "pre" > upper_bound(first,< / span > < span class = "pre" > last,< / span > < span class = "pre" > value,< / span > < span class = "pre" > comp))< / span > < / tt > < / div >
< / div >
< / div >
< div class = "section" id = "examples" >
< h2 > Examples< a class = "headerlink" href = "#examples" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "highlight-c++" > < div class = "highlight" > < pre > < span class = "cp" > #include < sprout/algorithm/equal_range.hpp> < / span >
< span class = "cp" > #include < sprout/algorithm/all_of_equal.hpp> < / span >
< span class = "cp" > #include < sprout/array.hpp> < / span >
< span class = "cp" > #include < sprout/container.hpp> < / span >
< span class = "k" > using< / span > < span class = "k" > namespace< / span > < span class = "n" > sprout< / span > < span class = "p" > ;< / span >
< span class = "n" > SPROUT_STATIC_CONSTEXPR< / span > < span class = "k" > auto< / span > < span class = "n" > input< / span > < span class = "o" > =< / span > < span class = "n" > array< / span > < span class = "o" > < < / span > < span class = "kt" > int< / span > < span class = "p" > ,< / span > < span class = "mi" > 10< / span > < span class = "o" > > < / span > < span class = "p" > {{< / span > < span class = "mi" > 1< / span > < span class = "p" > ,< / span > < span class = "mi" > 2< / span > < span class = "p" > ,< / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span > < span class = "mi" > 5< / span > < span class = "p" > ,< / span > < span class = "mi" > 5< / span > < span class = "p" > ,< / span > < span class = "mi" > 5< / span > < span class = "p" > ,< / span > < span class = "mi" > 5< / span > < span class = "p" > ,< / span > < span class = "mi" > 8< / span > < span class = "p" > ,< / span > < span class = "mi" > 9< / span > < span class = "p" > ,< / span > < span class = "mi" > 10< / span > < span class = "p" > }};< / span >
< span class = "n" > SPROUT_STATIC_CONSTEXPR< / span > < span class = "k" > auto< / span > < span class = "n" > result< / span > < span class = "o" > =< / span > < span class = "n" > sprout< / span > < span class = "o" > ::< / span > < span class = "n" > equal_range< / span > < span class = "p" > (< / span > < span class = "n" > begin< / span > < span class = "p" > (< / span > < span class = "n" > input< / span > < span class = "p" > ),< / span > < span class = "n" > end< / span > < span class = "p" > (< / span > < span class = "n" > input< / span > < span class = "p" > ),< / span > < span class = "mi" > 5< / span > < span class = "p" > );< / span >
< span class = "n" > static_assert< / span > < span class = "p" > (< / span > < span class = "n" > result< / span > < span class = "p" > .< / span > < span class = "n" > first< / span > < span class = "o" > -< / span > < span class = "n" > begin< / span > < span class = "p" > (< / span > < span class = "n" > input< / span > < span class = "p" > )< / span > < span class = "o" > ==< / span > < span class = "mi" > 3< / span > < span class = "p" > ,< / span > < span class = "s" > " a lower bound position is 3." < / span > < span class = "p" > );< / span >
< span class = "n" > static_assert< / span > < span class = "p" > (< / span > < span class = "n" > result< / span > < span class = "p" > .< / span > < span class = "n" > second< / span > < span class = "o" > -< / span > < span class = "n" > begin< / span > < span class = "p" > (< / span > < span class = "n" > input< / span > < span class = "p" > )< / span > < span class = "o" > ==< / span > < span class = "mi" > 7< / span > < span class = "p" > ,< / span > < span class = "s" > " a upper bound position is 7." < / span > < span class = "p" > );< / span >
< span class = "n" > static_assert< / span > < span class = "p" > (< / span > < span class = "n" > sprout< / span > < span class = "o" > ::< / span > < span class = "n" > all_of_equal< / span > < span class = "p" > (< / span > < span class = "n" > result< / span > < span class = "p" > .< / span > < span class = "n" > first< / span > < span class = "p" > ,< / span > < span class = "n" > result< / span > < span class = "p" > .< / span > < span class = "n" > second< / span > < span class = "p" > .< / span > < span class = "mi" > 5< / span > < span class = "p" > ),< / span > < span class = "s" > " all of result range is equal to 5." < / span > < span class = "p" > );< / span >
< / pre > < / div >
< / div >
< / div >
< div class = "section" id = "complexity" >
< h2 > Complexity< a class = "headerlink" href = "#complexity" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "line-block" >
< div class = "line" > At most < tt class = "docutils literal" > < span class = "pre" > 2< / span > < span class = "pre" > *< / span > < span class = "pre" > log2(last< / span > < span class = "pre" > -< / span > < span class = "pre" > first)< / span > < span class = "pre" > +< / span > < span class = "pre" > O(1)< / span > < / tt > comparisons.< / div >
< div class = "line" > Recursive function invocations in < em > O(logN)< / em > (logarithmic) depth.< / div >
< / div >
< / div >
< div class = "section" id = "header" >
< h2 > Header< a class = "headerlink" href = "#header" title = "Permalink to this headline" > ¶< / a > < / h2 >
< div class = "line-block" >
< div class = "line" > < tt class = "docutils literal" > < span class = "pre" > sprout/algorithm/equal_range.hpp< / span > < / tt > < / div >
< div class = "line" > Convenience header: < tt class = "docutils literal" > < span class = "pre" > sprout/algorithm.hpp< / span > < / tt > < / div >
< / div >
< / div >
< / div >
< / div >
< / div >
< / div >
< div class = "clearer" > < / div >
< / div >
< div class = "related" >
< h3 > Navigation< / h3 >
< ul >
< li class = "right" style = "margin-right: 10px" >
< a href = "../../../genindex.html" title = "General Index"
>index< / a > < / li >
< li class = "right" >
< a href = "binary_search.html" title = "binary_search"
>next< / a > |< / li >
< li class = "right" >
< a href = "upper_bound.html" title = "upper_bound"
>previous< / a > |< / li >
2013-08-30 02:14:14 +00:00
< li > < a href = "../../../index.html" > Sprout 1.0 documentation< / a > » < / li >
2013-08-22 15:08:35 +00:00
< li > < a href = "../../index.html" > Sprout C++ Libraries< / a > » < / li >
< li > < a href = "../../libraries.html" > Libraries< / a > » < / li >
< li > < a href = "index.html" > Sprout.Algorithm< / a > » < / li >
< / ul >
< / div >
< div class = "footer" >
2013-08-30 02:14:14 +00:00
© Copyright 2013, Bolero MURAKAMI.
Created using < a href = "http://sphinx.pocoo.org/" > Sphinx< / a > 1.1.3.
2013-08-22 15:08:35 +00:00
< / div >
< / body >
< / html >
