github.com/shogo82148/std@v1.22.1-0.20240327122250-4e474527810c/go/version/version.go (about)

     1  // Copyright 2023 The Go Authors. All rights reserved.
     2  // Use of this source code is governed by a BSD-style
     3  // license that can be found in the LICENSE file.
     4  
     5  // パッケージversionは、[Goツールチェーン名の構文] のような文字列、
     6  // つまり "go1.20"、"go1.21.0"、"go1.22rc2"、"go1.23.4-bigcorp"などの
     7  // [Goバージョン] に対する操作を提供します。
     8  //
     9  // [Goバージョン]: https://go.dev/doc/toolchain#version
    10  // [Goツールチェーン名の構文]: https://go.dev/doc/toolchain#name
    11  package version
    12  
    13  // Langは、バージョンxのGo言語バージョンを返します。
    14  // もしxが有効なバージョンでない場合、Langは空の文字列を返します。
    15  // 例えば：
    16  //
    17  //	Lang("go1.21rc2") = "go1.21"
    18  //	Lang("go1.21.2") = "go1.21"
    19  //	Lang("go1.21") = "go1.21"
    20  //	Lang("go1") = "go1"
    21  //	Lang("bad") = ""
    22  //	Lang("1.21") = ""
    23  func Lang(x string) string
    24  
    25  // Compareは、x < y、x == y、またはx > yの場合にそれぞれ-1、0、または+1を返します。
    26  // これはGoのバージョンとして解釈されます。
    27  // バージョンxとyは"go"プレフィックスで始まる必要があります："go1.21"であり、"1.21"ではありません。
    28  // 無効なバージョン、空文字列を含む、は有効なバージョンよりも小さく、
    29  // お互いに等しいと比較されます。
    30  // 言語バージョン"go1.21"はリリース候補および最終リリース"go1.21rc1"および"go1.21.0"よりも小さいと比較されます。
    31  func Compare(x, y string) int
    32  
    33  // IsValidは、バージョンxが有効かどうかを報告します。
    34  func IsValid(x string) bool