All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.oracle.truffle.api.profiles.ByteValueProfile Maven / Gradle / Ivy

Go to download

Truffle is a multi-language framework for executing dynamic languages that achieves high performance when combined with Graal.

There is a newer version: 1.0.0-rc7
Show newest version
/*
 * Copyright (c) 2015, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */
package com.oracle.truffle.api.profiles;

import com.oracle.truffle.api.CompilerDirectives;
import com.oracle.truffle.api.CompilerDirectives.CompilationFinal;

/**
 * 

* Specialized value profile to capture certain properties of byte runtime values. * Value profiles require a runtime check in their initialized state to verify their profiled * assumption. Value profiles are limited to capture monomorphic profiles only. This means that if * two or more values are profiled within a single profile then the profile has no effect. If the * value assumption is invalidated in compiled code then it is invalidated. *

* *

* Usage example: * {@link com.oracle.truffle.api.profiles.ByteProfileSnippets.ByteProfileNode#profile} * * {@inheritDoc} * * @see #createIdentityProfile() * @see ValueProfile * @since 0.10 */ public abstract class ByteValueProfile extends Profile { ByteValueProfile() { } /** @since 0.10 */ public abstract byte profile(byte value); /** * Returns a value profile that profiles the exact value of a byte. * * @see ByteValueProfile * @since 0.10 */ public static ByteValueProfile createIdentityProfile() { if (Profile.isProfilingEnabled()) { return Enabled.create(); } else { return Disabled.INSTANCE; } } static final class Enabled extends ByteValueProfile { private static final byte UNINITIALIZED = 0; private static final byte SPECIALIZED = 1; private static final byte GENERIC = 2; @CompilationFinal private byte cachedValue; @CompilationFinal private byte state = 0; @Override public byte profile(byte value) { byte localState = this.state; if (localState != GENERIC) { if (localState == SPECIALIZED) { byte v = cachedValue; if (v == value) { return v; } } CompilerDirectives.transferToInterpreterAndInvalidate(); if (localState == UNINITIALIZED) { this.cachedValue = value; this.state = SPECIALIZED; } else { this.state = GENERIC; } } return value; } boolean isGeneric() { return state == GENERIC; } boolean isUninitialized() { return state == UNINITIALIZED; } byte getCachedValue() { return cachedValue; } @Override public String toString() { return toString(ByteValueProfile.class, state == UNINITIALIZED, state == GENERIC, // String.format("value == (byte)%s", cachedValue)); } /* Needed for lazy class loading. */ static ByteValueProfile create() { return new Enabled(); } } static final class Disabled extends ByteValueProfile { static final ByteValueProfile INSTANCE = new Disabled(); @Override protected Object clone() { return INSTANCE; } @Override public byte profile(byte value) { return value; } @Override public String toString() { return toStringDisabled(ByteValueProfile.class); } } } class ByteProfileSnippets { class Node { } // BEGIN: com.oracle.truffle.api.profiles.ByteProfileSnippets.ByteProfileNode#profile class ByteProfileNode extends Node { final ByteValueProfile profile = ByteValueProfile.createIdentityProfile(); byte execute(byte input) { byte profiledValue = profile.profile(input); // compiler may know now more about profiledValue return profiledValue; } } // END: com.oracle.truffle.api.profiles.ByteProfileSnippets.ByteProfileNode#profile }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy