Examples in documentation

Author: neitanod

README.md

@@ -10,7 +10,7 @@ If you apply the PHP function utf8_encode() to an already-UTF8 string it will re
 
 This class addresses this issue and provides a handy static function called \ForceUTF8\Encoding::toUTF8().
 
-You don't need to know what the encoding of your strings is. It can be Latin1 (iso 8859-1), Windows-1252 or UTF8, or the string can have a mix of them. \ForceUTF8\Encoding::toUTF8() will convert everything to UTF8.
+You don't need to know what the encoding of your strings is. It can be Latin1 (ISO 8859-1), Windows-1252 or UTF8, or the string can have a mix of them. \ForceUTF8\Encoding::toUTF8() will convert everything to UTF8.
 
 Sometimes you have to deal with services that are unreliable in terms of encoding, possibly mixing UTF8 and Latin1 in the same string.
 
@@ -57,17 +57,33 @@ Examples:
 
     use \ForceUTF8\Encoding;
 
-    $str = "Fédération Camerounaise—de—Football\n"; // Uses U+2014 which is invalid
-    echo Encoding::fixUTF8($str); // Breaks invalid char (U+2014)
-    echo Encoding::fixUTF8($str, Encoding::ICONV_TRANSLIT);
-    echo Encoding::fixUTF8($str, Encoding::ICONV_TRANSLIT);
-    
+    $str = "Fédération Camerounaise—de—Football\n"; // Uses U+2014 which is invalid ISO8859-1 but exists in Win1252
+    echo Encoding::fixUTF8($str); // Will break U+2014
+    echo Encoding::fixUTF8($str, Encoding::ICONV_IGNORE); // Will preserve U+2014
+    echo Encoding::fixUTF8($str, Encoding::ICONV_TRANSLIT); // Will preserve U+2014
+
 will output:
 
     Fédération Camerounaise?de?Football
     Fédération Camerounaise—de—Football
     Fédération Camerounaise—de—Football
 
+while:
+
+    use \ForceUTF8\Encoding;
+
+    $str = "čęėįšųūž"; // Uses several characters not present in ISO8859-1 / Win1252
+    echo Encoding::fixUTF8($str); // Will break invalid characters
+    echo Encoding::fixUTF8($str, Encoding::ICONV_IGNORE); // Will remove invalid characters, keep those present in Win1252
+    echo Encoding::fixUTF8($str, Encoding::ICONV_TRANSLIT); // Will trasliterate invalid characters, keep those present in Win1252
+
+will output:
+
+    ????????
+    šž
+    ceeišuuž
+
+
 Install via composer:
 =====================
 Edit your composer.json file to include the following: