/// <summary>
/// Gets whether two <see cref="DevEnv"/> values generate ABI-compatible binaries with
/// their respective C++ compiler.
/// </summary>
/// <param name="devEnv">The <see cref="DevEnv"/> to check for ABI-compatibility.</param>
/// <param name="other">The other <see cref="DevEnv"/> to check for ABI-compatibility with.</param>
/// <returns>`true` if ABI-compatible, `false` otherwise.</returns>
/// <exception cref="ArgumentException"><paramref name="devEnv"/> is not a Visual Studio version.</exception>
/// <remarks>
/// Only works for Visual Studio versions because other DevEnvs (such as Eclipse) are not
/// shipped with a compiler version.
/// </remarks>
public static bool IsAbiCompatibleWith(this DevEnv devEnv, DevEnv other)
{
if (!devEnv.IsVisualStudio())
{
throw new ArgumentException($"{devEnv} is not a Visual Studio DevEnv.");
}
// a VS version is obviously compatible with itself (identity check)
if (devEnv == other)
{
return(true);
}
// VS2017 and VS2019 are guaranteed by Microsoft to be ABI-compatible with VS2015 for C++.
if (devEnv.IsAbiCompatibleWithVS2015() && other.IsAbiCompatibleWithVS2015())
{
return(true);
}
return(false);
}