native2ascii(1) Internationalization Tools native2ascii(1)

# [NAME](#NAME)

native2ascii - Creates localizable applications by converting a file with characters in any supported character encoding to one with ASCII and/or Unicode escapes or vice versa.

# [SYNOPSIS](#SYNOPSIS)

```
native2ascii [ inputfile ] [ outputfile ]
```

[*inputfile*](#inputfile)

The encoded file to be converted to ASCII.

[*outputfile*](#outputfile)

The converted ASCII file.

# [DESCRIPTION](#DESCRIPTION)

The **native2ascii** command converts encoded files supported by the Java Runtime Environment (JRE) to files encoded in ASCII, using Unicode escapes (**\\uxxxx**) notation for all characters that are not part of the ASCII character set. This process is required for properties files that contain characters not in ISO-8859-1 character sets. The tool can also perform the reverse conversion.

If the **outputfile** value is omitted, then standard output is used for output. If, in addition, the **inputfile** value is omitted, then standard input is used for input.

# [OPTIONS](#OPTIONS)

[-reverse](#reverse)

Perform the reverse operation: Converts a file encoded in ISO-8859-1 with Unicode escapes to a file in any character encoding supported by the JRE.

[-encoding *encoding\_name*](#encoding)

Specifies the name of the character encoding to be used by the conversion procedure. If this option is not present, then the default character encoding (as determined by the **java.nio.charset.Charset.defaultCharset** method) is used. The **encoding\_name** string must be the name of a character encoding that is supported by the JRE. See Supported Encodings at http://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html

[-J*option*](#J)

Passes **option** to the Java Virtual Machine (JVM), where option is one of the options described on the reference page for the Java application launcher. For example, **-J-Xms48m** sets the startup memory to 48 MB. See [java(1)](/man/enterprise-packages/adoptium-openjdk-8/java.1).

21 November 2013 JDK 8

---

Document: native2ascii(1) from adoptium-openjdk-8 8.512.5-r1 (Chainguard OS)
Source: https://github.com/adoptium/jdk8u.git