90d03d7926
This change is an implementation of [RFC 69][rfc] which adds a third kind of global to the language, `const`. This global is most similar to what the old `static` was, and if you're unsure about what to use then you should use a `const`. The semantics of these three kinds of globals are: * A `const` does not represent a memory location, but only a value. Constants are translated as rvalues, which means that their values are directly inlined at usage location (similar to a #define in C/C++). Constant values are, well, constant, and can not be modified. Any "modification" is actually a modification to a local value on the stack rather than the actual constant itself. Almost all values are allowed inside constants, whether they have interior mutability or not. There are a few minor restrictions listed in the RFC, but they should in general not come up too often. * A `static` now always represents a memory location (unconditionally). Any references to the same `static` are actually a reference to the same memory location. Only values whose types ascribe to `Sync` are allowed in a `static`. This restriction is in place because many threads may access a `static` concurrently. Lifting this restriction (and allowing unsafe access) is a future extension not implemented at this time. * A `static mut` continues to always represent a memory location. All references to a `static mut` continue to be `unsafe`. This is a large breaking change, and many programs will need to be updated accordingly. A summary of the breaking changes is: * Statics may no longer be used in patterns. Statics now always represent a memory location, which can sometimes be modified. To fix code, repurpose the matched-on-`static` to a `const`. static FOO: uint = 4; match n { FOO => { /* ... */ } _ => { /* ... */ } } change this code to: const FOO: uint = 4; match n { FOO => { /* ... */ } _ => { /* ... */ } } * Statics may no longer refer to other statics by value. Due to statics being able to change at runtime, allowing them to reference one another could possibly lead to confusing semantics. If you are in this situation, use a constant initializer instead. Note, however, that statics may reference other statics by address, however. * Statics may no longer be used in constant expressions, such as array lengths. This is due to the same restrictions as listed above. Use a `const` instead. [breaking-change] [rfc]: https://github.com/rust-lang/rfcs/pull/246
228 lines
7.8 KiB
Rust
228 lines
7.8 KiB
Rust
// Copyright 2012-2013 The Rust Project Developers. See the COPYRIGHT
|
|
// file at the top-level directory of this distribution and at
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
// option. This file may not be copied, modified, or distributed
|
|
// except according to those terms.
|
|
|
|
|
|
use middle::def::*;
|
|
use middle::ty;
|
|
use middle::typeck;
|
|
use util::ppaux;
|
|
|
|
use syntax::ast::*;
|
|
use syntax::ast_util;
|
|
use syntax::visit::Visitor;
|
|
use syntax::visit;
|
|
|
|
struct CheckCrateVisitor<'a, 'tcx: 'a> {
|
|
tcx: &'a ty::ctxt<'tcx>,
|
|
in_const: bool
|
|
}
|
|
|
|
impl<'a, 'tcx> CheckCrateVisitor<'a, 'tcx> {
|
|
fn with_const(&mut self, in_const: bool, f: |&mut CheckCrateVisitor<'a, 'tcx>|) {
|
|
let was_const = self.in_const;
|
|
self.in_const = in_const;
|
|
f(self);
|
|
self.in_const = was_const;
|
|
}
|
|
fn inside_const(&mut self, f: |&mut CheckCrateVisitor<'a, 'tcx>|) {
|
|
self.with_const(true, f);
|
|
}
|
|
fn outside_const(&mut self, f: |&mut CheckCrateVisitor<'a, 'tcx>|) {
|
|
self.with_const(false, f);
|
|
}
|
|
}
|
|
|
|
impl<'a, 'tcx, 'v> Visitor<'v> for CheckCrateVisitor<'a, 'tcx> {
|
|
fn visit_item(&mut self, i: &Item) {
|
|
check_item(self, i);
|
|
}
|
|
fn visit_pat(&mut self, p: &Pat) {
|
|
check_pat(self, p);
|
|
}
|
|
fn visit_expr(&mut self, ex: &Expr) {
|
|
if check_expr(self, ex) {
|
|
visit::walk_expr(self, ex);
|
|
}
|
|
}
|
|
}
|
|
|
|
pub fn check_crate(tcx: &ty::ctxt) {
|
|
visit::walk_crate(&mut CheckCrateVisitor { tcx: tcx, in_const: false },
|
|
tcx.map.krate());
|
|
tcx.sess.abort_if_errors();
|
|
}
|
|
|
|
fn check_item(v: &mut CheckCrateVisitor, it: &Item) {
|
|
match it.node {
|
|
ItemStatic(_, _, ref ex) |
|
|
ItemConst(_, ref ex) => {
|
|
v.inside_const(|v| v.visit_expr(&**ex));
|
|
}
|
|
ItemEnum(ref enum_definition, _) => {
|
|
for var in (*enum_definition).variants.iter() {
|
|
for ex in var.node.disr_expr.iter() {
|
|
v.inside_const(|v| v.visit_expr(&**ex));
|
|
}
|
|
}
|
|
}
|
|
_ => v.outside_const(|v| visit::walk_item(v, it))
|
|
}
|
|
}
|
|
|
|
fn check_pat(v: &mut CheckCrateVisitor, p: &Pat) {
|
|
fn is_str(e: &Expr) -> bool {
|
|
match e.node {
|
|
ExprBox(_, ref expr) => {
|
|
match expr.node {
|
|
ExprLit(ref lit) => ast_util::lit_is_str(&**lit),
|
|
_ => false,
|
|
}
|
|
}
|
|
_ => false,
|
|
}
|
|
}
|
|
match p.node {
|
|
// Let through plain ~-string literals here
|
|
PatLit(ref a) => if !is_str(&**a) { v.inside_const(|v| v.visit_expr(&**a)); },
|
|
PatRange(ref a, ref b) => {
|
|
if !is_str(&**a) { v.inside_const(|v| v.visit_expr(&**a)); }
|
|
if !is_str(&**b) { v.inside_const(|v| v.visit_expr(&**b)); }
|
|
}
|
|
_ => v.outside_const(|v| visit::walk_pat(v, p))
|
|
}
|
|
}
|
|
|
|
fn check_expr(v: &mut CheckCrateVisitor, e: &Expr) -> bool {
|
|
if !v.in_const { return true }
|
|
|
|
match e.node {
|
|
ExprUnary(UnDeref, _) => {}
|
|
ExprUnary(UnUniq, _) => {
|
|
span_err!(v.tcx.sess, e.span, E0010,
|
|
"cannot do allocations in constant expressions");
|
|
return false;
|
|
}
|
|
ExprLit(ref lit) if ast_util::lit_is_str(&**lit) => {}
|
|
ExprBinary(..) | ExprUnary(..) => {
|
|
let method_call = typeck::MethodCall::expr(e.id);
|
|
if v.tcx.method_map.borrow().contains_key(&method_call) {
|
|
span_err!(v.tcx.sess, e.span, E0011,
|
|
"user-defined operators are not allowed in constant \
|
|
expressions");
|
|
}
|
|
}
|
|
ExprLit(_) => (),
|
|
ExprCast(_, _) => {
|
|
let ety = ty::expr_ty(v.tcx, e);
|
|
if !ty::type_is_numeric(ety) && !ty::type_is_unsafe_ptr(ety) {
|
|
span_err!(v.tcx.sess, e.span, E0012,
|
|
"can not cast to `{}` in a constant expression",
|
|
ppaux::ty_to_string(v.tcx, ety));
|
|
}
|
|
}
|
|
ExprPath(ref pth) => {
|
|
// NB: In the future you might wish to relax this slightly
|
|
// to handle on-demand instantiation of functions via
|
|
// foo::<bar> in a const. Currently that is only done on
|
|
// a path in trans::callee that only works in block contexts.
|
|
if !pth.segments.iter().all(|segment| segment.types.is_empty()) {
|
|
span_err!(v.tcx.sess, e.span, E0013,
|
|
"paths in constants may only refer to items without \
|
|
type parameters");
|
|
}
|
|
match v.tcx.def_map.borrow().find(&e.id) {
|
|
Some(&DefStatic(..)) |
|
|
Some(&DefConst(..)) |
|
|
Some(&DefFn(..)) |
|
|
Some(&DefVariant(_, _, _)) |
|
|
Some(&DefStruct(_)) => { }
|
|
|
|
Some(&def) => {
|
|
debug!("(checking const) found bad def: {:?}", def);
|
|
span_err!(v.tcx.sess, e.span, E0014,
|
|
"paths in constants may only refer to constants \
|
|
or functions");
|
|
}
|
|
None => {
|
|
v.tcx.sess.span_bug(e.span, "unbound path in const?!");
|
|
}
|
|
}
|
|
}
|
|
ExprCall(ref callee, _) => {
|
|
match v.tcx.def_map.borrow().find(&callee.id) {
|
|
Some(&DefStruct(..)) |
|
|
Some(&DefVariant(..)) => {} // OK.
|
|
|
|
_ => {
|
|
span_err!(v.tcx.sess, e.span, E0015,
|
|
"function calls in constants are limited to \
|
|
struct and enum constructors");
|
|
}
|
|
}
|
|
}
|
|
ExprBlock(ref block) => {
|
|
// Check all statements in the block
|
|
for stmt in block.stmts.iter() {
|
|
let block_span_err = |span|
|
|
span_err!(v.tcx.sess, span, E0016,
|
|
"blocks in constants are limited to items and \
|
|
tail expressions");
|
|
match stmt.node {
|
|
StmtDecl(ref span, _) => {
|
|
match span.node {
|
|
DeclLocal(_) => block_span_err(span.span),
|
|
|
|
// Item statements are allowed
|
|
DeclItem(_) => {}
|
|
}
|
|
}
|
|
StmtExpr(ref expr, _) => block_span_err(expr.span),
|
|
StmtSemi(ref semi, _) => block_span_err(semi.span),
|
|
StmtMac(..) => {
|
|
v.tcx.sess.span_bug(e.span, "unexpanded statement \
|
|
macro in const?!")
|
|
}
|
|
}
|
|
}
|
|
match block.expr {
|
|
Some(ref expr) => { check_expr(v, &**expr); }
|
|
None => {}
|
|
}
|
|
}
|
|
ExprVec(_) |
|
|
ExprAddrOf(MutImmutable, _) |
|
|
ExprParen(..) |
|
|
ExprField(..) |
|
|
ExprTupField(..) |
|
|
ExprIndex(..) |
|
|
ExprTup(..) |
|
|
ExprRepeat(..) |
|
|
ExprStruct(..) => {}
|
|
|
|
ExprAddrOf(_, ref inner) => {
|
|
match inner.node {
|
|
// Mutable slices are allowed.
|
|
ExprVec(_) => {}
|
|
_ => span_err!(v.tcx.sess, e.span, E0017,
|
|
"references in constants may only refer \
|
|
to immutable values")
|
|
|
|
}
|
|
}
|
|
|
|
_ => {
|
|
span_err!(v.tcx.sess, e.span, E0019,
|
|
"constant contains unimplemented expression type");
|
|
return false;
|
|
}
|
|
}
|
|
true
|
|
}
|