osversion_windows.go 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. package osversion
  2. import (
  3. "fmt"
  4. "sync"
  5. "golang.org/x/sys/windows"
  6. )
  7. // OSVersion is a wrapper for Windows version information
  8. // https://msdn.microsoft.com/en-us/library/windows/desktop/ms724439(v=vs.85).aspx
  9. type OSVersion struct {
  10. Version uint32
  11. MajorVersion uint8
  12. MinorVersion uint8
  13. Build uint16
  14. }
  15. var (
  16. osv OSVersion
  17. once sync.Once
  18. )
  19. // Get gets the operating system version on Windows.
  20. // The calling application must be manifested to get the correct version information.
  21. func Get() OSVersion {
  22. once.Do(func() {
  23. var err error
  24. osv = OSVersion{}
  25. osv.Version, err = windows.GetVersion()
  26. if err != nil {
  27. // GetVersion never fails.
  28. panic(err)
  29. }
  30. osv.MajorVersion = uint8(osv.Version & 0xFF)
  31. osv.MinorVersion = uint8(osv.Version >> 8 & 0xFF)
  32. osv.Build = uint16(osv.Version >> 16)
  33. })
  34. return osv
  35. }
  36. // Build gets the build-number on Windows
  37. // The calling application must be manifested to get the correct version information.
  38. func Build() uint16 {
  39. return Get().Build
  40. }
  41. // String returns the OSVersion formatted as a string. It implements the
  42. // [fmt.Stringer] interface.
  43. func (osv OSVersion) String() string {
  44. return fmt.Sprintf("%d.%d.%d", osv.MajorVersion, osv.MinorVersion, osv.Build)
  45. }
  46. // ToString returns the OSVersion formatted as a string.
  47. //
  48. // Deprecated: use [OSVersion.String].
  49. func (osv OSVersion) ToString() string {
  50. return osv.String()
  51. }