...

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	

View as plain text