// 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