...

Source file src/strconv/doc.go

Documentation: 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 := 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