[#BloombergLP-baltzo-ZoneinfoUtil-loadRelevantTransitions]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/baltzo.adoc[baltzo]::xref:BloombergLP/baltzo/ZoneinfoUtil.adoc[ZoneinfoUtil]::loadRelevantTransitions
:relfileprefix: ../../../
:mrdocs:

Load the transitions that apply to `localTime` in `timeZone`.

== Synopsis

Declared in `<baltzo_zoneinfoutil.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
static
void
loadRelevantTransitions(
    xref:BloombergLP/baltzo/Zoneinfo/TransitionConstIterator.adoc[Zoneinfo::TransitionConstIterator]* firstResultTransition,
    xref:BloombergLP/baltzo/Zoneinfo/TransitionConstIterator.adoc[Zoneinfo::TransitionConstIterator]* secondResultTransition,
    xref:BloombergLP/baltzo/LocalTimeValidity/Enum.adoc[LocalTimeValidity::Enum]* resultValidity,
    xref:BloombergLP/bdlt/Datetime.adoc[bdlt::Datetime] const& localTime,
    xref:BloombergLP/baltzo/Zoneinfo.adoc[Zoneinfo] const& timeZone);
----

== Description

Load, into the specified `firstResultTransition`, an iterator referring to the transition describing the characteristics of local time in effect at the specified `localTime` in the specified `timeZone`; in instances where `localTime` is not both a unique and valid local time in `timeZone`, load, into the specified `secondResultTransition`, an iterator referring to a subsequent transition describing the alternative characteristics of local time that could also apply to `localTime`; finally load, into the specified `resultValidity`, the validity of `localTime` as being unique, ambiguous but valid, or invalid. If `resultValidity` is `e_VALID_UNIQUE`, then `firstResultTransition` and `secondResultTransition` will be loaded with the same transition, otherwise the returned transitions will be distinct with `secondResultTransition` referring to the transition immediately after `firstResultTransition`. The behavior is undefined unless `isWellFormed(timeZone)` is `true`, and `firstResultTransition != secondResultTransition`.

== Parameters

[cols="1,4"]
|===
| Name| Description
| *firstResultTransition*
| receives the transition in effect
| *secondResultTransition*
| receives the alternative transition
| *resultValidity*
| receives uniqueness or validity of `localTime`
| *localTime*
| local date‐time whose transitions are requested
| *timeZone*
| time zone used to interpret `localTime`
|===


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