Why am I seeing "An error was detected with your environment's locale configuration"?

This error can occur on POSIX (Mac or Linux) systems when the configured locale is not actually available. This is known to happen by default on certain AWS Lambda runtimes.

Just set the LC_ALL environment variable to "C". You can do this at the command line before running your program, from within your program, or if running on AWS Lambda, from the configuration panel.

1export LC_ALL=C

1process.env.LC_ALL = 'C';

1import os
2
3# ...
4
5os.environ['LC_ALL'] = 'C'

1import ("os")
2
3// ...
4
5os.Setenv("LC_ALL", "C")

1System.setProperty("LC_ALL", "C");

1#include <stdlib.h>
2
3// ...
4// POSIX only
5setenv("LC_ALL", "C", 1 /*overwite existing value*/);

1using System;
2
3// ... 
4
5Environment.SetEnvironmentVariable("LC_ALL", "C");

1putenv("LC_ALL=C");

1Environment.SetEnvironmentVariable("LC_ALL", "C")

If you are setting this from within your program, make sure you do so before you make any calls to the Apryse SDK.

This error occurs when one of the environment variables used to request a locale is set to a locale that is not present on the system. These variables are as follows:

• LC_ALL
• LC_COLLATE
• LC_CTYPE
• LC_MESSAGES
• LC_MONETARY
• LC_NUMERIC
• LC_TIME
• LANG

LC_ALL has the highest priority, so if it is set, it is used. LANG is used as a fallback, only if the other values are not set. You can search for the values of these, if set, using the following command:

1env | grep -E 'LC_.*=|LANG.*='

You can compare the values specified for each variable to the list of available locales:

1locale -a

If one of the required locales is not available, you should either set the environment variable to an available locale (as shown above), or if required, generate the locale (out of scope for this FAQ).