mirror of
https://github.com/golang/go
synced 2024-11-13 20:10:32 -07:00
519474451a
This is a subset of https://golang.org/cl/20022 with only the copyright header lines, so the next CL will be smaller and more reviewable. Go policy has been single space after periods in comments for some time. The copyright header template at: https://golang.org/doc/contribute.html#copyright also uses a single space. Make them all consistent. Change-Id: Icc26c6b8495c3820da6b171ca96a74701b4a01b0 Reviewed-on: https://go-review.googlesource.com/20111 Run-TryBot: Brad Fitzpatrick <bradfitz@golang.org> Reviewed-by: Ian Lance Taylor <iant@golang.org> Reviewed-by: Matthew Dempsky <mdempsky@google.com> TryBot-Result: Gobot Gobot <gobot@golang.org>
29 lines
1.1 KiB
Go
29 lines
1.1 KiB
Go
// Copyright 2015 The Go Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style
|
|
// license that can be found in the LICENSE file.
|
|
|
|
package strings
|
|
|
|
// Compare returns an integer comparing two strings lexicographically.
|
|
// The result will be 0 if a==b, -1 if a < b, and +1 if a > b.
|
|
//
|
|
// Compare is included only for symmetry with package bytes.
|
|
// It is usually clearer and always faster to use the built-in
|
|
// string comparison operators ==, <, >, and so on.
|
|
func Compare(a, b string) int {
|
|
// NOTE(rsc): This function does NOT call the runtime cmpstring function,
|
|
// because we do not want to provide any performance justification for
|
|
// using strings.Compare. Basically no one should use strings.Compare.
|
|
// As the comment above says, it is here only for symmetry with package bytes.
|
|
// If performance is important, the compiler should be changed to recognize
|
|
// the pattern so that all code doing three-way comparisons, not just code
|
|
// using strings.Compare, can benefit.
|
|
if a == b {
|
|
return 0
|
|
}
|
|
if a < b {
|
|
return -1
|
|
}
|
|
return +1
|
|
}
|