| # Constants |
| 25 Aug 2014 |
| Tags: constants |
| Summary: An introduction to constants in Go. |
| |
| Rob Pike |
| |
| ## Introduction |
| |
| Go is a statically typed language that does not permit operations that mix numeric types. |
| You can't add a `float64` to an `int`, or even an `int32` to an `int`. |
| Yet it is legal to write `1e6*time.Second` or `math.Exp(1)` or even `1<<('\t'+2.0)`. |
| In Go, constants, unlike variables, behave pretty much like regular numbers. |
| This post explains why that is and what it means. |
| |
| ## Background: C |
| |
| In the early days of thinking about Go, we talked about a number of problems |
| caused by the way C and its descendants let you mix and match numeric types. |
| Many mysterious bugs, crashes, and portability problems are caused by expressions |
| that combine integers of different sizes and "signedness". |
| Although to a seasoned C programmer the result of a calculation like |
| |
| unsigned int u = 1e9; |
| long signed int i = -1; |
| ... i + u ... |
| |
| may be familiar, it isn't _a priori_ obvious. |
| How big is the result? |
| What is its value? |
| Is it signed or unsigned? |
| |
| Nasty bugs lurk here. |
| |
| C has a set of rules called "the usual arithmetic conversions" and it is |
| an indicator of their subtlety that they have changed over the years (introducing |
| yet more bugs, retroactively). |
| |
| When designing Go, we decided to avoid this minefield by mandating that there is _no_ mixing of numeric types. |
| If you want to add `i` and `u`, you must be explicit about what you want the result to be. |
| Given |
| |
| var u uint |
| var i int |
| |
| you can write either `uint(i)+u` or `i+int(u)`, |
| with both the meaning and type of the addition clearly expressed, |
| but unlike in C you cannot write `i+u`. |
| You can't even mix `int` and `int32`, even when `int` is a 32-bit type. |
| |
| This strictness eliminates a common cause of bugs and other failures. |
| It is a vital property of Go. |
| But it has a cost: it sometimes requires programmers to decorate their code |
| with clumsy numeric conversions to express their meaning clearly. |
| |
| And what about constants? |
| Given the declarations above, what would make it legal to write `i` `=` `0` or `u` `=` `0`? |
| What is the _type_ of `0`? |
| It would be unreasonable to require constants to have type conversions in simple contexts such as `i` `=` `int(0)`. |
| |
| We soon realized the answer lay in making numeric constants work differently |
| from how they behave in other C-like languages. |
| After much thinking and experimentation, we came up with a design that we |
| believe feels right almost always, |
| freeing the programmer from converting constants all the time yet being |
| able to write things like `math.Sqrt(2)` without being chided by the compiler. |
| |
| In short, constants in Go just work, most of the time anyway. |
| Let's see how that happens. |
| |
| ## Terminology |
| |
| First, a quick definition. |
| In Go, `const` is a keyword introducing a name for a scalar value such as `2` or `3.14159` or `"scrumptious"`. |
| Such values, named or otherwise, are called _constants_ in Go. |
| Constants can also be created by expressions built from constants, |
| such as `2+3` or `2+3i` or `math.Pi/2` or `("go"+"pher")`. |
| |
| Some languages don't have constants, and others have a more general definition |
| of constant or application of the word `const`. |
| In C and C++, for instance, `const` is a type qualifier that can codify |
| more intricate properties of more intricate values. |
| |
| But in Go, a constant is just a simple, unchanging value, and from here on we're talking only about Go. |
| |
| ## String constants |
| |
| There are many kinds of numeric constants—integers, |
| floats, runes, signed, unsigned, imaginary, |
| complex—so let's start with a simpler form of constant: strings. |
| String constants are easy to understand and provide a smaller space in which |
| to explore the type issues of constants in Go. |
| |
| A string constant encloses some text between double quotes. |
| (Go also has raw string literals, enclosed by backquotes <code>``</code>, |
| but for the purpose of this discussion they have all the same properties.) |
| Here is a string constant: |
| |
| "Hello, 世界" |
| |
| (For much more detail about the representation and interpretation of strings, |
| see [this blog post](https://blog.golang.org/strings).) |
| |
| What type does this string constant have? |
| The obvious answer is `string`, but that is _wrong_. |
| |
| This is an _untyped string constant_, which is to say it is a constant textual |
| value that does not yet have a fixed type. |
| Yes, it's a string, but it's not a Go value of type `string`. |
| It remains an untyped string constant even when given a name: |
| |
| const hello = "Hello, 世界" |
| |
| After this declaration, `hello` is also an untyped string constant. |
| An untyped constant is just a value, one not yet given a defined type that |
| would force it to obey the strict rules that prevent combining differently typed values. |
| |
| It is this notion of an _untyped_ constant that makes it possible for us to use constants in Go with great freedom. |
| |
| So what, then, is a _typed_ string constant? |
| It's one that's been given a type, like this: |
| |
| const typedHello string = "Hello, 世界" |
| |
| Notice that the declaration of `typedHello` has an explicit `string` type before the equals sign. |
| This means that `typedHello` has Go type `string`, and cannot be assigned to a Go variable of a different type. |
| That is to say, this code works: |
| |
| .play -edit constants/string1.go /START/,/STOP/ |
| |
| but this does not: |
| |
| .play -edit constants/string2.go /START/,/STOP/ |
| |
| The variable `m` has type `MyString` and cannot be assigned a value of a different type. |
| It can only be assigned values of type `MyString`, like this: |
| |
| .play -edit constants/string3.go /START/,/STOP/ |
| |
| or by forcing the issue with a conversion, like this: |
| |
| .play -edit constants/string4.go /START/,/STOP/ |
| |
| Returning to our _untyped_ string constant, |
| it has the helpful property that, since it has no type, |
| assigning it to a typed variable does not cause a type error. |
| That is, we can write |
| |
| m = "Hello, 世界" |
| |
| or |
| |
| m = hello |
| |
| because, unlike the typed constants `typedHello` and `myStringHello`, |
| the untyped constants `"Hello, 世界"` and `hello` _have no type_. |
| Assigning them to a variable of any type compatible with strings works without error. |
| |
| These untyped string constants are strings, |
| of course, so they can only be used where a string is allowed, |
| but they do not have _type_ `string`. |
| |
| ## Default type |
| |
| As a Go programmer, you have certainly seen many declarations like |
| |
| str := "Hello, 世界" |
| |
| and by now you might be asking, "if the constant is untyped, how does `str` get a type in this variable declaration?" |
| The answer is that an untyped constant has a default type, |
| an implicit type that it transfers to a value if a type is needed where none is provided. |
| For untyped string constants, that default type is obviously `string`, so |
| |
| str := "Hello, 世界" |
| |
| or |
| |
| var str = "Hello, 世界" |
| |
| means exactly the same as |
| |
| var str string = "Hello, 世界" |
| |
| One way to think about untyped constants is that they live in a kind of |
| ideal space of values, |
| a space less restrictive than Go's full type system. |
| But to do anything with them, we need to assign them to variables, |
| and when that happens the _variable_ (not the constant itself) needs a type, |
| and the constant can tell the variable what type it should have. |
| In this example, `str` becomes a value of type `string` because the untyped |
| string constant gives the declaration its default type, `string`. |
| |
| In such a declaration, a variable is declared with a type and initial value. |
| Sometimes when we use a constant, however, the destination of the value is not so clear. |
| For instance consider this statement: |
| |
| .play -edit constants/default1.go /START/,/STOP/ |
| |
| The signature of `fmt.Printf` is |
| |
| func Printf(format string, a ...interface{}) (n int, err error) |
| |
| which is to say its arguments (after the format string) are interface values. |
| What happens when `fmt.Printf` is called with an untyped constant is that an interface value is created |
| to pass as an argument, and the concrete type stored for that argument is the default type of the constant. |
| This process is analogous to what we saw earlier when declaring an initialized value using an untyped string constant. |
| |
| You can see the result in this example, which uses the format `%v` to print |
| the value and `%T` to print the type of the value being passed to `fmt.Printf`: |
| |
| .play -edit constants/default2.go /START/,/STOP/ |
| |
| If the constant has a type, that goes into the interface, as this example shows: |
| |
| .play -edit constants/default3.go /START/,/STOP/ |
| |
| (For more information about how interface values work, |
| see the first sections of [this blog post](https://blog.golang.org/laws-of-reflection).) |
| |
| In summary, a typed constant obeys all the rules of typed values in Go. |
| On the other hand, an untyped constant does not carry a Go type in the same |
| way and can be mixed and matched more freely. |
| It does, however, have a default type that is exposed when, and only when, no other type information is available. |
| |
| ## Default type determined by syntax |
| |
| The default type of an untyped constant is determined by its syntax. |
| For string constants, the only possible implicit type is `string`. |
| For [numeric constants](https://golang.org/ref/spec#Numeric_types), the implicit type has more variety. |
| Integer constants default to `int`, floating-point constants `float64`, |
| rune constants to `rune` (an alias for `int32`), |
| and imaginary constants to `complex128`. |
| Here's our canonical print statement used repeatedly to show the default types in action: |
| |
| .play -edit constants/syntax.go /START/,/STOP/ |
| |
| (Exercise: Explain the result for `'x'`.) |
| |
| ## Booleans |
| |
| Everything we said about untyped string constants can be said for untyped boolean constants. |
| The values `true` and `false` are untyped boolean constants that can be assigned to any boolean variable, |
| but once given a type, boolean variables cannot be mixed: |
| |
| .play -edit constants/bool.go /START/,/STOP/ |
| |
| Run the example and see what happens, then comment out the "Bad" line and run it again. |
| The pattern here follows exactly that of string constants. |
| |
| ## Floats |
| |
| Floating-point constants are just like boolean constants in most respects. |
| Our standard example works as expected in translation: |
| |
| .play -edit constants/float1.go /START/,/STOP/ |
| |
| One wrinkle is that there are _two_ floating-point types in Go: `float32` and `float64`. |
| The default type for a floating-point constant is `float64`, although an untyped floating-point |
| constant can be assigned to a `float32` value just fine: |
| |
| .play -edit constants/float2.go /START/,/STOP/ |
| |
| Floating-point values are a good place to introduce the concept of overflow, or the range of values. |
| |
| Numeric constants live in an arbitrary-precision numeric space; they are just regular numbers. |
| But when they are assigned to a variable the value must be able to fit in the destination. |
| We can declare a constant with a very large value: |
| |
| .code constants/float3.go /Huge/ |
| |
| —that's just a number, after all—but we can't assign it or even print it. This statement won't even compile: |
| |
| .play -edit constants/float3.go /Println/ |
| |
| The error is, "constant 1.00000e+1000 overflows float64", which is true. |
| But `Huge` might be useful: we can use it in expressions with other constants |
| and use the value of those expressions if the result |
| can be represented in the range of a `float64`. |
| The statement, |
| |
| .play -edit constants/float4.go /Println/ |
| |
| prints `10`, as one would expect. |
| |
| In a related way, floating-point constants may have very high precision, |
| so that arithmetic involving them is more accurate. |
| The constants defined in the [math](https://golang.org/pkg/math) package are given with many more digits than are |
| available in a `float64`. Here is the definition of `math.Pi`: |
| |
| Pi = 3.14159265358979323846264338327950288419716939937510582097494459 |
| |
| When that value is assigned to a variable, |
| some of the precision will be lost; |
| the assignment will create the `float64` (or `float32`) |
| value closest to the high-precision value. This snippet |
| |
| .play -edit constants/float5.go /START/,/STOP/ |
| |
| prints `3.141592653589793`. |
| |
| Having so many digits available means that calculations like `Pi/2` or other |
| more intricate evaluations can carry more precision |
| until the result is assigned, making calculations involving constants easier to write without losing precision. |
| It also means that there is no occasion in which the floating-point corner cases like infinities, |
| soft underflows, and `NaNs` arise in constant expressions. |
| (Division by a constant zero is a compile-time error, |
| and when everything is a number there's no such thing as "not a number".) |
| |
| ## Complex numbers |
| |
| Complex constants behave a lot like floating-point constants. |
| Here's a version of our now-familiar litany translated into complex numbers: |
| |
| .play -edit constants/complex1.go /START/,/STOP/ |
| |
| The default type of a complex number is `complex128`, the larger-precision version composed of two `float64` values. |
| |
| For clarity in our example, we wrote out the full expression `(0.0+1.0i)`, |
| but this value can be shortened to `0.0+1.0i`, |
| `1.0i` or even `1i`. |
| |
| Let's play a trick. |
| We know that in Go, a numeric constant is just a number. |
| What if that number is a complex number with no imaginary part, that is, a real? |
| Here's one: |
| |
| .code constants/complex2.go /const Two/ |
| |
| That's an untyped complex constant. |
| Even though it has no imaginary part, the _syntax_ of the expression defines it to have default type `complex128`. |
| Therefore, if we use it to declare a variable, the default type will be `complex128`. The snippet |
| |
| .play -edit constants/complex2.go /START/,/STOP/ |
| |
| prints `complex128:` `(2+0i)`. |
| But numerically, `Two` can be stored in a scalar floating-point number, |
| a `float64` or `float32`, with no loss of information. |
| Thus we can assign `Two` to a `float64`, either in an initialization or an assignment, without problems: |
| |
| .play -edit constants/complex3.go /START/,/STOP/ |
| |
| The output is `2` `and` `2`. |
| Even though `Two` is a complex constant, it can be assigned to scalar floating-point variables. |
| This ability for a constant to "cross" types like this will prove useful. |
| |
| ## Integers |
| |
| At last we come to integers. |
| They have more moving parts—[many sizes, signed or unsigned, and more](https://golang.org/ref/spec#Numeric_types)—but |
| they play by the same rules. |
| For the last time, here is our familiar example, using just `int` this time: |
| |
| .play -edit constants/int1.go /START/,/STOP/ |
| |
| The same example could be built for any of the integer types, which are: |
| |
| int int8 int16 int32 int64 |
| uint uint8 uint16 uint32 uint64 |
| uintptr |
| |
| (plus the aliases `byte` for `uint8` and `rune` for `int32`). |
| That's a lot, but the pattern in the way constants work should be familiar |
| enough by now that you can see how things will play out. |
| |
| As mentioned above, integers come in a couple of forms and each form has |
| its own default type: |
| `int` for simple constants like `123` or `0xFF` or `-14` |
| and `rune` for quoted characters like 'a', '世' or '\r'. |
| |
| No constant form has as its default type an unsigned integer type. |
| However, the flexibility of untyped constants means we can initialize unsigned |
| integer variables using simple constants as long as we are clear about the type. |
| It's analogous to how we can initialize a `float64` using a complex number with zero imaginary part. |
| Here are several different ways to initialize a `uint`; |
| all are equivalent, but all must mention the type explicitly for the result to be unsigned. |
| |
| var u uint = 17 |
| var u = uint(17) |
| u := uint(17) |
| |
| Similarly to the range issue mentioned in the section on floating-point values, |
| not all integer values can fit in all integer types. |
| There are two problems that might arise: the value might be too large, |
| or it might be a negative value being assigned to an unsigned integer type. |
| For instance, `int8` has range -128 through 127, |
| so constants outside of that range can never be assigned to a variable of type `int8`: |
| |
| .play -edit constants/int2.go /var/ |
| |
| Similarly, `uint8`, also known as `byte`, |
| has range 0 through 255, so a large or negative constant cannot be assigned to a `uint8`: |
| |
| .play -edit constants/int3.go /var/ |
| |
| This type-checking can catch mistakes like this one: |
| |
| .play -edit constants/int4.go /START/,/STOP/ |
| |
| If the compiler complains about your use of a constant, it's likely a real bug like this. |
| |
| ## An exercise: The largest unsigned int |
| |
| Here is an informative little exercise. |
| How do we express a constant representing the largest value that fits in a `uint`? |
| If we were talking about `uint32` rather than `uint`, we could write |
| |
| const MaxUint32 = 1<<32 - 1 |
| |
| but we want `uint`, not `uint32`. |
| The `int` and `uint` types have equal unspecified numbers of bits, either 32 or 64. |
| Since the number of bits available depends on the architecture, we can't just write down a single value. |
| |
| Fans of [two's-complement arithmetic](http://en.wikipedia.org/wiki/Two's_complement), |
| which Go's integers are defined to use, know that the representation of `-1` has all its bits set to 1, |
| so the bit pattern of `-1` is internally the same as that of the |
| largest unsigned integer. |
| We therefore might think we could write |
| |
| .play -edit constants/exercise1.go /const/ |
| |
| but that is illegal because -1 cannot be represented by an unsigned variable; |
| `-1` is not in the range of unsigned values. |
| A conversion won't help either, for the same reason: |
| |
| .play -edit constants/exercise2.go /const/ |
| |
| Even though at run-time a value of -1 can be converted to an unsigned integer, the rules |
| for constant [conversions](https://golang.org/ref/spec#Conversions) forbid this kind of coercion at compile time. |
| That is to say, this works: |
| |
| .play -edit constants/exercise3.go /START/,/STOP/ |
| |
| but only because `v` is a variable; if we made `v` a constant, |
| even an untyped constant, we'd be back in forbidden territory: |
| |
| .play -edit constants/exercise4.go /START/,/STOP/ |
| |
| We return to our previous approach, but instead of `-1` we try `^0`, |
| the bitwise negation of an arbitrary number of zero bits. |
| But that fails too, for a similar reason: |
| In the space of numeric values, |
| `^0` represents an infinite number of ones, so we lose information if we assign that to any fixed-size integer: |
| |
| .play -edit constants/exercise5.go /const/ |
| |
| How then do we represent the largest unsigned integer as a constant? |
| |
| The key is to constrain the operation to the number of bits in a `uint` and avoiding |
| values, such as negative numbers, that are not representable in a `uint`. |
| The simplest `uint` value is the typed constant `uint(0)`. |
| If `uints` have 32 or 64 bits, `uint(0)` has 32 or 64 zero bits accordingly. |
| If we invert each of those bits, we'll get the correct number of one bits, which is the largest `uint` value. |
| |
| Therefore we don't flip the bits of the untyped constant `0`, we flip the bits of the typed constant `uint(0)`. |
| Here, then, is our constant: |
| |
| .play -edit constants/exercise6.go /START/,/STOP/ |
| |
| Whatever the number of bits it takes to represent a `uint` in the current execution environment |
| (on the [playground](https://blog.golang.org/playground), it's 32), |
| this constant correctly represents the largest value a variable of type `uint` can hold. |
| |
| If you understand the analysis that got us to this result, |
| you understand all the important points about constants in Go. |
| |
| ## Numbers |
| |
| The concept of untyped constants in Go means that all the numeric constants, |
| whether integer, floating-point, complex, |
| or even character values, |
| live in a kind of unified space. |
| It's when we bring them to the computational world of variables, |
| assignments, and operations that the actual types matter. |
| But as long as we stay in the world of numeric constants, we can mix and match values as we like. |
| All these constants have numeric value 1: |
| |
| 1 |
| 1.000 |
| 1e3-99.0*10-9 |
| '\x01' |
| '\u0001' |
| 'b' - 'a' |
| 1.0+3i-3.0i |
| |
| Therefore, although they have different implicit default types, |
| written as untyped constants they can be assigned to a variable of any integer type: |
| |
| .play -edit constants/numbers1.go /START/,/STOP/ |
| |
| The output from this snippet is: `1 1 1 1 1 (1+0i) 1`. |
| |
| You can even do nutty stuff like |
| |
| .play -edit constants/numbers2.go /START/,/STOP/ |
| |
| which yields 145.5, which is pointless except to prove a point. |
| |
| But the real point of these rules is flexibility. |
| That flexibility means that, despite the fact that in Go it is illegal in |
| the same expression to mix floating-point and integer variables, |
| or even `int` and `int32` variables, it is fine to write |
| |
| sqrt2 := math.Sqrt(2) |
| |
| or |
| |
| const millisecond = time.Second/1e3 |
| |
| or |
| |
| bigBufferWithHeader := make([]byte, 512+1e6) |
| |
| and have the results mean what you expect. |
| |
| Because in Go, numeric constants work as you expect: like numbers. |