[#BloombergLP-bslalg-RbTreeUtil-leftmost-09]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslalg.adoc[bslalg]::xref:BloombergLP/bslalg/RbTreeUtil.adoc[RbTreeUtil]::leftmost
:relfileprefix: ../../../
:mrdocs:

Return the address of the leftmost node in the specified `subtree`&period;

== Synopsis

Declared in `&lt;bslalg&lowbar;rbtreeutil&period;h&gt;`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
xref:BloombergLP/bslalg/RbTreeNode.adoc[RbTreeNode] const*
leftmost(xref:BloombergLP/bslalg/RbTreeNode.adoc[RbTreeNode] const* subtree);
----

== Description

Return the address of the leftmost node in the specified `subtree`, and `subtree` if `subtree` has no left child&period; The behavior is undefined unless `0 !&equals; subtree`, and `subtree` refers to a valid binary tree&period; Note that the value held by the returned node will not compare greater than that of any other node in `subtree` (as determined by the comparator used to organize the red&hyphen;black subtree data)&period;

== Return Value

address of the leftmost node in `subtree`

== Parameters

[cols="1,4"]
|===
| Name| Description
| *subtree*
| root of the subtree to search
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#
