Document the behavior of 'null' values in SharedPreferences (9a413f8f) · Commits · e / os / android_frameworks_base

core/java/android/content/SharedPreferences.java

+6 −2

Original line number	Original line	Diff line number	Diff line
	@@ -71,7 +71,9 @@ public interface SharedPreferences {
	* {@link #commit} or {@link #apply} are called.		* {@link #commit} or {@link #apply} are called.
	*		*
	* @param key The name of the preference to modify.		* @param key The name of the preference to modify.
	* @param value The new value for the preference.		* @param value The new value for the preference. Supplying {@code null}
			* as the value is equivalent to calling {@link #remove(String)} with
			* this key.
	*		*
	* @return Returns a reference to the same Editor object, so you can		* @return Returns a reference to the same Editor object, so you can
	* chain put calls together.		* chain put calls together.
	@@ -83,7 +85,9 @@ public interface SharedPreferences {
	* back once {@link #commit} is called.		* back once {@link #commit} is called.
	*		*
	* @param key The name of the preference to modify.		* @param key The name of the preference to modify.
	* @param values The new values for the preference.		* @param values The set of new values for the preference. Passing {@code null}
			* for this argument is equivalent to calling {@link #remove(String)} with
			* this key.
	* @return Returns a reference to the same Editor object, so you can		* @return Returns a reference to the same Editor object, so you can
	* chain put calls together.		* chain put calls together.
	*/		*/