Merge pull request #147 from Voklen/master

Support non-ASCII characters

Author: alexcmgit

docs/Usage/Storage Access Framework.md

@@ -161,7 +161,7 @@ final Uint8List? fileContent = await getDocumentContent(uri);
 /// Handle [fileContent]...
 
 /// If the file is intended to be human readable, you can convert the output to [String]:
-print(String.fromCharCodes(fileContent));
+print(utf8.decode(fileContent));
 ```
 
 ### <samp>getRealPathFromUri</samp>
@@ -253,7 +253,7 @@ final DocumentFile? createdFile = createFileAsBytes(
   parentUri,
   mimeType: 'text/plain',
   displayName: 'Sample File Name',
-  bytes: Uint8List.fromList(fileContent.codeUnits),
+  bytes: Uint8List.fromList(utf8.encode(fileContent)),
 );
 ```
 
@@ -272,14 +272,14 @@ final String fileContent = 'My File Content';
 /// Write to a file using a [Uint8List] as file contents [bytes]
 final bool? success = writeToFileAsBytes(
   documentUri,
-  bytes: Uint8List.fromList(fileContent.codeUnits),
+  bytes: Uint8List.fromList(utf8.encode(fileContent)),
   mode: FileMode.write,
 );
 
 /// Append to a file using a [Uint8List] as file contents [bytes]
 final bool? success = writeToFileAsBytes(
   documentUri,
-  bytes: Uint8List.fromList(fileContent.codeUnits),
+  bytes: Uint8List.fromList(utf8.encode(fileContent)),
   mode: FileMode.write,
 );
 ```
@@ -602,7 +602,7 @@ final DocumentFile? createdFile = createFile(
   parentUri,
   mimeType: 'text/plain',
   displayName: 'Sample File Name',
-  content: Uint8List.fromList(fileContent.codeUnits),
+  content: Uint8List.fromList(utf8.encode(fileContent)),
 );
 ```
 
@@ -637,14 +637,14 @@ final bool? success = writeToFile(
 /// Write to a file using a [Uint8List] as file contents [bytes]
 final bool? success = writeToFile(
   documentUri,
-  content: Uint8List.fromList(fileContent.codeUnits),
+  content: Uint8List.fromList(utf8.encode(fileContent)),
   mode: FileMode.write,
 );
 
 /// Append to a file using a [Uint8List] as file contents [bytes]
 final bool? success = writeToFile(
   documentUri,
-  content: Uint8List.fromList(fileContent.codeUnits),
+  content: Uint8List.fromList(utf8.encode(fileContent)),
   mode: FileMode.append,
 );
 ```

example/lib/utils/document_file_utils.dart

@@ -1,3 +1,5 @@
+import 'dart:convert';
+
 import 'package:fl_toast/fl_toast.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter/services.dart';
@@ -67,7 +69,7 @@ extension ShowDocumentFileContents on DocumentFile {
               return Image.memory(content);
             }
 
-            final contentAsString = String.fromCharCodes(content);
+            final contentAsString = utf8.decode(content);
 
             final fileIsEmpty = contentAsString.isEmpty;
 

lib/src/saf/saf.dart

@@ -1,4 +1,5 @@
 import 'dart:async';
+import 'dart:convert';
 import 'dart:io';
 import 'dart:typed_data';
 
@@ -312,7 +313,7 @@ Future<DocumentFile?> createFileAsString(
     parentUri,
     displayName: displayName,
     mimeType: mimeType,
-    bytes: Uint8List.fromList(content.codeUnits),
+    bytes: Uint8List.fromList(utf8.encode(content)),
   );
 }
 
@@ -384,7 +385,7 @@ Future<bool?> writeToFileAsString(
 }) {
   return writeToFileAsBytes(
     uri,
-    bytes: Uint8List.fromList(content.codeUnits),
+    bytes: Uint8List.fromList(utf8.encode(content)),
     mode: mode,
   );
 }
@@ -573,7 +574,7 @@ Future<String?> getDocumentContentAsString(
 }) async {
   final Uint8List? bytes = await getDocumentContent(uri);
 
-  return bytes?.apply((Uint8List a) => String.fromCharCodes(a));
+  return bytes?.apply((Uint8List a) => utf8.decode(a));
 }
 
 /// {@template sharedstorage.saf.getDocumentContentAsString}