package com.ll19.util.map {

	/**
	 * - GL'LL. - 
	 * 
	 * @author <a href="http://www.LL19.com/">LL19.com</a>
	 * 
	 */
	public interface IMap {

		/**
		 * 將指定的值與此映射中的指定鍵相關(guān)聯(lián).
		 * @param key 與指定值相關(guān)聯(lián)的鍵.
		 * @param value 與指定鍵相關(guān)聯(lián)的值.
		 */
		function put(key:String,value:Object):void;

		/**
		 * 返回此映射中映射到指定鍵的值.
		 * @param key 與指定值相關(guān)聯(lián)的鍵.
		 * @return 此映射中映射到指定值的鍵，如果此映射不包含該鍵的映射關(guān)系，則返回 null.
		 */
		function get(key:String):Object;

		/**
		 * 從此映射中移除所有映射關(guān)系
		 */
		function clear():void;

		/**
		 * 如果存在此鍵的映射關(guān)系，則將其從映射中移除
		 * @param key 從映射中移除其映射關(guān)系的鍵
		 */
		function remove(key:String):void;

		/**
		 * 返回此映射中的鍵-值映射關(guān)系數(shù).
		 * @return 此映射中的鍵-值映射關(guān)系的個數(shù).
		 */
		function size():Number;

		/**
		 * 如果此映射未包含鍵-值映射關(guān)系，則返回 true.
		 * @return 如果此映射未包含鍵-值映射關(guān)系，則返回 true.
		 */
		function isEmpty():Boolean;

		/**
		 * 如果此映射包含指定鍵的映射關(guān)系，則返回 true.
		 * @param key  測試在此映射中是否存在的鍵.
		 * @return 如果此映射包含指定鍵的映射關(guān)系，則返回 true.
		 */
		function containsKey(key:String):Boolean;

		/**
		 * 如果該映射將一個或多個鍵映射到指定值，則返回 true.
		 * @param value 測試在該映射中是否存在的值
		 * @return 如果該映射將一個或多個鍵映射到指定值，則返回 true.
		 */
		function containsValue(value:Object):Boolean;

		/**
		 * 返回此映射中包含的所有值.
		 * @return 包含所有值的數(shù)組
		 */
		function values():Array;

		/**
		 * 返回此映射中包含的所有key值.
		 * @return 包含所有key的數(shù)組
		 */
		function allKey():Array;

		/**
		 * 返回此映射中包含的所有key值.
		 * @return 包含所有key的數(shù)組
		 */
		function getKeyAndValues():Object;
	}
}