I need to upload a file with ANSI character encoding from a VisualForce page and should be able to read the file and perform actions from Apex class(controller). Now when I upload an ANSI file, a StringException occurs:

BLOB is not a valid UTF-8 string.

VF page:

<apex:page Controller="FileParser">
     <apex:include pageName="clcommon__mintTheme"/>
      <apex:sectionHeader title="Upload File" />
        <apex:form >
         <apex:pageBlock >
          <apex:pageBlockButtons location="top">
           <apex:pageMessages escape="false"/>
            <apex:pageBlockSection columns="1">
             <apex:inputFile value="{!bFile}"/>
             <apex:commandButton value="Upload" action="{!processReturnFile}"/>


global with sharing class FileParser{
    public Blob bFile {get; set; }

    public PageReference processReturnFile(){
        String strFile = bFile.toString();
        System.debug(strFile );

I am getting this StringException while trying to do

String strFile = bFile.toString();

To create an ANSI file,

  1. Use characters like SKårebj ø and save file
  2. Use online converters like this one to convert it to ANSI or 8859_1

I need the Controller(Apex class) to be able to read the text of this file. (System.debug(strFile ); in code)

  • 6
    All String values in Apex Code are UTF-8. You cannot use other character encodings in Apex Code, so what you're looking to do is virtually impossible without doing direct bit manipulation.
    – sfdcfox
    Jun 29, 2018 at 13:14
  • @sfdcfox can you please give little details on how to do so, bit manipulation?
    – Divya
    Jun 29, 2018 at 13:37

1 Answer 1


I hacked a Apex Charset encoder/decoder util, check gist Charset.cls

 * Convenience method that decodes bytes in charset into a string of Unicode
 * characters.
 * <p>
 * @param  input binary characters in charset
 * @param  charset name according to http://www.iana.org/assignments/character-sets/character-sets.xhtml
 * @return string of Unicode characters
public static String decode(final Blob input, final String charset){
    final String hex = EncodingUtil.convertToHex(input);
    final Integer size = hex.length() >> 1;
    final List<String> bytes = new String[size];

    for (Integer i = 0; i < size; ++i) {
        bytes.set(i, hex.mid(i << 1, 2));
    return EncodingUtil.urlDecode('%' + String.join(bytes, '%'), charset);

Typically good for file/blob sizes < 200 kB depending on current heap/regexp limits.

Add Charset.cls and change your controller to use Charset.decode with a valid charset name, i.e ISO-8859-1.

global with sharing class FileParser {
    public Blob bFile {get; set;}

    public PageReference processReturnFile() {
        String strFile = Charset.decode(bFile, 'ISO-8859-1');
  • +1 I do rather like this solution. I hope that you will continue to contribute other great solutions in the future!
    – sfdcfox
    Jun 29, 2018 at 14:51
  • @sfdcfox :) I'll do my best.
    – nxtr
    Jul 1, 2018 at 10:05

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service, privacy policy and cookie policy

Not the answer you're looking for? Browse other questions tagged or ask your own question.