Files
astronomy/source/kotlin/doc/next-global-solar-eclipse.md
Don Cross 5676049596 Kotlin: added iterator helper functions
Added the following iterator functions that wrap
search/next pairs of functions:

    globalSolarEclipsesAfter
    localSolarEclipsesAfter
    lunarApsidesAfter
    lunarEclipsesAfter
    moonNodesAfter
    moonQuartersAfter
    planetApsidesAfter
    transitsAfter

I updated the following Kotlin demos:

    MoonPhase.kt    ==> moonQuartersAfter
    LunarEclipse.kt ==> lunarEclipsesAfter

However, I have not yet figured out how to use these
functions in the corresponding Java demos.
2022-05-06 21:52:27 -04:00

22 lines
1.1 KiB
Markdown

//[astronomy](../../index.md)/[io.github.cosinekitty.astronomy](index.md)/[nextGlobalSolarEclipse](next-global-solar-eclipse.md)
# nextGlobalSolarEclipse
fun [nextGlobalSolarEclipse](next-global-solar-eclipse.md)(prevEclipseTime: [Time](-time/index.md)): [GlobalSolarEclipseInfo](-global-solar-eclipse-info/index.md)
Searches for the next global solar eclipse in a series.
After using [searchGlobalSolarEclipse](search-global-solar-eclipse.md) to find the first solar eclipse in a series, you can call this function to find the next consecutive solar eclipse. Pass in the peak value from the [GlobalSolarEclipseInfo](-global-solar-eclipse-info/index.md) returned by the previous call to searchGlobalSolarEclipse or nextGlobalSolarEclipse to find the next solar eclipse.
See [globalSolarEclipsesAfter](global-solar-eclipses-after.md) for convenient iteration of consecutive eclipses.
#### Return
Information about the next consecutive solar eclipse.
## Parameters
| | |
|---|---|
| prevEclipseTime | A date and time near a new moon. Solar eclipse search will start at the next new moon. |