Source file src/strconv/doc.go
1 // Copyright 2015 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 // Package strconv implements conversions to and from string representations 6 // of basic data types. 7 // 8 // Numeric Conversions 9 // 10 // The most common numeric conversions are Atoi (string to int) and Itoa (int to string). 11 // 12 // i, err := strconv.Atoi("-42") 13 // s := strconv.Itoa(-42) 14 // 15 // These assume decimal and the Go int type. 16 // 17 // ParseBool, ParseFloat, ParseInt, and ParseUint convert strings to values: 18 // 19 // b, err := strconv.ParseBool("true") 20 // f, err := strconv.ParseFloat("3.1415", 64) 21 // i, err := strconv.ParseInt("-42", 10, 64) 22 // u, err := strconv.ParseUint("42", 10, 64) 23 // 24 // The parse functions return the widest type (float64, int64, and uint64), 25 // but if the size argument specifies a narrower width the result can be 26 // converted to that narrower type without data loss: 27 // 28 // s := "2147483647" // biggest int32 29 // i64, err := strconv.ParseInt(s, 10, 32) 30 // ... 31 // i := int32(i64) 32 // 33 // FormatBool, FormatFloat, FormatInt, and FormatUint convert values to strings: 34 // 35 // s := strconv.FormatBool(true) 36 // s := strconv.FormatFloat(3.1415, 'E', -1, 64) 37 // s := strconv.FormatInt(-42, 16) 38 // s := strconv.FormatUint(42, 16) 39 // 40 // AppendBool, AppendFloat, AppendInt, and AppendUint are similar but 41 // append the formatted value to a destination slice. 42 // 43 // String Conversions 44 // 45 // Quote and QuoteToASCII convert strings to quoted Go string literals. 46 // The latter guarantees that the result is an ASCII string, by escaping 47 // any non-ASCII Unicode with \u: 48 // 49 // q := strconv.Quote("Hello, 世界") 50 // q := strconv.QuoteToASCII("Hello, 世界") 51 // 52 // QuoteRune and QuoteRuneToASCII are similar but accept runes and 53 // return quoted Go rune literals. 54 // 55 // Unquote and UnquoteChar unquote Go string and rune literals. 56 // 57 package strconv 58