mirror of
https://github.com/golang/go
synced 2024-11-07 13:46:19 -07:00
19309779ac
[This CL is part of a sequence implementing the proposal #51082. The design doc is at https://go.dev/s/godocfmt-design.] Run the updated gofmt, which reformats doc comments, on the main repository. Vendored files are excluded. For #51082. Change-Id: I7332f099b60f716295fb34719c98c04eb1a85407 Reviewed-on: https://go-review.googlesource.com/c/go/+/384268 Reviewed-by: Jonathan Amsterdam <jba@google.com> Reviewed-by: Ian Lance Taylor <iant@golang.org>
57 lines
1.9 KiB
Go
57 lines
1.9 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 strconv implements conversions to and from string representations
|
|
// of basic data types.
|
|
//
|
|
// # Numeric Conversions
|
|
//
|
|
// The most common numeric conversions are Atoi (string to int) and Itoa (int to string).
|
|
//
|
|
// i, err := strconv.Atoi("-42")
|
|
// s := strconv.Itoa(-42)
|
|
//
|
|
// These assume decimal and the Go int type.
|
|
//
|
|
// ParseBool, ParseFloat, ParseInt, and ParseUint convert strings to values:
|
|
//
|
|
// b, err := strconv.ParseBool("true")
|
|
// f, err := strconv.ParseFloat("3.1415", 64)
|
|
// i, err := strconv.ParseInt("-42", 10, 64)
|
|
// u, err := strconv.ParseUint("42", 10, 64)
|
|
//
|
|
// The parse functions return the widest type (float64, int64, and uint64),
|
|
// but if the size argument specifies a narrower width the result can be
|
|
// converted to that narrower type without data loss:
|
|
//
|
|
// s := "2147483647" // biggest int32
|
|
// i64, err := strconv.ParseInt(s, 10, 32)
|
|
// ...
|
|
// i := int32(i64)
|
|
//
|
|
// FormatBool, FormatFloat, FormatInt, and FormatUint convert values to strings:
|
|
//
|
|
// s := strconv.FormatBool(true)
|
|
// s := strconv.FormatFloat(3.1415, 'E', -1, 64)
|
|
// s := strconv.FormatInt(-42, 16)
|
|
// s := strconv.FormatUint(42, 16)
|
|
//
|
|
// AppendBool, AppendFloat, AppendInt, and AppendUint are similar but
|
|
// append the formatted value to a destination slice.
|
|
//
|
|
// # String Conversions
|
|
//
|
|
// Quote and QuoteToASCII convert strings to quoted Go string literals.
|
|
// The latter guarantees that the result is an ASCII string, by escaping
|
|
// any non-ASCII Unicode with \u:
|
|
//
|
|
// q := strconv.Quote("Hello, 世界")
|
|
// q := strconv.QuoteToASCII("Hello, 世界")
|
|
//
|
|
// QuoteRune and QuoteRuneToASCII are similar but accept runes and
|
|
// return quoted Go rune literals.
|
|
//
|
|
// Unquote and UnquoteChar unquote Go string and rune literals.
|
|
package strconv
|