Text Encoder Batch
Batch Text Encoder
With the Batch Version of the Text Encoder, it is possible to control the Text Encoder via batch script or command line externally.
This makes it possible to remote control the Text Encoder and to start it with recurring settings, configurations, files or parameters. On this page, we would like to introduce you to the functionality with some examples.
First Example: Encode File
We would like to change the encoding of the file C:\text.txt to UTF-8:
As a parameter, we pass the file name and the desired encoding.
To try out this example, you have to go in your command line to the directoy in which the Text Encoder is saved. After that, type in the line like above (beginning from "TextEncoder.exe") and press the enter key.
Pass an arbitrary number of files
Use the following command to start the Text Encoder with an arbitrary number of files (here "C:\Dat1.txt" and "C:\Dat2.txt").
If you try this command, the Text Encoder will convert all files to the format UTF-8. When passing files in this way, it plays no role whether you are passing one or more files.
Change Byte Order Mark
You can specify whether a Byte Order Mark (BOM) should be written into the files:
With the parameter "bom", you can specify, whether a Byte Order Mark (BOM) should be written into the files. "bom=0" says, that no BOM should be written, "bom=1" makes sure that a BOM will be written. If you do not specify this paramer (line 3), the BOM will be written per default into the files.
Pass a full directory and convert the containg files
Next to passing individual files, you can also pass one ore more complete folders:
In this example, we are passing the directories "C:\Dir1" and "C:\Dir2" and we would like to convert their contents into the UTF-8 format. When doing so, only text files from the directories are converted and also sub directories are searched for files.
List of Parameters
Here you can see a list of all parameters, you can use in the Batch Version.
|[File Name]||Specify the name (and optionally the path) of a file to process it.|
|[Directory]||Specify a folder, to process all text files from this folder.|
|ANSI||Datei(en) werden konvertiert nach ANSI.|
|UTF7||Datei(en) werden konvertiert nach UTF-7.|
|UTF7ANSI||Datei(en) werden konvertiert nach UTF-7 ANSI.|
|UTF16LE||Datei(en) werden konvertiert nach UTF-16 Little Endian.|
|UTF16BE||Datei(en) werden konvertiert nach UTF-16 Big Endian.|
|UTF32LE||Datei(en) werden konvertiert nach UTF-32 Little Endian.|
|UTF32BE||Datei(en) werden konvertiert nach UTF-32 Big Endian.|
|bom=1||Die Byte Order Mark (BOM) wird in die Datei geschrieben. Lassen Sie einen BOM-Parameter weg, ist dies der Standard.|
|bom=0||Die Byte Order Mark (BOM) wird nicht in die Datei geschrieben.|
|log=1||If the log-parameter is commited, the Text Encoder logs events like errors during processing and file editings in the file process.log.|
All parameters and file names can be commited in any order. Likewise, it is possible to add several files at the same time with adding each file by using a particular parameter for it.
The functionality of the Text Encoder is expanded from time to time. If you should have suggestions for more parameters, let us now.
Example for a Batch Script
Last, we would like to show you a small example of a batch script. Copy the following text (of course you can also adjust the text to your file names) to a normal plain text file and rename the file to "batchsript.bat". The file should be saved in the same directory like the Text Encoder.
If you double click on the file (the file extension *.bat is important), first the Text Encoder will convert the file F1.txt to UTF-8 without BOM and after that, the file F2.txt will be converted to ANSI. Finally, all files from the directory "C:\Folder" are converted to UTF-16 Little Endian including BOM.
The "start /wait" causes, that the next line will be executed after the first line is finished. That means, as soon as the Text Encoder is closed after the automatic processing of file "F1.txt", the second line will be executed and the file "F2.txt" will be processed. The last line (@echo off) means that the command line is closed after the batch script is executed.
Order Text Encoder Batch
The Text Encoder Batch costs 49 USD (39 Euro). Information about how to order, you can see on our download page. If you have further questions, feel free to contact us. If you should already have orderd a normal Standard Text Encoder licence, you can upgrade your licence, so that you only pay the difference.