TXTCOD 4.7.1b

TXTCOD is an encoding module using the SAC system.

SYNOPSIS

use TXTCOD;

TXTCOD::codage($source,
$destination,
< $file.cod >,
< $algorithm.alc >,
< $param >);

$param = TXTCOD::decodage($source,
$destination,
$file.cod,
< $algorithm.alc >);
$file.cod = TXTCOD::createcod;

TXTCOD 4.7 encodes files with the SAC system, 2.4 version..

The SAC system consists in several algorithms : a default algorithm who can be remplaced by user-written algorithms. Every algorithm uses a .cod file generated by the module and who contains a list of random numbers used by the module in order to ensure a maximal protection.

B<< A file must be encoded with the same algorithm and the same .cod file !!! . >>

This version of the SAC system can encode any type of file (binary files, text) and recognizes automatically their type.

In the first part you will see the modules how-to and in the second part how to program an algorithm.

FIRST PART : TXTCOD Module

These functions will be accessible after you have typed B<< use TXTCOD; >>
1) Encoding

You call the encoding function by typing :

TXTCOD::codage($source,
$destination,
< $file.cod >,
< $algorithm.alc >,
< $param >);
This function doesnt return any value.

$source is the file you want to encode.
$destination is the file where TXTCOD will send the result of the encoding.

These two parameters are B<< obligatory >>.

$file.cod is the .cod file who is indispensable for the encoding and the decoding. If you dont specify this parameter, will search a "[year].cod" file, for example "2003.cod". A .cod file MUST be changed every year at least in order to assure an optimal protection.

$algorithm.alc is the used algorithm. If you dont put anything, TXTCOD will use the default algorithm.

$param is an user-defined parameter who wont be crypted.
2) Decoding

You call the decoding function by typing :

$param = TXTCOD::decodage($source,
$destination,
$file.cod,
<$algorithm.alc>);

$source in the file you want to decode.
$destination is the result of the decoding
$file.cod et $algorithm.alc -> see the encoding function description.

The returned value is the parameter you optionnally defined while the encoding and which isnt crypted.

3) .cod files creation

To create a .cod file type :

$file.cod = TXTCOD::createcod;
The returned value is the files name ("[year].cod")