/* ***** BEGIN LICENSE BLOCK ***** 
 * Version: MPL 1.1/GPL 2.0/LGPL 2.1 
 *
 * The contents of this file are subject to the Mozilla Public License Version 1.1 (the 
 * "License"); you may not use this file except in compliance with the License. You may obtain 
 * a copy of the License at http://www.mozilla.org/MPL/ 
 * 
 * Software distributed under the License is distributed on an "AS IS" basis, WITHOUT 
 * WARRANTY OF ANY KIND, either express or implied. See the License for the specific 
 * language governing rights and limitations under the License. 
 * 
 * The Original Code is [Open Source Virtual Machine.] 
 * 
 * The Initial Developer of the Original Code is Adobe System Incorporated.  Portions created 
 * by the Initial Developer are Copyright (C)[ 2004-2006 ] Adobe Systems Incorporated. All Rights 
 * Reserved. 
 * 
 * Contributor(s): Adobe AS3 Team
 * 
 * Alternatively, the contents of this file may be used under the terms of either the GNU 
 * General Public License Version 2 or later (the "GPL"), or the GNU Lesser General Public 
 * License Version 2.1 or later (the "LGPL"), in which case the provisions of the GPL or the 
 * LGPL are applicable instead of those above. If you wish to allow use of your version of this 
 * file only under the terms of either the GPL or the LGPL, and not to allow others to use your 
 * version of this file under the terms of the MPL, indicate your decision by deleting provisions 
 * above and replace them with the notice and other provisions required by the GPL or the 
 * LGPL. If you do not delete the provisions above, a recipient may use your version of this file 
 * under the terms of any one of the MPL, the GPL or the LGPL. 
 * 
 ***** END LICENSE BLOCK ***** */

#ifndef __avmplus_ArrayObject__
#define __avmplus_ArrayObject__


namespace avmplus
{
	/**
	 * an instance of class Array.  constructed with "new Array" or
	 * an array literal [...].   We need this class to support Array's
	 * special "get" and "put" semantics and to maintain the virtual
	 * "length" property.
	 */
	class ArrayObject : public ScriptObject
	{
	private:
		friend class ArrayClass;
		AtomArray m_denseArr;

		// We can NOT use 0xFFFFFFFF for this since x[0xFFFFFFFE] is a valid prop
		// which would make our length 0xFFFFFFFF
		static const uint32 NO_LOW_HTENTRY	= 0;
		uint32 m_lowHTentry; // lowest numeric entry in our hash table
		uint32 m_length;
	public:
		
		ArrayObject(VTable* ivtable, ScriptObject *delegate, uint32 capacity);
		~ArrayObject()
		{
			m_lowHTentry = 0;
			m_length = 0;
		}

		bool hasDense() const { return (m_denseArr.getLength() != 0); };
		bool isSimpleDense() const { return (m_denseArr.getLength() == m_length); };
		uint32 getDenseLength() const { return m_denseArr.getLength(); }

		uint32 getLength() const { return (m_length); }
		void setLength(uint32 newLength);

		Atom getAtomProperty(Atom name) const;
		void setAtomProperty(Atom name, Atom value);
		bool deleteAtomProperty(Atom name);
		bool hasAtomProperty(Atom name) const;

		// Faster versions that takes direct indices
		Atom getUintProperty(uint32 index) const
		{
			 return _getUintProperty(index);
		}
		void setUintProperty(uint32 index, Atom value)
		{
			_setUintProperty(index, value);
		}
		bool delUintProperty(uint32 index);
		bool hasUintProperty(uint32 i) const;

		Atom getIntProperty(int index) const
		{
			return _getIntProperty(index);
		}
		void setIntProperty(int index, Atom value)
		{
			_setIntProperty(index, value);
		}

		bool getAtomPropertyIsEnumerable(Atom name) const;
		
		Atom _getUintProperty(uint32 index) const;
		void _setUintProperty(uint32 index, Atom value);
		Atom _getIntProperty(int index) const;
		void _setIntProperty(int index, Atom value);

		// Iterator support - for in, for each
		Atom nextName(int index);
		Atom nextValue(int index);
		int nextNameIndex(int index);

		// native methods
		Atom pop(); // pop(...rest)
		uint32 push(Atom *args, int argc); // push(...args):uint
		uint32 unshift(Atom *args, int argc); // unshift(...args):

		void checkForSparseToDenseConversion();

#ifdef DEBUGGER
		uint32 size() const;
#endif

#ifdef AVMPLUS_VERBOSE
	public:
		Stringp format(AvmCore* core) const;
#endif

	};
}

#endif /* __avmplus_ArrayObject__ */