.. _lexichem_section_examples_translate:

Translating Names Between Languages
===================================

Translates a file of chemical names (specified by the *-in* option) in a
specific language (*-from* option) into a file of names (specified by
the *-out* option) in another language (*-to* option).

Command Line Interface
----------------------

A description of the command line interface can be obtained by
executing the program with the --help argument.

.. oe:language:: c++

   .. code-block:: console

      prompt> translate_example --help

.. oe:language:: python

   .. code-block:: console

      prompt> python translate_example.py --help

.. oe:language:: java

   .. code-block:: console

      prompt> java Translate_example --help

.. oe:language:: csharp

   .. code-block:: console

      prompt> Translate_example --help


will generate the following output:

.. code-block:: console

   Simple parameter list

     translate
       -nobanner : Suppress the program banner.
       -in : Input filename
       -out : Output filename
       -from : Language for input names.
       -to : Language for input names.
       -from_charset : Choose charset/encoding for input names.
       -to_charset : Choose charset/encoding for output names.

Code
----------------------

.. oe:language:: python

   .. only:: oehtml

      .. admonition:: Download code

         :download:`translate_example.py <../../../../wrappers/python/examples/iupac/translate_example.py>`

   ..   literalinclude:: ../../../../wrappers/python/examples/iupac/translate_example.py

   .. only:: oepdf

      .. oe:source:: translate_example.py
         :language: python


.. oe:language:: c++

   .. only:: oehtml

      .. admonition:: Download code

         :download:`translate_example.cpp <../../../../sublibs/tklibs/iupac/examples/translate_example.cpp>`
         and
         :download:`translate_example.txt <../../../../sublibs/tklibs/iupac/examples/translate_example.txt>`
         interface file

   .. only:: oepdf

      .. oe:source:: translate_example.cpp
         :language: c++

      with interface file

      .. oe:source:: translate_example.txt
         :language: c++

.. oe:language:: java

   .. only:: oehtml

      .. admonition:: Download code

         :download:`Translate_example.java <../../../../wrappers/java/examples/openeye/examples/oeiupac/Translate_example.java>`
         and
         :download:`Translate_example.txt <../../../../wrappers/java/examples/openeye/examples/oeiupac/Translate_example.txt>`
         interface file

   .. only:: oepdf

      .. oe:source:: Translate_example.java
         :language: java

      with interface file

      .. oe:source:: Translate_example.txt
         :language: java

.. oe:language:: csharp

   .. only:: oehtml

      .. admonition:: Download code

         :download:`Translate_example.cs <../../../../wrappers/csharp/Csharp-Examples/OEIUPAC/Translate_example.cs>`

   .. only:: oepdf

      .. oe:source:: Translate_example.cs
         :language: csharp
