Mercurial > hg > graal-compiler
view graal/com.oracle.truffle.api.object/src/com/oracle/truffle/api/object/DynamicObject.java @ 18772:7fab6f106989
Truffle-DSL: avoid some checkstyle errors for generated code.
author | Christian Humer <christian.humer@gmail.com> |
---|---|
date | Mon, 05 Jan 2015 01:31:07 +0100 |
parents | 6db7923af642 |
children | 723142fed324 |
line wrap: on
line source
/* * Copyright (c) 2013, 2014, 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.object; import com.oracle.truffle.api.*; import com.oracle.truffle.api.interop.*; public interface DynamicObject extends TypedObject, TruffleObject { /** * Get the object's current shape. */ Shape getShape(); /** * Get property value. * * @param key property identifier * @param defaultValue return value if property is not found * @return property value or defaultValue if object has no such property */ Object get(Object key, Object defaultValue); /** * Set value of existing property. * * @param key property identifier * @param value value to be set * @return {@code true} if successful or {@code false} if property not found */ boolean set(Object key, Object value); /** * Define new property or redefine existing property. * * @param key property identifier * @param value value to be set * @param flags flags to be set */ void define(Object key, Object value, int flags); /** * Define new property with a static location or change existing property. * * @param key property identifier * @param value value to be set * @param flags flags to be set * @param locationFactory factory function that creates a location for a given shape and value */ void define(Object key, Object value, int flags, LocationFactory locationFactory); /** * Change property flags. * * @param key property identifier * @param newFlags flags to be set * @return {@code true} if successful or {@code false} if property not found */ boolean changeFlags(Object key, int newFlags); /** * Change property flags. * * @param key property identifier * @param flagsUpdateFunction function updating old flags to new flags * @return {@code true} if successful or {@code false} if property not found */ boolean changeFlags(Object key, FlagsFunction flagsUpdateFunction); /** * Delete property. * * @param key property identifier * @return {@code true} if successful or {@code false} if property not found */ boolean delete(Object key); /** * Returns the number of properties in this object. */ int size(); /** * Returns {@code true} if this object contains no properties. */ boolean isEmpty(); /** * Set object shape and grow storage if necessary. * * @param oldShape the object's current shape (must equal {@link #getShape()}) * @param newShape the new shape to be set */ void setShapeAndGrow(Shape oldShape, Shape newShape); /** * Set object shape and resize storage if necessary. * * @param oldShape the object's current shape (must equal {@link #getShape()}) * @param newShape the new shape to be set */ void setShapeAndResize(Shape oldShape, Shape newShape); /** * Ensure object shape is up-to-date. * * @return {@code true} if shape has changed */ boolean updateShape(); public interface FlagsFunction { int apply(int t); } }