BoxLang 🚀 A New JVM Dynamic Language Learn More...

Encoding Utility

v1.0.3 Modules

Encoding Utility

This is a ColdBox Module to assist in resolving character encoding issues. For example, when a legacy database supports only 7-bit ASCII, and the modern web application receives user content in UTF-8.


  • Lucee 5+
  • ColdBox 4+
  • Java 8+


Install using CommandBox: box install encoding-utility


Within the component you'd like to make use of the Encoding Utlity, have WireBox inject an instance for you from the module's namespace:

property name="encutil" inject="encodingUtility@EncodingUtility";

These are the methods implemented:

  • substitute(string input) Returns the content with reasonable substitutions made. For example, "é" becomes "e".
  • substituteForJSON(string input) Performs substitutions, being conscious of JSON serialization.
  • isBasicLatin(string input) Tests the input for any code points above 127.
  • getStringDetails(string input) Returns a structure of useful information.


See the LICENSE file for license rights and limitations (MIT).

$ box install encoding-utility

No collaborators yet.
  • {{ getFullDate("2017-02-28T19:04:05Z") }}
  • {{ getFullDate("2017-03-14T13:21:28Z") }}
  • 1,929
  • 4,679