Added more examples to the README.

Author: artob

README.md

@@ -34,34 +34,101 @@ Android only, at present. (iOS support is planned.)
 Examples
 --------
 
-### Querying an in-memory database
+### Executing an arbitrary SQL statement
 
-This example also uses
-[`DatabaseUtils`](https://pub.dartlang.org/documentation/flutter_android/latest/android_database/DatabaseUtils-class.html)
-from the [flutter_android](https://pub.dartlang.org/packages/flutter_android) package.
+```dart
+await db.execSQL("DROP TABLE IF EXISTS links");
+
+// Create a bookmark links table:
+await db.execSQL("""
+CREATE TABLE links (
+  id INTEGER PRIMARY KEY NOT NULL,
+  url TEXT NOT NULL,
+  created_at DATETIME NOT NULL,
+  updated_at DATETIME NULL
+)
+""");
+```
+
+### Executing a `INSERT` statement
 
 ```dart
-import 'package:flutter_sqlcipher/sqlite.dart';
-import 'package:flutter_android/android_database.dart' show DatabaseUtils;
+// Insert a new link into the table:
+var linkID = db.insert(
+  table: "links",
+  values: <String, dynamic>{
+    "id": null, // auto-incremented ID assigned automatically
+    "url": "http://example.org/",
+    "created_at": DateTime.now().toUtc().millisecondsSinceEpoch ~/ 1000,
+    "updated_at": null,
+  },
+);
+```
 
-var db = await SQLiteDatabase.createInMemory();
+### Executing an `UPDATE` statement
 
-var cursor = await db.rawQuery("SELECT 1 AS a, 2 as b, 3 AS c");
+```dart
+// Change the previously-inserted link from HTTP to HTTPS:
+db.update(
+  table: "links",
+  values: <String, dynamic>{
+    "url": "https://example.org/",
+    "updated_at": DateTime.now().toUtc().millisecondsSinceEpoch ~/ 1000,
+  },
+  where: "id = ?",
+  whereArgs: <String>[linkID.toString()],
+);
+```
 
-await DatabaseUtils.dumpCursor(cursor);
+### Executing a `DELETE` statement
+
+```dart
+// Delete the previously-inserted link:
+db.delete(
+  table: "links",
+  where: "id = ?",
+  whereArgs: <String>[linkID.toString()],
+);
 ```
 
-### Iterating the rows in a returned cursor
+### Executing an arbitrary SQL query
 
 ```dart
 for (var row in await db.rawQuery("SELECT 1 AS a, 2 as b, 3 AS c")) {
   print(row); // prints: {a: 1, b: 2, c: 3}
 }
 ```
 
+### Creating an in-memory database
+
+```dart
+import 'package:flutter_sqlcipher/sqlite.dart';
+
+var db = await SQLiteDatabase.createInMemory();
+```
+
+### Creating an on-disk database
+
+This example also uses
+[`Context`](https://pub.dartlang.org/documentation/flutter_android/latest/android_content/Context-class.html)
+from the [flutter_android](https://pub.dartlang.org/packages/flutter_android) package
+to obtain the app's cache directory path.
+
+```dart
+import 'package:flutter_sqlcipher/sqlite.dart';
+import 'package:flutter_android/android_content.dart' show Context;
+
+var cacheDir = await Context.cacheDir;
+await cacheDir.create(recursive: true);
+
+var cacheFile = File("${cacheDir.path}/cache.db");
+
+var db = await SQLiteDatabase.openOrCreateDatabase(cacheFile.path);
+```
+
 ### Using a bundled database from the app's assets
 
-TODO
+(To be added.)
 
 Frequently Asked Questions
 --------------------------

lib/src/database.dart

@@ -558,7 +558,7 @@ abstract class SQLiteDatabase implements SQLiteClosable {
       'whereClause': where, // note the name mapping
       'whereArgs': whereArgs,
     };
-    return await _channel.invokeMethod('update', request);
+    return (await _channel.invokeMethod('update', request)) as int;
   }
 
   /// Convenience method for updating rows in the database.