File: YieldExpression.cs

package info (click to toggle)
dlr-languages 20090805%2Bgit.e6b28d27%2Bdfsg-3
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 51,484 kB
  • ctags: 59,257
  • sloc: cs: 298,829; ruby: 159,643; xml: 19,872; python: 2,820; yacc: 1,960; makefile: 96; sh: 65
file content (107 lines) | stat: -rw-r--r-- 4,114 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
/* ****************************************************************************
 *
 * Copyright (c) Microsoft Corporation. 
 *
 * This source code is subject to terms and conditions of the Microsoft Public License. A 
 * copy of the license can be found in the License.html file at the root of this distribution. If 
 * you cannot locate the  Microsoft Public License, please send an email to 
 * dlr@microsoft.com. By using this source code in any fashion, you are agreeing to be bound 
 * by the terms of the Microsoft Public License.
 *
 * You must not remove this notice, or any other, from this software.
 *
 *
 * ***************************************************************************/

using System;
using System.Linq.Expressions;
using Microsoft.Scripting.Utils;

namespace Microsoft.Scripting.Ast {
    /// <summary>
    /// Represents either a YieldBreak or YieldReturn in a GeneratorExpression
    /// If Value is non-null, it's a YieldReturn; otherwise it's a YieldBreak
    /// and executing it will stop enumeration of the generator, causing
    /// MoveNext to return false.
    /// </summary>
    public sealed class YieldExpression : Expression {
        private readonly LabelTarget _target;
        private readonly Expression _value;
        private readonly int _yieldMarker;

        internal YieldExpression(LabelTarget target, Expression value, int yieldMarker) {
            _target = target;
            _value = value;
            _yieldMarker = yieldMarker;
        }

        public override bool CanReduce {
            get { return false; }
        }

        public sealed override Type Type {
            get { return typeof(void); }
        }

        public sealed override ExpressionType NodeType {
            get { return ExpressionType.Extension; }
        }

        /// <summary>
        /// The value yieled from this expression, if it is a yield return
        /// </summary>
        public Expression Value {
            get { return _value; }
        }

        /// <summary>
        /// The label used to yield from this generator
        /// </summary>
        public LabelTarget Target {
            get { return _target; }
        }

        public int YieldMarker {
            get {
                return _yieldMarker;
            }
        }

        protected override Expression VisitChildren(ExpressionVisitor visitor) {
            Expression v = visitor.Visit(_value);
            if (v == _value) {
                return this;
            }
            return Utils.MakeYield(_target, v, YieldMarker);
        }
    }

    public partial class Utils {
        public static YieldExpression YieldBreak(LabelTarget target) {
            return MakeYield(target, null, -1);
        }
        public static YieldExpression YieldReturn(LabelTarget target, Expression value) {
            return MakeYield(target, value, -1);
        }
        public static YieldExpression YieldReturn(LabelTarget target, Expression value, int yieldMarker) {
            ContractUtils.RequiresNotNull(value, "value");
            return MakeYield(target, value, yieldMarker);
        }
        public static YieldExpression MakeYield(LabelTarget target, Expression value, int yieldMarker) {
            ContractUtils.RequiresNotNull(target, "target");
            ContractUtils.Requires(target.Type != typeof(void), "target", "generator label must have a non-void type");
            if (value != null) {
                if (!TypeUtils.AreReferenceAssignable(target.Type, value.Type)) {
                    // C# autoquotes generator return values
                    if (target.Type.IsSubclassOf(typeof(Expression)) &&
                        TypeUtils.AreAssignable(target.Type, value.GetType())) {
                        value = Expression.Quote(value);
                    }
                    throw new ArgumentException(string.Format("Expression of type '{0}' cannot be yielded to a generator label of type '{1}'", value.Type, target.Type));
                }
            }

            return new YieldExpression(target, value, yieldMarker);
        }
    }
}