Home | History | Annotate | Download | only in strconv
      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 := Quote("Hello, ")
     50 //	q := 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