am 0b5d57ab: am 715f8610: Merge "Clarify documentation of Cursor get* methods." (ae60b8a1) · Commits · e / os / android_frameworks_base

core/java/android/database/Cursor.java

+32 −16

Original line number	Original line	Diff line number	Diff line
	@@ -212,7 +212,9 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a byte array.		* Returns the value of the requested column as a byte array.
	*		*
	* <p>If the native content of that column is not blob exception may throw		* <p>The result and whether this method throws an exception when the
			* column value is null or the column type is not a blob type is
			* implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a byte array.		* @return the value of that column as a byte array.
	@@ -222,8 +224,9 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a String.		* Returns the value of the requested column as a String.
	*		*
	* <p>If the native content of that column is not text the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to String.valueOf(x).		* column value is null or the column type is not a string type is
			* implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a String.		* @return the value of that column as a String.
	@@ -243,8 +246,10 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a short.		* Returns the value of the requested column as a short.
	*		*
	* <p>If the native content of that column is not numeric the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to Short.valueOf(x).		* column value is null, the column type is not an integral type, or the
			* integer value is outside the range [<code>Short.MIN_VALUE</code>,
			* <code>Short.MAX_VALUE</code>] is implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a short.		* @return the value of that column as a short.
	@@ -254,8 +259,10 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as an int.		* Returns the value of the requested column as an int.
	*		*
	* <p>If the native content of that column is not numeric the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to Integer.valueOf(x).		* column value is null, the column type is not an integral type, or the
			* integer value is outside the range [<code>Integer.MIN_VALUE</code>,
			* <code>Integer.MAX_VALUE</code>] is implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as an int.		* @return the value of that column as an int.
	@@ -265,8 +272,10 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a long.		* Returns the value of the requested column as a long.
	*		*
	* <p>If the native content of that column is not numeric the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to Long.valueOf(x).		* column value is null, the column type is not an integral type, or the
			* integer value is outside the range [<code>Long.MIN_VALUE</code>,
			* <code>Long.MAX_VALUE</code>] is implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a long.		* @return the value of that column as a long.
	@@ -276,8 +285,10 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a float.		* Returns the value of the requested column as a float.
	*		*
	* <p>If the native content of that column is not numeric the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to Float.valueOf(x).		* column value is null, the column type is not a floating-point type, or the
			* floating-point value is not representable as a <code>float</code> value is
			* implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a float.		* @return the value of that column as a float.
	@@ -287,8 +298,10 @@ public interface Cursor {
	/**		/**
	* Returns the value of the requested column as a double.		* Returns the value of the requested column as a double.
	*		*
	* <p>If the native content of that column is not numeric the result will be		* <p>The result and whether this method throws an exception when the
	* the result of passing the column value to Double.valueOf(x).		* column value is null, the column type is not a floating-point type, or the
			* floating-point value is not representable as a <code>double</code> value is
			* implementation-defined.
	*		*
	* @param columnIndex the zero-based index of the target column.		* @param columnIndex the zero-based index of the target column.
	* @return the value of that column as a double.		* @return the value of that column as a double.
	@@ -420,7 +433,8 @@ public interface Cursor {
	* that are required to fetch data for the cursor.		* that are required to fetch data for the cursor.
	*		*
	* <p>These values may only change when requery is called.		* <p>These values may only change when requery is called.
	* @return cursor-defined values, or Bundle.EMTPY if there are no values. Never null.		* @return cursor-defined values, or {@link android.os.Bundle#EMPTY Bundle.EMPTY} if there
			* are no values. Never <code>null</code>.
	*/		*/
	Bundle getExtras();		Bundle getExtras();

	@@ -430,8 +444,10 @@ public interface Cursor {
	*		*
	* <p>One use of this is to tell a cursor that it should retry its network request after it		* <p>One use of this is to tell a cursor that it should retry its network request after it
	* reported an error.		* reported an error.
	* @param extras extra values, or Bundle.EMTPY. Never null.		* @param extras extra values, or {@link android.os.Bundle#EMPTY Bundle.EMPTY}.
	* @return extra values, or Bundle.EMTPY. Never null.		* Never <code>null</code>.
			* @return extra values, or {@link android.os.Bundle#EMPTY Bundle.EMPTY}.
			* Never <code>null</code>.
	*/		*/
	Bundle respond(Bundle extras);		Bundle respond(Bundle extras);
	}		}