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  package strconv
    57  

View as plain text