colobot-data 0.1.12 - en to fr translation catalogue (799 entries)

note: type: Plain text
en: Syntax:
fr: Syntaxe:

note: type: Plain text
en: Return the time in seconds elapsed since the beginning of the mission.
fr: Retourne le temps absolu depuis lequel la partie est commencée.

note: type: \t; header
en: Return: <code><a cbot|float>float</a></code>
fr: Type du retour : <code><a cbot|float>float</a></code>

note: type: Plain text
en: Time in seconds.
fr: Temps en secondes.

note: type: \t; header
en: See also
fr: Voir aussi

note: type: Plain text
en: <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Syntax :
fr: Syntaxe:

note: type: Bullet: 'o'
en: <a object|botfr>Shooter</a>
fr: <a object|botfr>Robot tireur</a>

note: type: Bullet: 'o'
en: <a object|botor>Orga shooter</a>
fr: <a object|botor>Robot tireur organique</a>

note: type: Bullet: 'o'
en: <a object|botphaz>Phazer shooter</a>
fr: <a object|botphaz> Robot canon hachoir</a>

note: type: Plain text
en: When controlling the robot through programming, the only way to turn the gun left or right is to turn the whole robot with the instruction <code><a cbot|turn>turn</a></code>.
fr: Pour diriger le canon vers la gauche ou vers la droite, le seul moyen est d'orienter le robot avec l'instruction <code><a cbot|turn>turn</a></code>.

note: type: Plain text
en: Angle in degrees of the gun relative to the robot. A positive value orients the gun upward. For shooters and orga shooters, the angle must range from <code>-20</code> to <code>+20</code> degrees. For phazer shooters, the angle must range from <code>-20</code> to <code>45</code> degrees.
fr: Angle en degrés du canon. Un angle positif oriente le canon vers le haut. Pour les robots tireur, la valeur doit être comprise entre <code>-10</code> et <code>+20</code> degrés. Pour les robots tireur organique, la valeur doit être comprise entre <code>-20</code> et <code>+20</code> degrés. Le robot hachoir accepte des valeurs comprises entre <code>-20</code> et <code>45</code> degrés.

note: type: \t; header
en: Return value: <code><a cbot|int>int</a></code>
fr: Type du retour: <code><a cbot|int>entier (int)</a></code>

note: type: Plain text
en: Zero if everything is OK, a value different from zero if the rotation could not be performed: 
    <code>== 0 </code>The gun has now got the desired orientation
    <code>!= 0 </code>rotation impossible
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>angle atteint
    <code>!= 0 </code>rotation impossible

note: type: \b; header
en: Arrays
fr: Les tableaux (pour spécialistes)

note: type: Plain text
en: An array is basically a collection of variables of the same type or class. You can use N dimensionnal arrays in the CBOT language. Each dimension is limited to 9999 elements. You must use square brackets <code>[]</code> after the type name or the variable name to declare an array.
fr: CBOT gère des tableaux de N dimensions, mais limités volontairement à un maximum de 9999 éléments par dimension. Les tableaux peuvent être de chaque type de base et même avec des éléments d'une classe quelconque. Pour déclarer un tableau, il faut mettre des crochets <code>[]</code> après le type, ou/et après le nom de la variable déclarée.

note: type: Plain text
en: Actually when the CBOT interpreter encounters an array declaration, it just creates a <code><a cbot|null>null</a></code> <a cbot|pointer>reference</a>:
fr: En vérité, lors de la déclaration d'un tableau, CBOT attribue juste une <a cbot|pointer>référence</a> initialement <a cbot|null>nulle</a> :

note: type: Source code
en: int a[5];  // a is now a null reference
fr: int a[5];  // a est une référence nulle

note: type: Plain text
en: As soon as you put values into the array, the elements are created and the reference is initialized:
fr: Dès que l'on met une valeur dans le tableau, CBOT crée les éléments nécessaires et initialise la référence:

note: type: Source code
en: a[2] = 213;  // a points to
                 // 3 elements [0], [1] et [2]
fr: a[2] = 213;  // a est une référence sur
                 // 3 éléments [0], [1] et [2]

note: type: Plain text
en: After this operation, <code>a</code> contains a reference to the elements of the array. Elements <code>[0]</code> and <code>[1]</code> are created but not initialized because an array cannot contain empty elements. The <code><a cbot|sizeof>sizeof</a></code> instruction allows you to obtain the number of elements contained in an array.
fr: Après cette opération, <code>a</code> contient une référence vers les éléments du tableau. Les éléments <code>[0]</code> et <code>[1]</code> sont créés (non initialisés) car un tableau ne peut pas avoir d'éléments vides.
    L'instruction <code><a cbot|sizeof>sizeof</a></code> permet de connaître le nombre d'éléments d'un tableau.

note: type: Plain text
en: When an array is declared with a maximum size, the program will stop as soon as there is an access beyond the maximum array size. No error is signalled during compilation even if the error is obvious:
fr: Lorsqu'un tableau est déclaré avec une taille maximale, le programme donne une erreur lors de l'exécution si on essaie de mettre un élément de trop. Aucune erreur n'est signalée lors de la compilation même si l'erreur paraît évidente:

note: type: Source code
en: {
    	int a[5];
    	a[7] = 123;  // no error at compile time
    	             // but error at run time
    }
fr: {
    	int a[5];
    	a[7] = 123;  // pas d'erreur à la compilation
    	             // mais erreur lors de l'exécution
    }

note: type: Plain text
en: If you pass an array as parameter to a <a cbot|function>function</a>, the function only receives a <a cbot|pointer>reference</a> to the array. That means if you modify an array element in the function, the element of the array that has been passed the function will be actuallay modified.
fr: Lorsqu'on donne un tableau comme paramètre d'une <a cbot|function>fonction</a>, c'est toujours une <a cbot|pointer>référence</a> qui est passée.

note: type: \b; header
en: Blocks
fr: Les blocs

note: type: Plain text
en: You can use braces <code>{ }</code> to group a number of instructions together in order to make one single block out of them, for example:
fr: Les accolades <code>{ }</code> permettent de grouper plusieurs instructions dans un bloc. Par exemple:

note: type: Source code
en: 	{
    		float  t;
    		t = a;
    		a = b;
    		b = t;  // switches round a and b
    	}
fr: 	{
    		float  t;
    		t = a;
    		a = b;
    		b = t;  // permute a et b
    	}

note: type: Plain text
en: Every instruction in the block is followed by a <a cbot|term>semicolon</a>, but the block itself is not. 
    Let us take the following example with the instruction <code><a cbot|if>if</a></code> to illustrate the use of blocks in a program:
fr: Chaque instruction dans le bloc est terminée par un <a cbot|term>point-virgule</a>, mais pas le bloc lui-même.
    Considérons l'exemple suivant utilisant l'instruction <code><a cbot|if>if</a></code>:

note: type: Plain text
en: If the <a cbot|cond>condition</a> is true, instructions 1, 2 and 3 are performed. If the condition is false, only instruction 1 is ignored, instructions 2 and 3 are performed. The fact that instruction 2 is lined up with instruction 1 does not matter. 
    If you want to perform instructions 1 and 2 only if the condition is true, you have to bracket them together in a block:
fr: Si la <a cbot|cond>condition</a> est vraie, les instructions 1, 2 et 3 sont exécutées. En revanche, si la condition est fausse, seule l'instruction 1 est sautée (on exécute donc les instructions 2 et 3). Le fait que l'instruction 2 soit alignée avec la 1 n'y change rien.
    Pour n'exécuter les instructions 1 et 2 que si la condition est vraie, il faut les grouper dans un bloc:

note: type: Plain text
en: Blocks may be needed with instructions <code><a cbot|if>if</a></code>, <code><a cbot|while>while</a></code> and <code><a cbot|for>for</a></code>, in order to group several instructions that should be performed only if a condition is true, or repeated several times. 
    You can fit blocks into other blocks, on as many levels as you need. Here is an example of imbrication on two levels :
fr: Les blocs sont très utilisés avec les instructions <code><a cbot|if>if</a></code>, <code><a cbot|while>while</a></code> et <code><a cbot|for>for</a></code>, pour grouper plusieurs instructions à exécuter ou à répéter.
    On imbrique très souvent des blocs dans d'autres blocs, et ceci à autant de niveaux que nécessaire. Voici un exemple d'imbrication à deux niveaux:

note: type: Plain text
en: You had better line up the open brace <code>{</code> with the closing brace <code>}</code> in order to improve readability, but it is not compulsory. The following example takes less space, is equivalent to the previous example, but it is not advisable to write your programs in the following style :
fr: En général, pour des questions de lisibilité, on aligne verticalement l'accolade ouvrante <code>{</code> avec sa partenaire fermante <code>}</code>. Mais cela n'est pas obligatoire. L'exemple suivant, beaucoup plus compact mais déconseillé, est strictement équivalent à l'exemple précédent:

note: type: Plain text
en: <a cbot>Instructions</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: In a variable of this type you can put a boolean value, that is a value that can take only two states: true or false.
fr: Ce type permet de représenter une valeur booléenne, c'est-à-dire une valeur ne pouvant prendre que deux états: vrai ou faux.

note: type: Plain text
en: With this instruction, you can get out immediately of a <code><a cbot|while>while</a></code> or <code><a cbot|for>for</a></code> loop.
fr: Cette instruction permet de sortir immédiatement d'une structure <code><a cbot|while>while</a></code> ou <code><a cbot|for>for</a></code>.

note: type: Plain text
en: Here is an example:
fr: Voici un exemple d'utilisation:

note: type: Source code
en: <c/>int i = 0;
    while ( true )
    {
    	<n/>Instructions ...<c/>
    	i = i+1;
    	if ( i >= 10 )
    	{
    		break;
    	}
    	<n/>more instructions ...<c/>
    }
fr: <c/>int i = 0;
    while ( true )
    {
    	<n/>Instructions …<c/>
    	i = i+1;
    	if ( i >= 10 )
    	{
    		break;
    	}
    	<n/>plus d'instructions …<c/>
    }

note: type: \b; header
en: Value <code>Categories</code>
fr: Valeur <code>catégorie</code>

note: type: Plain text
en: Categories represent the names of objects in the CBOT language. Everything in COLOBOT is an object: robots, buildings, raw materials, etc., even yourself.
fr: La catégorie détermine la nature d'un objet. Dans COLOBOT, tout est objet: les robots, les bâtiments, les matières premières, les éléments du décor, etc.

note: type: Plain text
en:        <code><a object|titanore>TitaniumOre</a>          </code>Titanium Ore
           <code><a object|uranore>UraniumOre</a>           </code>Uranium Ore
           <code><a object|titan>Titanium</a>             </code>Cube of converted Titanium
           <code><a object|power>PowerCell</a>            </code>Regular Power Cell
           <code><a object|atomic>NuclearCell</a>          </code>Nuclear Power Cell
           <code><a object|bullet>OrgaMatter</a>           </code>Organic Matter
           <code><a object|bbox>BlackBox</a>             </code>Black Box
           <code><a object|tnt>TNT</a>                  </code>Explosive device
           <code><a object|key>KeyA..D</a>              </code>Keys A, B, C and D
fr:        <code><a object|titanore>TitaniumOre</a>    </code>Minerai de titane
           <code><a object|uranore>UraniumOre</a>     </code>Minerai d'uranium
           <code><a object|titan>Titanium</a>       </code>Titane
           <code><a object|power>PowerCell</a>      </code>Batterie standard
           <code><a object|atomic>NuclearCell</a>    </code>Pile atomique
           <code><a object|bullet>OrgaMatter</a>     </code>Matière organique
           <code><a object|bbox>BlackBox</a>       </code>Boîte noire
           <code><a object|key>KeyA..D</a>        </code>Clés A, B C et D
           <code><a object|tnt>TNT</a>            </code>Caisse d'explosif

note: type: Plain text
en: <button 158/>   <code><a object|bottr>PracticeBot</a>            </code>Practice Bot
    <button 173/>   <code><a object|bottarg>TargetBot</a>              </code>Target Bot
fr: <button 158/>   <code><a object|bottr>PracticeBot</a>         </code>Robot d'entraînement
    <button 173/>   <code><a object|bottarg>TargetBot</a>           </code>Robot cible

note: type: Plain text
en: <button 137/>   <code><a object|botgr>WheeledGrabber</a>         </code>Wheeled Grabber
    <button 138/>   <code><a object|botgc>TrackedGrabber</a>         </code>Tracked Grabber
    <button 139/>   <code><a object|botgj>WingedGrabber</a>          </code>Winged Grabber
    <button 150/>   <code><a object|botgs>LeggedGrabber</a>          </code>Legged Grabber
fr: <button 137/>   <code><a object|botgr>WheeledGrabber</a>      </code>Robot préhenseur
    <button 138/>   <code><a object|botgc>TrackedGrabber</a></code>
    <button 139/>   <code><a object|botgj>WingedGrabber</a></code>
    <button 150/>   <code><a object|botgs>LeggedGrabber</a></code>

note: type: Plain text
en: <button 140/>   <code><a object|botsr>WheeledSniffer</a>         </code>Wheeled Sniffer
    <button 141/>   <code><a object|botsc>TrackedSniffer</a>         </code>Tracked Sniffer
    <button 142/>   <code><a object|botsj>WingedSniffer</a>          </code>Winged Sniffer
    <button 152/>   <code><a object|botss>LeggedSniffer</a>          </code>Legged Sniffer
fr: <button 140/>   <code><a object|botsr>WheeledSniffer</a>      </code>Robot renifleur
    <button 141/>   <code><a object|botsc>TrackedSniffer</a></code>
    <button 142/>   <code><a object|botsj>WingedSniffer</a></code>
    <button 152/>   <code><a object|botss>LeggedSniffer</a></code>

note: type: Plain text
en: <button 143/>   <code><a object|botfr>WheeledShooter</a>         </code>Wheeled Shooter
    <button 144/>   <code><a object|botfc>TrackedShooter</a>         </code>Tracked Shooter
    <button 145/>   <code><a object|botfj>WingedShooter</a>          </code>Winged Shooter
    <button 151/>   <code><a object|botfs>LeggedShooter</a>          </code>Legged Shooter
fr: <button 143/>   <code><a object|botfr>WheeledShooter</a>      </code>Robot tireur (de boules de feu)
    <button 144/>   <code><a object|botfc>TrackedShooter</a></code>
    <button 145/>   <code><a object|botfj>WingedShooter</a></code>
    <button 151/>   <code><a object|botfs>LeggedShooter</a></code>

note: type: Plain text
en: <button 153/>   <code><a object|botor>WheeledOrgaShooter</a>     </code>Wheeled Orga Shooter
    <button 154/>   <code><a object|botoc>TrackedOrgaShooter</a>     </code>Tracked Orga Shooter
    <button 155/>   <code><a object|botoj>WingedOrgaShooter</a>      </code>Winged Orga Shooter
    <button 156/>   <code><a object|botos>LeggedOrgaShooter</a>      </code>Legged Orga Shooter
fr: <button 153/>   <code><a object|botor>WheeledOrgaShooter</a>  </code>Robot tireur organique
    <button 154/>   <code><a object|botoc>TrackedOrgaShooter</a></code>
    <button 155/>   <code><a object|botoj>WingedOrgaShooter</a></code>
    <button 156/>   <code><a object|botos>LeggedOrgaShooter</a></code>

note: type: Plain text
en: <button 149/>   <code><a object|botsub>Subber</a>                 </code>Subber
    <button 148/>   <code><a object|botrecy>Recycler</a>               </code>Recycler
    <button 157/>   <code><a object|botshld>Shielder</a>               </code>Shielder
    <button 146/>   <code><a object|bottump>Thumper</a>                </code>Thumper
    <button 147/>   <code><a object|botphaz>PhazerShooter</a>          </code>Phazer Shooter
fr: <button 149/>   <code><a object|botsub>Subber</a>              </code>Robot sous-marin
    <button 148/>   <code><a object|botrecy>Recycler</a>            </code>Robot recycleur
    <button 146/>   <code><a object|bottump>Thumper</a>            </code>Robot secoueur
    <button 157/>   <code><a object|botshld>Shielder</a>            </code>Robot bouclier
    <button 147/>   <code><a object|botphaz>PhazerShooter</a>       </code>Robot hachoir

note: type: Plain text
en:        <code><a object|mother>AlienQueen</a>         </code>Alien Queen
           <code><a object|egg>AlienEgg</a>           </code>Alien Egg
           <code><a object|ant>AlienAnt</a>           </code>Ant
           <code><a object|spider>AlienSpider</a>        </code>Spider
           <code><a object|wasp>AlienWasp</a>          </code>Wasp
           <code><a object|worm>AlienWorm</a>          </code>Worm
fr:        <code><a object|mother>AlienQueen</a>      </code>Mère pondeuse
           <code><a object|egg>AlienEgg</a>        </code>Oeuf
           <code><a object|ant>AlienAnt</a>        </code>Fourmi
           <code><a object|spider>AlienSpider</a>     </code>Araignée
           <code><a object|wasp>AlienWasp</a>       </code>Guêpe
           <code><a object|worm>AlienWorm</a>       </code>Ver

note: type: Plain text
en: <a cbot>CBOT Language</a> and <a cbot|type>Variables</a>.
fr: <a cbot>Programmation</a> et <a cbot|type>types</a>.

note: type: \b; header
en: Instruction <code>class</code>
fr: Instruction <code>class</code> (pour spécialistes)

note: type: Source code
en: public class ClassName
    {
    	declarations;
    }
fr: public class NomDeLaClasse 
    {
    	déclarations;
    }

note: type: Plain text
en: Close a file opened previously with <code><a cbot|open>open</a></code>. This is a method of the <code><a cbot|file>file</a></code> class; therefore you cannot write  <code>close()</code> but only <code>handle.close()</code>:
fr: L'instruction <c/>close();<n/> ferme un fichier de texte dans le dossier 'files/', précédemment ouvert par l'instruction <code><a cbot|open>open</a></code>. Ces instructions sont des méthodes de la classe <code><a cbot|file>file</a></code>. C'est la raison pour laquelle on n'écrit jamais <code>close()</code> tout seul, mais <code>handle.close()</code> :

note: type: Plain text
en: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> and <code><a cbot|eof>eof</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> et <code><a cbot|eof>eof</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: \b; header
en: Conditions
fr: Les conditions

note: type: Plain text
en: <code>a == b  </code><code>a</code> equals <code>b</code>
    <code>a != b  </code><code>a</code> is different from <code>b</code>
    <code>a <  b  </code><code>a</code> smaller than <code>b</code>
    <code>a <= b  </code><code>a</code> smaller than or equal to <code>b</code>
    <code>a >  b  </code><code>a</code> greater than <code>b</code>
    <code>a >= b  </code><code>a</code> greater than or equal to <code>b</code>
fr: <code>a == b  </code><code>a</code> égal à <code>b</code>
    <code>a!= b  </code><code>a</code> différent de <code>b</code>
    <code>a <  b  </code><code>a</code> plus petit que <code>b</code>
    <code>a <= b  </code><code>a</code> plus petit ou égal à <code>b</code>
    <code>a >  b  </code><code>a</code> plus grand que <code>b</code>
    <code>a >= b  </code><code>a</code> plus grand ou égal à <code>b</code>

note: type: Plain text
en: <code>12 == 12  </code>returns true
    <code>45 != 47  </code>returns true 
    <code>99 == 98  </code>returns false
    <code>12 <  -1  </code>returns false
    <code>12 >= 10  </code>returns true 
    <code>12 >= 12  </code>returns true
fr: <code>12 == 12  </code>retourne vrai
    <code>45!= 47  </code>retourne vrai
    <code>99 == 98  </code>retourne faux
    <code>12 <  -1  </code>retourne faux
    <code>12 >= 10  </code>retourne vrai
    <code>12 >= 12  </code>retourne vrai

note: type: Plain text
en: Be careful not to confuse the equality comparison <code>==</code> with the assignment of a <a cbot|var>variable</a> <code>=</code>.
fr: Il faut faire très attention à ne pas confondre la comparaison d'égalité <code>==</code> avec l'affectation d'une <a cbot|var>variable</a> <code>=</code>.

note: type: Plain text
en: <code>a == b</code> is an expression that compares <code>a</code> with <code>b</code>.
    <code>a = b</code> is an expression that copies the value of <code>b</code> into <code>a</code>.
fr: <code>a == b</code> est une expression qui compare <code>a</code> avec <code>b</code>.
    <code>a = b</code> est une expression qui copie la valeur de <code>b</code> dans <code>a</code>.

note: type: Plain text
en: With this instruction, you can jump over the rest of instructions in the <code><a cbot|bloc>bloc</a></code> of a <code><a cbot|while>while</a></code> or <code><a cbot|for>for</a></code> loop: The execution will resume at the beginning of the bloc, the next time the loop is repeated.
fr: Cette instruction permet de passer prématurément au tour de boucle suivant. On peut l'utiliser dans un <a cbot|bloc>bloc</a> après une instruction <code><a cbot|while>while</a></code> ou <code><a cbot|for>for</a></code>.

note: type: Plain text
en: The instructions will only be executed for the values of <code>i</code> 1, 2, 4 and 5.
fr: Les instructions seront exécutées pour les valeurs de <code>i</code> 1, 2, 4 et 5.

note: type: Plain text
en: The deletefile instruction deletes an existing file in the files/ folder.
fr: L'instruction <c/>deletefile();<n/> supprime un fichier dans le dossier files/.

note: type: Plain text
en: Files can only be deleted in the files/ folder which is located in the folder inside Colobot save directory. You cannot not delete files that are located elsewhere than in the files/ folder.
fr: Les fichiers ne peuvent être supprimés que dans le dossier files/, situé là où Colobot a été installé. Il n'est pas possible de supprimer des fichiers situés ailleurs que dans ce dossier files/.

note: type: Plain text
en: Delete an existing information in the closest <a object|exchange>information exchange post</a>.
fr: Supprime une information de la <a object|exchange>station relais</a> la plus proche.

note: type: Plain text
en: Name of the information to be deleted. This name is a string: it must be written in quotation marks "".
fr: Nom de l'information à supprimer dans la station relais. Ce nom est une chaîne de caractères; il doit donc être donné entre guillemets "".

note: type: Plain text
en: Power of the transmitter, which corresponds to the maximal distance between the sender and the exchange post. If the distance is longer, the information won't be deleted. Default value is 10 metres.
fr: Puissance de l'émetteur, qui correspond à la distance maximale jusqu'où peut être la station relais. La valeur par défaut est de 10 mètres.

note: type: Plain text
en: <code><a cbot|receive>receive</a></code>, <code><a cbot|send>send</a></code> and <code><a cbot|testinfo>testinfo</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|receive>receive</a></code>, <code><a cbot|send>send</a></code> et <code><a cbot|testinfo>testinfo</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Calculates the rotation that a robot must perform in order to point towards a given position.
fr: Calcule la direction que doit prendre le robot pour se diriger vers une position donnée.

note: type: Plain text
en: Position towards which the robot must point.
fr: Position à atteindre.

note: type: \t; header
en: Return value: <code><a cbot|float>float</a></code>
fr: Type du retour: <code><a cbot|float>réel (float)</a></code>

note: type: Plain text
en: Angle of the rotation that must be performed. -90 means f. ex. a rotation of 90 degrees to the right.
fr: Angle en degré de la rotation à effectuer. -90 signifie une rotation d'un quart de tour vers la droite, par exemple.

note: type: Plain text
en: With the instruction <code>distance( , )</code> you can calculate the distance between two positions.
fr: Avec l'instruction <code>distance( , )</code> vous pouvez calculer la distance entre deux positions.

note: type: \b; header
en: Basic use
fr: Utilisation courante

note: type: Plain text
en: If you write <code>position</code> alone, this gives you the position of the bot that executes the program. If you write the name of a variable followed by <code>.position</code>, this gives you the position of the object described in the variable.
fr: Si vous écrivez <code>position</code> tout seul, cela donne la position du robot qui exécute le programme. Si vous écrivez le nom d'une variable suivie de <code>.position</code>, cela donne la position de l'objet décrit par la variable.

note: type: Plain text
en: Here is a program that moves forward, covering exactly the distance between the bot and the closest ant:
fr: Voici comment avancer d'une distance égale à la distance entre le robot et la fourmi la plus proche:

note: type: Source code
en: 	item = <a cbot|radar>radar</a>(AlienAnt);
    	<a cbot|move>move</a>(distance(position, item.position));
fr: 	chose = <a cbot|radar>radar</a>(AlienAnt);
    	<a cbot|move>move</a>(distance(position, chose.position));

note: type: Plain text
en: This is of course pure suicide. Better to stop 40 meters before, in order to be at shooting range:
fr: Ceci est bien sûr parfaitement suicidaire, mieux vaut s'arrêter 40m avant, pour être à la bonne distance de tir:

note: type: Source code
en: 	item = radar(AlienAnt);
    	move(distance(position, item.position) - 40);
fr: 	chose = <a cbot|radar>radar</a>(AlienAnt);
    	move(distance(position, chose.position) - 40);

note: type: \b; header, \t; header
en: For specialists
fr: Pour spécialistes

note: type: Plain text, \t; header
en: Syntax:
fr: Syntaxe:

note: type: Plain text
en: Calculates the distance between two positions.
fr: Calcule la distance entre deux points.

note: type: Plain text
en: Coordinates of the two positions.
fr: Coordonnées des deux points.

note: type: Plain text
en: Distance between the two positions.
fr: Distance entre les deux points.

note: type: Plain text
en: Calculates the distance between two positions (ignores the z coordinate).
fr: Calcule la distance "à plat" entre deux points, c'est-à-dire sans tenir compte de l'élévation (coordonnée z).

note: type: Plain text
en: This instruction allows you to perform several times the instructions inside the <a cbot|bloc>block</a>. The instructions are executed at least once, because the condition is tested only afterwards.
    Be careful not to confuse the instruction <c/>do { } while ( );<n/> with the instruction <code><a cbot|while>while</a> ( ) { }</code>; the latter tests the condition before the instructions in the block are executed.
fr: Cette structure de boucle permet d'exécuter plusieurs fois les instructions comprises dans le <a cbot|bloc>bloc</a>. Ces instructions sont toujours exécutées au moins une fois, puisque la condition n'est examinée qu'après exécution de ces instructions.
    Attention à ne pas confondre <c/>do { } while( );<n/> avec <code><a cbot|while>while</a>( ) { }</code>, qui effectue le test avant le premier tour de boucle.

note: type: Plain text
en: The instructions in the block are performed over and over again, as long as the <a cbot|cond>condition</a> is true.
fr: Tant que cette <a cbot|cond>condition</a> est vraie, les instructions dans le bloc sont exécutées.

note: type: Plain text
en: Here is an example :
fr: Voici un exemple d'utilisation:

note: type: Source code
en: <c/>do
    {
    	p = radar(TitaniumOre);
    }
    while ( p == null );
fr: <c/>do
    {
    	p = <a cbot|radar>radar</a>(TitaniumOre);
    }
    while ( p == null );

note: type: Plain text
en: Always put a <a cbot|term>semicolon</a> at the end of the line <code>while ( )</code>.
fr: Il faut toujours mettre un <a cbot|term>point-virgule</a> à la fin de la ligne <code>while ( )</code>.

note: type: Plain text
en: The instructions <code><a cbot|break>break</a></code> and <code><a cbot|continue>continue</a></code> can be useful inside a block following the instruction <code>do { }</code>.
fr: Les instructions <code><a cbot|break>break</a></code> et <code><a cbot|continue>continue</a></code> sont utiles à l'intérieur d'un bloc <code>while { }</code>.

note: type: Plain text
en: The instruction <c/>drop();<n/> instructs the bot to drop whatever the operating arm is carrying on the ground, on the platform of a building or on the power cell location of a bot.
fr: L'instruction <code><a cbot|drop>drop</a>()</code> permet de poser au sol, sur l'emplacement arrière d'un robot ou sur le socle d'un bâtiment, l'objet que le robot tient dans la pince de son bras manipulateur.

note: type: Plain text
en: The instruction <c/>drop();<n/> written in this form drops the object in front of the bot. Here is a short program that grabs an object in front of the bot and drops it 5 meters further:
fr: L'instruction <c/><a cbot|drop>drop</a>();<n/> écrite sous cette forme pose devant le robot l'objet que le robot tient. Voici par exemple comment saisir ce qui se trouve devant le robot pour le poser 5m plus loin:

note: type: Source code
en: 	<a cbot|grab>grab</a>();
    	<a cbot|move>move</a>(5);
    	drop();
fr: 	<a cbot|grab>grab</a>();
    	<a cbot|move>move</a>(5);
    	<a cbot|drop>drop</a>();

note: type: Plain text
en: This instruction appeals to the operating arm of a <a object|botgr>grabber bot</a>, in order to drop what it is holding.
fr: Actionne le bras manipulateur du <a object|botgr>robot préhenseur</a>, pour déposer l'objet saisi.

note: type: \t; header
en: oper: <code><a cbot|int>int</a></code> (default value<code>InFront</code>)
fr: oper: <code><a cbot|int>int</a></code> (valeur par défaut <code>InFront</code>)

note: type: Plain text
en: Oper indicates where the robot should drop the object. If no indication is given, the object is dropped in front of the bot. 
    <code>InFront   </code>  Drops in front (default value).
    <code>Behind    </code>  Drops behind.
    <code>EnergyCell</code>  Drops on the bot's own power cell location.
fr: Position à atteindre avec la bras manipulateur. Si cette indication n'est pas fournie, on suppose qu'il s'agit du cas le plus fréquent où l'objet est pris ou déposé devant le robot.
    <code>InFront   </code>  Dépose devant (par défaut).
    <code>Behind    </code>  Dépose derrière.
    <code>EnergyCell</code>  Dépose sa propre pile/batterie.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>drop();<n/>.
    <code>== 0 </code>object was dropped
    <code>!= 0 </code>error, no object was dropped
fr: Normalement, une erreur stoppe l'exécution du programme. Si l'instruction <code>drop</code> est précédée de <c/><a cbot|errmode>errmode</a>(0);<n/>, une valeur nulle est retournée si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>objet déposé
    <code>!= 0 </code>erreur, pas d'objet déposé

note: type: Plain text
en: Test the end of file condition of an open file. This is a method of the <code><a cbot|file>file</a></code> class; therefore you cannot write  <code>eof()</code> but only <code>handle.eof()</code>:
fr: L'instruction <c/>eof();<n/> teste s'il existe encore une ou plusieurs lignes à lire dans le fichier de texte ouvert dans le dossier 'files/'. Cette instruction est une méthode de la classe <code><a cbot|file>file</a></code>. C'est la raison pour laquelle on n'écrit jamais <code>eof()</code> tout seul, mais <code>handle.eof()</code>:

note: type: Plain text
en: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code> and <code><a cbot|writeln>writeln</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code> et <code><a cbot|writeln>writeln</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: The <c/>errmode();<n/> instruction allows you to chose if the program should stop when an error occurs in one of the following instructions: <code><a cbot|goto>goto</a></code>, <code><a cbot|move>move</a></code>, <code><a cbot|grab>grab</a></code>, <code><a cbot|drop>drop</a></code>, etc.
fr: L'instruction <c/>errmode();<n/> détermine la réaction du programme lorsqu'une erreur est rencontrée dans une instruction du type <code><a cbot|goto>goto</a></code>, <code><a cbot|move>move</a></code>, <code><a cbot|grab>grab</a></code>, <code><a cbot|drop>drop</a></code>, etc.

note: type: Plain text
en: Normally the program is stopped when an error occurs. If you use the instruction <c/>errmode(0);<n/> at the beginning of the program, the instructions listed above return a value different from zero if the instruction could not be performed.
fr: Normalement, un programme s'arrête dès qu'une erreur est rencontrée. En ajoutant <c/>errmode(0);<n/> au début du programme, une instruction <code>goto</code> qui n'arrive pas à destination retourne une valeur non nulle.

note: type: \t; header
en: mode: <code><a cbot|float>float</a></code> (<code>1</code> per default)
fr: mode: <code><a cbot|float>float</a></code> (<code>1</code> par défaut)

note: type: Plain text
en: Error treatment mode.
    <code>0</code> -> continues program execution and returns a non zero value
    <code>1</code> -> stops the program (default behavior)
fr: Mode de gestion des erreurs.
    <code>0</code> -> continue en retournant une valeur non nulle
    <code>1</code> -> stoppe le programme

note: type: Source code
en: <c/>errmode(0);
    int err;
    err = goto(pos);
    if ( err != 0 )
    {
    	<n/>goto did not perform correctly ...<code>
    	</code>take some appropriate action ...<c/>
    }
fr: <c/>errmode(0);
    int err;
    err = goto(pos);
    if ( err != 0 )
    {
    	<n/>gestion de l'erreur ...<c/>
    }

note: type: \b; header
en: Expressions
fr: Les expressions

note: type: Plain text
en: is equivalent to
fr: est équivalent à

note: type: Plain text
en: <code>+=</code>  addition
    <code>-=</code>  subtraction
    <code>*=</code>  multiplication
    <code>/=</code>  division
    <code>%=</code>  remainder of the division (only for the type <code><a cbot|int>int</a></code>)
fr: <code>+=</code>  addition
    <code>-=</code>  soustraction
    <code>*=</code>  multiplication
    <code>/=</code>  division
    <code>%=</code>  reste de la division (seulement pour le type <code><a cbot|int>int</a></code>)

note: type: Plain text
en: The operators <code>++</code> and <code>--</code> allow you to increment (++) or to decrement (--) a variable in very compact and efficient manner.
fr: Les opérateurs <code>++</code> et <code>--</code> permettent d'incrémenter (++) ou décrémenter (--) une variable de manière particulièrement compacte et efficace.

note: type: Plain text
en: The <code>extern</code> instruction  determines the <a cbot|function>function</a> that acts as main program of a robot. The name of the function declared with <code>extern</code> will apear in the program list in the lower left corner of the screen.
fr: L'instruction <code>extern</code> détermine quelle est la <a cbot|function>fonction</a> qui fait office de programme principal. La fonction déclarée <code>extern</code> aura son nom dans la liste des programmes, en bas à gauche de la fenêtre.

note: type: Source code
en: extern void object::MowDown( )
    {
    	while ( true )
    	{
    		fire(1);
    		turn(10);
    	}
    }
fr: extern void object::Boum( )
    {
    	while ( true )
    	{
    		fire(1);
    		turn(10);
    	}
    }

note: type: Plain text
en: If the program contains other functions, only the main function must be preceded by <code>extern</code>.
fr: Si le programme utilise d'autres fonctions, seule la fonction principale doit être précédée de <code>extern</code>.

note: type: Plain text
en: This value means that a condition is not true; it is one of the two values that a <a cbot|bool>boolean</a> <a cbot|var>variable</a> can take.
fr: Cette valeur signifie "faux" pour une <a cbot|var>variable</a> <a cbot|bool>booléenne</a>.

note: type: Plain text
en: This type is used for accessing files in the files/ folder.
fr: Ce type permet d'accéder à un fichier de texte dans le dossier files/.

note: type: Plain text
en: Use the syntax above for declaring a file handle. You must use () to create an instance of the <code>file</code> class. Without the () the handle would have the value <code><a cbot|null>null</a></code>.
fr: Notez la présence des parenthèses, indispensables pour créer une instance de la classe <code>file</code>. Sans les parenthèses, <code>handle</code> aurait la valeur <code><a cbot|null>null</a></code>.

note: type: Plain text
en: Files can only be created and opened in the files/ folder which is located in the folder inside Colobot save directory. You cannot not create or open files elsewhere than in the files/ folder.
fr: Les fichiers ne peuvent être créés et ouverts que dans le dossier 'files/', situé là où Colobot a été installé. Il n'est pas possible de créer ou ouvrir des fichiers situés ailleurs que dans ce dossier 'files/'.

note: type: Plain text
en: <code>file</code> is actually not a simple type but a class. <code>open</code>, <code>close</code>, <code>writeln</code> etc. are methods of the <code>file</code> class. This is the reason why we always write <code>handle.method()</code>:
fr: En réalité, <code>file</code> n'est pas un type, mais une classe. <code>open</code>, <code>close</code>, <code>writeln</code> etc. sont des méthodes de la classe <code>file</code>. C'est la raison pour laquelle on écrit <code>classe.méthode()</code>:

note: type: Source code
en: 	handle.open("test.txt", "w");
    	handle.close();
fr: 	handle.open("essai.txt", "w");
    	handle.close();

note: type: Plain text
en: <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> and <code><a cbot|eof>eof</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> et <code><a cbot|eof>eof</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: The instruction <c/>fire();<n/> fires the bot's onboard cannon.
fr: L'instruction <c/>fire();<n/> permet de faire feu avec le canon du robot.

note: type: Plain text
en: Generally this instruction is used to shoot one-second bursts:
fr: En général, on tire des rafales d'une seconde:

note: type: Plain text
en: Fires the gun, with a burst that lasts a certain time. The longer the burst, the more energy it needs. This instruction can be used with the following bot types:
fr: Tire avec le canon, pendant un certain temps. Plus le tir est long, et plus l'énergie consommée est grande. Cette instruction peut être utilisée avec les robots suivants:

note: type: Plain text
en: In order to move the gun upward or downward, use the instruction <code><a cbot|aim>aim</a></code>.
fr: Pour diriger le canon vers le haut ou vers le bas, il faut utiliser l'instruction <code><a cbot|aim>aim</a></code>.

note: type: Plain text
en: Duration of the burst. Generally, the value given is 1. Shorter bursts can also be performed in order to spare time and energy.
fr: Durée du tir, en secondes. Il s'agit généralement de valeurs relativement courtes. <c/>fire(1);<n/> tire une rafale identique à celle tirée lors la prise de commande du robot. Dans le cas où on survole une concentration importante de fourmis, on peut tirer des rafales plus longues, par exemple <c/>fire(4);<n/>. Pour économiser l'énergie, on peut tirer des rafales très courtes avec par exemple <c/>fire(0.1);<n/>.

note: type: Plain text
en: Zero if OK, or a value different from zero if an error occurred.
    <code>== 0 </code>the cannon has been fired
    <code>!= 0 </code>error, the cannon could not be fired
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>tir effectué
    <code>!= 0 </code>tir impossible

note: type: Plain text
en: Calculates the maximal radius of a flat zone on which a building ca be built.
fr: Calcule le rayon maximal de la zone plate, permettant par exemple de construire un bâtiment.

note: type: Plain text
en: Center of the circlular zone.
fr: Position centrale de la zone circulaire.

note: type: Plain text
en: Maximal radius.
fr: Rayon maximal après lequel le calcul est stoppé.

note: type: Plain text
en: Radius of the flat zone (always between 0 and rmax).
fr: Rayon maximal de la zone plate, compris entre zéro et rmax.

note: type: Plain text
en: Use this type for most variables that contains numbers. Variables of this type can contain positive and negative numbers, whole or real numbers, for example:
fr: Ce type permet de représenter, de manière approchée,  des nombres réels positifs ou négatifs. Par exemple:

note: type: Plain text
en: If you need only whole numbers (f. ex. 12 or -5000), you should rather use the type <code><a cbot|int>int</a></code>.
fr: Pour représenter un nombre entier (12 ou -5000 par exemple) il faut utiliser le type <code><a cbot|int>int</a></code>.

note: type: Plain text
en: Do not insert space or colon characters into a number. To separate the whole part from the fractional part, use a dot.
fr: Ne pas insérer de caractères espace ou de virgule dans un nombre. Pour séparer les entiers des parties fractionnelles, utiliser un point.

note: type: Source code
en:    Write       and not
       12.56       12 . 56
      -54.34       -54,34
    12895.69    12,895.69
fr:    Ecrire       au lieu de
       12.56       12 . 56
      -54.34       -54,34
    12895.69    12,895.69

note: type: Plain text
en: Floating point numbers are represented in Colobot with 32 bits.
    The highest value that can be represented is 3.4E+38.
    The smallest value that can be represented is 3.4E-38.
fr: Sachez que ce type utilise 32 bits.
    La valeur maximale représentable est 3.4E+38.
    La valeur minimale représentable est 3.4E-38.

note: type: Source code
en: <c/>for ( before ; condition ; end )
    {
    	<n/>Instructions ...<c/>
    }
fr: <c/>for ( avant ; condition ; fin )
    {
    	<n/>Instructions ...<c/>
    }

note: type: Plain text
en: This instruction allows you to execute a certain number of times the instructions contained in the <a cbot|bloc>block</a>.
fr: Cette structure de boucle permet d'exécuter plusieurs fois les instructions comprises dans le <a cbot|bloc>bloc</a>.

note: type: \t; header
en: <code>before</code>
fr: <code>avant</code>

note: type: Plain text
en: This <a cbot|cond>condition</a> determines if another instance of the loop must be executed. It is tested before every instance of the loop.
fr: Cette <a cbot|cond>condition</a> détermine s'il faut continuer la boucle. Elle est examinée avant chaque tour de boucle, y compris le dernier.

note: type: \t; header
en: <code>end</code>
fr: <code>fin</code>

note: type: Plain text
en: The following example is strictly equivalent to a <code>for</code>-loop, but it uses the instruction <code><a cbot|while>while</a></code>:
fr: L'instruction <code>for</code> est rigoureusement équivalente à l'exemple suivant, utilisant <code><a cbot|while>while</a></code>:

note: type: Source code
en: <c/>before;
    while ( condition )
    {
    	<n/>Instructions ...<c/>
    	end;
    }
fr: <c/>avant;
    while ( condition )
    {
    	<n/>Instructions ...<c/>
    	fin;
    }

note: type: Plain text
en: Do not put a <a cbot|term>semicolon</a> at the end of the line <code>for ( )</code>.
fr: Il ne faut pas mettre un <a cbot|term>point-virgule</a> à la fin de la ligne <code>for ( )</code>.

note: type: Plain text
en: The instructions <code><a cbot|break>break</a></code> and <code><a cbot|continue>continue</a></code> can be useful inside a block following the instruction <code>for </code>.
fr: Les instructions <code><a cbot|break>break</a></code> et <code><a cbot|continue>continue</a></code> sont utiles à l'intérieur d'un bloc <code>for { }</code>.

note: type: \b; header
en: Functions
fr: Les fonctions

note: type: Plain text
en: You can also declare a function <a cbot|public>public</a> so it can be used by other bots.
fr: Il est aussi possible de déclarer une fonction <a cbot|public>public</a> pour lui permettre d'être utilisée par d'autres robots.

note: type: Plain text
en: The instruction <c/>goto();<n/> instructs the bot to reach a given position.
fr: L'instruction <c/>goto();<n/> permet de déplacer le robot vers une certaine position.

note: type: Plain text
en: The most current use consists in moving the bot to an object located with the instruction <c/><a cbot|radar>radar</a>();<n/>. If the information returned by the <c/><a cbot|radar>radar</a>();<n/> has been stored in a certain variable, write the name of the variable followed by <code>.position</code> in order to get the position of the object. Here is an example of a program that looks for a <a object|titan>titanium cube</a>, goes to the position and grabs it:
fr: En général on déplace le robot vers un objet qu'on a détecté avec l'instruction <c/><a cbot|radar>radar</a>();<n/>. Si on a mis les informations rendues par <c/><a cbot|radar>radar</a>();<n/> dans une certaine variable, il faut écrire le nom de la variable suivi de <code>.position</code> pour obtenir la position de l'objet. Voici par exemple comment chercher un <a object|titan>bloc de titane</a>, aller vers la position du cube et le saisir:

note: type: Source code
en: 	item = <a cbot|radar>radar</a>(Titanium);
    	goto(item.position);
    	<a cbot|grab>grab</a>();
fr: 	object chose;
    	chose = <a cbot|radar>radar</a>(Titanium);
    	goto(chose.position);
    	<a cbot|grab>grab</a>();

note: type: Source code
en: <c/>goto ( position, altitude, goal, crash );<n/>
fr: <c/>goto ( pos, altitude );<n/>

note: type: Plain text
en: Tells the robot to go to the given position, avoiding all the obstacles if this is possible.
fr: Va à une certaine position, en évitant les obstacles tels que les autres robots, les bâtiments, les plans d'eau et les pentes trop raides.

note: type: Plain text
en: Coordinates of the goal position.
fr: Coordonnée de la position à atteindre.

note: type: Plain text
en: Flight altitude for <a object|botgj>winged bots</a>. The altitude is useful only for <a object|botgj>winged bots</a>. From the initial altitude, the bot climbs higher until it reaches the specified hight. When arriving close to destination, it goes down to touch the ground at the given position. If no value is given, an altitude of 10 meters is the default value. On very short moves, even winged bot stay on the ground. For all bot except winged bots, this parameter is ignored.
fr: Altitude moyenne pendant le déplacement, pour les <a object|botgj>robots volants</a>. Si ce paramètre est omis, une altitude de 12.5 mètres est automatiquement utilisée comme consigne. Lorsque le déplacement mesure moins de 20 mètres à vol d'oiseau, le robot reste au sol.

note: type: \t; header
en: goal: <code><a cbot|int>int</a></code> (default value <code>0</code>)
fr: Type du retour: <code><a cbot|int>int</a></code> (valeur par défaut <code>0</code>)

note: type: Plain text
en: This parameter tells the bot how it must reach the goal: 
    <code>0</code>  stops exactly at the goal position
    <code>1</code>  goes close to the goal position, without stopping.
    If no value is given, <code>0</code> (precision) is the default value.
fr: Normalement, une erreur stoppe l'exécution du programme. Si l'instruction <code>goto</code> est précédée de <c/><a cbot|errmode>errmode</a>(0);<n/>, une valeur nulle est retournée si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>position atteinte
    <code>!= 0 </code>impossible d'atteindre la position

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>goto()</code>.
    <code>== 0 </code>Goal position reached
    <code>!= 0 </code>Goal position impossible to reach
fr: <code>go to</code> = aller à

note: type: Plain text
en: The instruction <c/>grab();<n/> instructs the bot to use the operating arm to grab an object located on the ground, on the platform of a building or on the power cell location of a bot.
fr: L'instruction <c/><a cbot|grab>grab</a>();<n/> permet de saisir avec la pince du bras manipulateur un objet qui se trouve au sol, sur l'emplacement arrière d'un robot ou sur le socle d'un bâtiment.

note: type: Plain text
en: The instruction <c/>grab();<n/> written in this form grabs the object located in front of the bot. Here is a short program that grabs an object in front of the bot and drops it 5 meters further:
fr: L'instruction <c/><a cbot|grab>grab</a>();<n/> écrite sous cette forme permet de saisir l'objet qui se trouve devant le robot. Voici par exemple comment saisir ce qui se trouve devant le robot et le poser 5m plus loin:

note: type: Source code
en: 	grab();
    	<a cbot|move>move</a>(5);
    	<a cbot|drop>drop</a>();
fr: 	<a cbot|grab>grab</a>();
    	<a cbot|move>move</a>(5);
    	<a cbot|drop>drop</a>();

note: type: Plain text
en: This instruction appeals to the operating arm of a <a object|botgr>grabber bot</a>, in order to grab the closest object.
fr: Actionne le bras manipulateur du <a object|botgr>robot préhenseur</a>, pour prendre l'objet le plus proche.

note: type: Plain text
en: Oper indicates where the bot should look for an object to grab. If no indication is given, the object is picked up in front of the bot.
    <code>InFront   </code>  Grabs in front (default value).
    <code>Behind    </code>  Grabs behind.
    <code>EnergyCell</code>  Grabs the bot's own power cell.
fr: Position à atteindre avec la bras manipulateur. Si cette indication n'est pas fournie, on suppose qu'il s'agit du cas le plus fréquent où l'objet est pris ou déposé devant le robot.
    <code>InFront   </code>  Prend devant (par défaut).
    <code>Behind    </code>  Prend derrière.
    <code>EnergyCell</code>  Prend sa propre pile/batterie.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>grab();<n/>.
    <code>== 0 </code>an object was grabbed
    <code>!= 0 </code>error, no object was grabbed
fr: Normalement, une erreur stoppe l'exécution du programme. Si l'instruction <code>grab</code> est précédée de <c/><a cbot|errmode>errmode</a>(0);<n/>, une valeur nulle est retournée si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>objet pris
    <code>!= 0 </code>erreur, pas d'objet pris

note: type: \b; header
en: Instructions <code>if</code> and <code>else</code>
fr: Instructions <code>if</code> et <code>else</code>

note: type: Plain text
en: With the instruction <code>if() {}</code> you can execute a set of instructions only if a certain condition is true. Write the condition in brackets <code>()</code>, and the instructions in braces <code>{}</code>.
fr: L'instruction <code>if() {}</code> permet d'exécuter des instructions seulement à une certaine condition. La condition est donnée entre parenthèses <code>()</code>, les instructions entre accolades <code>{}</code>.

note: type: Plain text
en: Here is a concrete example: The bot will shoot only if the target is closer than 40 meters:
fr: Voici par exemple comment faire en sorte que le robot tire seulement si la distance à la cible est inférieure à 40m:

note: type: Source code
en: 	item = <a cbot|radar>radar</a>(AlienAnt);
    	if (<a cbot|dist>distance</a>(position, item.position) < 40)
    	{
    		fire(1);
    	}
fr: 	chose = <a cbot|radar>radar</a>(AlienAnt);
    	if (<a cbot|dist>distance</a>(position, chose.position) < 40)
    	{
    		fire(1);
    	}

note: type: Plain text
en: You can also test if an object exists at all. If the instruction <c/><a cbot|radar>radar</a>();<n/> does not find the requested object, it returns the value <code>null</code>. So you can test if an object does not exists with the condition  <code>(item == null)</code>, or test if it exists with  <code>(item != null)</code>. Two equal signs <code>==</code> test equality, an exclamation mark followed by an equal sign <code>!=</code> test inequality. Here is a test that will go to rechage the <a object|power>power cell</a> only if there is a <a object|station>power station</a>:
fr: Si l'instruction <c/><a cbot|radar>radar</a>();<n/> ne trouve pas l'objet cherché, elle rend la valeur <code>null</code>. Ainsi il est possible de tester si un objet n'existe pas avec <code>(chose == null)</code>, ou de tester si l'objet existe avec <code>(chose!= null)</code>. Deux signes égal <code>==</code> testent l'égalité, un point d'exclamation suivi d'un signe égal <code>!=</code> teste l'inégalité. Voici comment aller se <a object|power>recharger</a> seulement s'il y a une <a object|station>station de recharge</a> :

note: type: Source code
en: 	item = <a cbot|radar>radar</a>(PowerStation);
    	if (item != null)
    	{
    		<a cbot|goto>goto</a>(item.position);
    		<a cbot|wait>wait</a>(5);
    	}
fr: 	chose = <a cbot|radar>radar</a>(PowerStation);
    	if (chose!= null)
    	{
    		<a cbot|goto>goto</a>(chose.position);
    		<a cbot|wait>wait</a>(5);
    	}

note: type: Plain text
en: With this conditional structure you can execute a <a cbot|bloc>bloc</a> A or a <a cbot|bloc>bloc</a> B depending on a <a cbot|cond>condition</a>. If the condition is true, bloc A is executed. If the condition is false, bloc B is executed. 
    Part <code>else { }</code> is not compulsory.
fr: Cette structure de choix permet d'exécuter le <a cbot|bloc>bloc</a> A ou le <a cbot|bloc>bloc</a> B en fonction d'une <a cbot|cond>condition</a>. Si la condition est vraie, le bloc A est exécuté. Si elle est fausse, c'est le bloc B qui est exécuté.
    La partie <code>else { }</code> est facultative.

note: type: Plain text
en: Do not put a <a cbot|term>semicolon</a> at the end of the line <code>if ( )</code>.
fr: Il ne faut pas mettre un <a cbot|term>point-virgule</a> à la fin de la ligne <code>if ( )</code>.

note: type: Plain text
en: Use this type for variables that contain only whole numbers, negative or positive. For example:
fr: Ce type permet de représenter des nombres entiers positifs ou négatifs. Par exemple:

note: type: Plain text
en: To represent real numbers like 12.05 or -0.005, use the type <code><a cbot|float>float</a></code>.
fr: Pour représenter un nombre réel (12.05 ou -0.005 par exemple) il faut utiliser le type <code><a cbot|float>float</a></code>.

note: type: Plain text
en: Do not put space or colon signs inside a number.
fr: Vous ne pouvez pas utiliser d'espace ou d'apostrophe dans un nombre.

note: type: Plain text
en: Numbers of the type <code>int</code> are represented with 32 bits.
    The highest number that can be represented is (2^31)-1, that is 2'147'483'647.
    The smallest number that can be represented is -(2^31), that is -2'147'483'648.
fr: Sachez que ce type utilise 32 bits.
    La valeur maximale représentable est (2^31)-1, soit 2'147'483'647.
    La valeur minimale représentable est -(2^31), soit -2'147'483'648.

note: type: Plain text
en: Direct control of the jet of a <a object|botgj>winged bot</a>. The jet is what makes the bot fly. Use this instruction in order to take off, climb, descend or land.
fr: Commande directe du réacteur d'un <a object|botgj>robot volant</a>.

note: type: Plain text
en: Power of the jet, ranges between <code>-1</code> and <code>+1</code>. <c/>jet(1);<n/> instructs the bot to climb as fast as possible, <c/>jet(-1);<n/> descends as fast as possible, <c/>jet(0);<n/> stabilizes the altitude. In order to get slower altitude changes, use intermediate values, for example <c/>jet(0.3);<n/>.
fr: Puissance du réacteur, comprise entre <code>-1</code> et <code>1</code>. <c/>jet(1);<n/> fait monter le robot à la vitesse maximale, <c/>jet(-1);<n/> le fait descendre à la vitesse maximale, <c/>jet(0);<n/> lui fait garder son altitude actuelle. Pour obtenir des changements d'altitude plus doux, employez des valeurs intermédiaires, par exemple <c/>jet(0.3);<n/>.

note: type: \t; header
en: Return value: <code><a cbot|void>void</a></code>
fr: Type du retour: <code><a cbot|void>aucun (void)</a></code>

note: type: Plain text
en: None.
fr: Aucune.

note: type: Source code
en: <c/>message ( text, type );<n/>
fr: <c/>message ( texte, type );<n/>

note: type: Plain text
en: Prints a message on top of the screen. After a few seconds, the message disappears automatically.
fr: Affiche un message en haut de l'écran. Après quelques secondes, le message disparaît automatiquement.

note: type: \t; header
en: text: <code><a cbot|string>string</a></code>
fr: texte: <code><a cbot|string>string</a></code>

note: type: Plain text
en: Text that is to be displayed. It is possible to append several texts and/or values with the operator <code>+</code>:
    <c/>message("Not found");<n/> 
    <c/>message(angle);<n/> 
    <c/>message(n + " object(s) found");<n/> 
    <c/>message("Distance = " + dist + " meters");<n/>
fr: Texte à afficher. Il est possible de coller/ajouter plusieurs textes et/ou valeurs en utilisant l'opérateur <code>+</code>:
    <c/>message("Pas trouvé");<n/> 
    <c/>message(angle);<n/> 
    <c/>message(n + " objet(s) trouvé(s)");<n/> 
    <c/>message("Distance = " + dist + " mètres");<n/>

note: type: \t; header
en: type: <code><a cbot|int>int</a></code> (default value <code>DisplayMessage</code>)
fr: type: <code><a cbot|int>int</a></code> (valeur par défaut <code>DisplayMessage</code>)

note: type: Plain text
en: Type of the message, that determines the background color.
fr: Type du message, qui détermine la couleur de fond du texte.

note: type: Bullet: 'o'
en: <code>DisplayMessage</code>  Standard message on yellow background.
fr: <code>DisplayMessage</code>  Message standard sur fond jaune.

note: type: Bullet: 'o'
en: <code>DisplayInfo   </code>  Information on green background.
fr: <code>DisplayInfo   </code>  Information sur fond vert.

note: type: Bullet: 'o'
en: <code>DisplayWarning</code>  Warning on blue background.
fr: <code>DisplayWarning</code>  Avertissement sur fond bleu.

note: type: Bullet: 'o'
en: <code>DisplayError  </code>  Error on red background.
fr: <code>DisplayError  </code>  Erreur sur fond rouge.

note: type: Plain text
en: The instruction <c/>motor( , );<n/> sets the speed for the left-hand and the right-hand motor of the bot.
fr: L'instruction <c/>motor( , );<n/> permet de donner directement une vitesse aux moteurs gauche et droite du robot.

note: type: Plain text
en: The speed given to the motors will remain constant during the execution of the following instructions. Thanks to this characteristic it is possible to perform a rotation during the instruction <c/><a cbot|fire>fire</a>();<n/>. This will sweep a whole zone with only one burst. Here is an example that will sweep the zone in front of the bot:
fr: <c/>motor( , );<n/> conserve la vitesse du moteur pendant l'exécution des instructions suivantes. Ceci est utile pour faire tourner le robot pendant l'instruction <c/><a cbot|fire>fire</a>();<n/>. Ainsi, il est possible de balayer toute une zone avec la rafale. Voici par exemple comment nettoyer toute la zone qui se trouve devant le robot :

note: type: Source code
en: 	<a cbot|turn>turn</a>(45);         // turns 45 degrees left
    	motor(0.5, -0.5); // slow rotation to the right
    	<a cbot|fire>fire</a>(2);          // fire
    	motor(0,0);       // stops the rotation
fr: 	<a cbot|turn>turn</a>(45);         // tourne à gauche de 45 degrés
    	motor(0.5, -0.5); // rotation lente à droite
    	<a cbot|fire>fire</a>(2);          // feu
    	motor(0,0);       // immobilise le robot

note: type: Plain text
en: With the left-hand motor turning half-speed forward and the right-hand motor turning half-speed backward, the bot will turn slowly on itself during the 2-second-burst.
fr: En faisant avancer le moteur gauche à demi-vitesse et en faisant reculer le moteur de droite à demi-vitesse, le robot tourne lentement sur lui-même pendant la rafale de 2 secondes.

note: type: Plain text
en: Gives speed instructions to the right and left motors of the robot. The motors will keep this speed until a new motor instruction is performed, or until a <code><a cbot|move>move</a></code>, <code><a cbot|turn>turn</a></code> or <code><a cbot|goto>goto</a></code> instruction is performed.
fr: Donne une consigne de vitesse aux deux moteurs gauche et droite du robot. La vitesse restera constante, jusqu'à ce qu'une nouvelle consigne soit donnée, ou jusqu'à l'utilisation d'une instruction <code><a cbot|move>move</a></code>, <code><a cbot|turn>turn</a></code> ou <code><a cbot|goto>goto</a></code>.

note: type: Plain text
en: Speed instruction for the left motor; the value must range between -1 and 1.
fr: Consigne pour le moteur gauche, comprise entre -1 et 1.

note: type: Plain text
en: Speed instruction for the right motor; the value must range between -1 and 1.
fr: Consigne pour le moteur droite, comprise entre -1 et 1.

note: type: Plain text
en: Examples :
    <c/>motor(1, 1);<n/> moves forward with highest possible speed.
    <c/>motor(-0.5, -0.5);<n/> moves backward with half speed.
    <c/>motor(1, -1);<n/> turns right as fast as possible.
fr: Examples:
    <c/>motor(1, 1);<n/> pour avancer tout droit à la vitesse maximale.
    <c/>motor(0.5, 0.6);<n/> pour avancer à mi-vitesse en tournant légèrement à gauche.
    <c/>motor(-0.5, -0.5);<n/> pour reculer à mi-vitesse.
    <c/>motor(1, -1);<n/> pour tourner à droite le plus vite possible.

note: type: Plain text
en: Note :
    <c/>motor(2, 2);<n/> will not move forward any faster than <code>motor(1, 1)</code> 
    <c/>motor(-2, -2);<n/> will not move backward any faster than <code>motor(-1, -1)</code>
fr: Note :
    <c/>motor(2, 2);<n/> ne conduira pas à un déplacement vers l'avant plus rapide qu'avec <code>motor(1, 1)</code> 
    <c/>motor(-2, -2);<n/>  ne conduira pas à un déplacement vers l'arrière plus rapide qu'avec <code>motor(-1, -1)</code>

note: type: Plain text
en: The instruction <c/>move();<n/> instructs the bot to move forward or backward while keeping the same orientation. In brackets you must specify the length of the move in meters.
fr: L'instruction <c/>move();<n/> fait se déplacer le robot d'une longueur donnée en mètres.

note: type: Plain text
en: If you want the bot to move forward 30 meters, write <c/>move(30);<n/>. In order to move the bot backward after it dropped a chunk of <a object|titanore>titanium ore</a> on the <a object|convert>converter</a>, write <c/>move(-2.5);<n/>.
fr: Pour faire avancer le robot de 30m, écrivez <c/>move(30);<n/>. Pour faire reculer le robot après avoir posé un <a object|titanore>minerai de titane</a> sur la <a object|convert>raffinerie</a>, écrivez <c/>move(-2.5);<n/>.

note: type: Plain text
en: Moves forward or backward of a given distance, always keeping the current orientation of the bot.
fr: Avance d'une certaine distance, dans la direction actuelle.

note: type: Plain text
en: Length of the move, in meters. A negative value makes the bot move backward.
fr: Longueur à avancer, en mètres. Une longueur négative fait reculer le robot.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>move()</code>.
    <code>== 0 </code>Move executed
    <code>!= 0 </code>error, the instruction was not performed correctly
fr: Normalement, une erreur stoppe l'exécution du programme. Si l'instruction <code>move</code> est précédée de <c/><a cbot|errmode>errmode</a>(0);<n/>, une valeur nulle est retournée si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>déplacement effectué
    <code>!= 0 </code>déplacement impossible

note: type: Plain text
en: This special value indicates that a <a cbot|var>variable</a> of type <code><a cbot|int>int</a></code> or <code><a cbot|float>float</a></code> contains no number, but "nothing". 
    For example, if the instruction <code><a cbot|receive>receive</a></code> can not get the requested information, it returns <code>nan</code> :
fr: Cette valeur spéciale indique qu'une <a cbot|var>variable</a> de type <code><a cbot|int>int</a></code> ou <code><a cbot|float>float</a></code> ne contient pas un nombre, mais "rien".
    Par exemple, lorsque l'instruction <code><a cbot|receive>receive</a></code> n'arrive pas à recevoir l'information demandée, elle retourne <code>nan</code>:

note: type: Source code
en: 	value = receive("Length");
    	if ( value == nan )  // not found ?
    	{
    		
    	}
fr: 	value = receive("Longueur");
    	if ( value == nan )  // pas trouvé?
    	{
    	}

note: type: \t; header
en: Dictionnary
fr: Dictionnaire anglais-français

note: type: Plain text
en: <code>nan</code> = Not A Number
fr: <code>nan</code> (not a number) = pas un nombre

note: type: \b; header
en: Instruction <code>new</code> (for specialists)
fr: Instruction <code>new</code> (pour spécialistes)

note: type: Plain text
en: The <code>new</code> operator creates a <a cbot|class>class</a> instance:
    <c/><s/>	MyClass item;    // now item is a null reference
fr: Une instance de <a cbot|class>classe</a> peut être créée par l'opérateur <code>new</code>:
    <c/><s/>	MaClasse item;  // item vaut null

note: type: Source code
en: 	item = new MyClass(); // now item is a reference
    	                      // to a new class instance
fr: 	item = new MaClasse();

note: type: Plain text
en: If you want to create a new instance at declaration time you can ommit the new <code>new</code> operator by putting () after the declaration:
fr: Lorsque l'instance est créée en même temps que la déclaration, il est possible de simplifier l'écriture:

note: type: Plain text
en: Instead of:
    <c/><s/>	MyClass item = new MyClass();
    <n/>you can write:
    <c/><s/>	MyClass item();
fr: Au lieu de :
    <c/><s/>	MaClasse chose = new MaClasse();
    <n/>on peut écrire :
    <c/><s/>\MaClasse chose();

note: type: Plain text
en: If your class has a constructor with parameters you can write:
    <c/><s/>	MyClass item = new MyClass(2, 3);
    <n/>or:
    <c/><s/>	MyClass item(2, 3);
fr: Si, par exemple, la classe contient un constructeur avec deux paramètres numériques, il est possible d'écrire:
    <c/><s/>	MyClass item = new MyClass(2, 3);
    <n/>or:
    <c/><s/>	MyClass item(2, 3);

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|pointer>reference</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <a cbot|pointer>Références</a>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: This special value indicates that the variable containing it does not reference an instance.
fr: Cette valeur spéciale indique un objet qui n'existe pas.

note: type: Plain text
en: <a cbot|pointer>References</a>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <a cbot|pointer>Passage par références</a>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Position of the object on the planet, in meters. The coordinates <code>x</code> and <code>y</code> correspond to the location on a map, the <code>z</code> coordinate corresponds to the altitude above (respectively below) sea level.
fr: Position de l'objet sur la planète, en mètres. Les coordonnées <code>x</code> et <code>y</code> correspondent à la position à plat, alors que <code>z</code> correspond à l'élévation absolue par rapport au niveau de la mer.

note: type: Plain text
en: Orientation of the object, in degrees. The orientation tells you what direction the object is facing. An orientation of <code>0</code> corresponds to an object facing eastwards, thus following the positive <code>x</code> axis. The orientation is measured counterclockwise.
fr: Orientation de l'objet, en degrés. Une orientation de <code>0</code> correspond à un objet tourné vers l'est, donc vers l'axe <code>x</code> positif. Le sens de l'orientation est anti-horaire.

note: type: Plain text
en: Forward/backward angle of the robot. A pitch of <code>0</code> means that the bot is standing on flat ground. A positive inclination means that it is facing upwards, a negative inclination means that it is facing downwards.
fr: Inclinaison avant/arrière de l'objet, en degrés. Une valeur positive indique que le robot monte.

note: type: Plain text
en: Left/right angle of the bot, in degrees. A positive value means that the bot is leaning to the left side, a negative value means that it is leaning to the right side.
fr: Inclinaison latérale de l'objet, en degrés. Une valeur positive indique que le robot penche à gauche.

note: type: Plain text
en: Energy level, between 0 and 1. A normal <a object|power>power cell</a> that is fully charged returns the value <code>1</code>. A <a object|atomic>nuclear power cell</a> never returns a value higher than 1, it just lasts longer. Attention: The energy level of a bot is always zero, because the energy is not contained in the bot, but in the power cell. To know the energy level of the power cell of a bot, you must write <code>energyCell.energyLevel</code>.
fr: Niveau d'énergie. Une <a object|power>batterie standard</a> entièrement pleine donne la valeur <code>1</code>. Une <a object|atomic>pile atomique</a> ne dépasse jamais le niveau <code>1</code>; elle dure simplement plus longtemps.
    Notez que le niveau d'énergie d'un robot est toujours nul. En effet, l'énergie est contenue dans la pile ou la batterie qui est placée à l'arrière du robot, et non dans le robot lui-même. Il faut donc écrire <code>energyCell.energyLevel</code> pour connaître l'énergie à disposition.

note: type: Plain text
en: Shield level of a robot or building. A level <code>1</code> indicates that the shield is still perfect. Every time that the bot or building gets a bullet or collides with another object, the shield level decreases. When the level reaches <code>0</code>, the next bullet or collision will destroy the bot or building. 
    Bots can re-energize their shield on a <a object|repair>repair center</a>. The shield of a building is repaired if it lays inside the protection sphere of a <a object|botshld>shielder</a>.
fr: Niveau du bouclier du robot ou du bâtiment. Un niveau de <code>1</code> correspond à un bouclier en parfait état. Avec un niveau de <code>0</code>, le prochain choc ou tir ennemi sera fatal.
    Les robots peuvent régénérer leurs boucliers sur le <a object|repair>centre de réparation</a>. Le bouclier d'un bâtiment est régénéré s'il se trouve dans la sphère protectrice du <a object|botshld>robot bouclier</a>.

note: type: Plain text
en: Temperature of the jet of <a object|botgj>winged bots</a>. <code>0</code> corresponds to a cold jet. When used, the temperature increases progressively. When it reaches the value <code>1</code>, the jet is overheated and stops working, until it cooled down a little.
fr: Température du réacteur pour les <a object|botgj>robots volants</a>. <code>0</code> correspond à un réacteur froid et <code>1</code> à un réacteur bouillant, provisoirement hors d'usage.

note: type: Plain text
en: The <code>z</code> coordinate of the position indicates the altitude above sea level, whereas the <code>altitude</code> indicates the height above ground. This value is meaningful only for <a object|botgj>winged bots</a> and for <a object|wasp>wasps</a>. For all other objects, this value is zero.
fr: Contrairement à la position <code>z</code> qui est absolue, l'altitude est relative au niveau du sol. L'altitude n'a de sens que pour les <a object|botgj>robots volants</a> et la <a object|wasp>guêpe</a>. Pour tous les autres robots ou pour les bâtiments, cette valeur est nulle.

note: type: Plain text
en: The age of the object in seconds since it's creation.
fr: Donne l'âge de l'objet, en secondes.

note: type: Plain text
en: This information is special, because it returns the information about another object, in this case the power pack. This means that energyCell contains all the characteristics of a normal object, for example <code>category</code> (PowerCell or NuclearCell), <code>position</code> (the position of the cell), etc.
    If you want to know the energy level of a robot, you must not check <code>energyLevel</code>, but <code>energyCell.energyLevel</code>.
    If the bot has bot no power cell, <code>energyCell</code> returns <code>null</code>.
fr: Cette information est spéciale, dans la mesure où elle contient les caractéristiques d'un autre objet, la pile ou la batterie en l'occurrence. On y retrouve donc toutes les caractéristiques de l'objet de base, telles que <code>category</code>, <code>position</code>, etc.
    Pour connaître le niveau d'énergie d'un robot, il ne faut pas accéder à <code>energyLevel</code>, mais à <code>energyCell.energyLevel</code>.
    Si le robot n'a pas de pile ni de batterie, <code>energyCell</code> vaut <code>null</code>.

note: type: Plain text
en: This information also returns the description of a whole object: the description of the object carried by a <a object|botgr>grabber</a>. If it carries nothing, <code>load</code> returns <code>null</code>.
fr: Cette information est spéciale, comme la précédente. Elle contient les caractéristiques de l'objet transporté par le <a object|botgr>robot préhenseur</a>. S'il ne transporte rien, <code>load</code> vaut <code>null</code>.

note: type: Plain text
en: The type <code>object</code> returns the special value <code><a cbot|null>null</a></code> when the object does not exist. For example:
fr: Le type <code>object</code> prend la valeur particulière <code><a cbot|null>null</a></code> lorsque l'objet n'existe pas. Par exemple:

note: type: Source code
en: 	object a;
    	a = radar(BotGrabberRoller);
    	if ( a == null )  // object does not exist ?
    	{
    	}
    	if ( a.position.z > 50 )  // is it on a mountain ?
    	{
    	}
fr: 	object a;
    	a = <a cbot|radar>radar</a>(BotGrabberRoller);
    	if ( a == null )  // objet n'existe pas?
    	{
    	}
    	if ( a.position.z > 50 )  // sur une hauteur?
    	{
    	}

note: type: Plain text
en: Open a text file in the files/ folder. This is a method of the <code><a cbot|file>file</a></code> class. This is the reason why we always write <code>handle.open()</code>:
fr: L'instruction <c/>open();<n/> ouvre un fichier de texte dans le dossier 'files/'. Cette instruction est une méthode de la classe <code><a cbot|file>file</a></code>. C'est la raison pour laquelle on n'écrit jamais <code>open()</code> tout seul, mais <code>handle.open()</code>:

note: type: Source code
en: 	handle.open("test.txt", "w");
fr: 	handle.open("essai.txt", "w");

note: type: Plain text
en: To open a file, proceed as follows:
fr: Pour ouvrir un fichier, procédez comme suit:

note: type: Plain text
en: Files can only be created and opened in the files/ folder which is located in the folder inside Colobot save directory. You cannot not create or open files that are located elsewhere than in the files/ folder.
fr: Les fichiers ne peuvent être créés et ouverts que dans le dossier 'files/', situé là où Colobot a été installé. Il n'est pas possible de créer ou ouvrir des fichiers situés ailleurs que dans ce dossier 'files/'.

note: type: Plain text
en: <code><a cbot|file>file</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> and <code><a cbot|eof>eof</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|file>file</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code>, <code><a cbot|writeln>writeln</a></code> et <code><a cbot|eof>eof</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Variables of this type contain the coordinates of a point in space. This type is made of three values that represent the <code>x</code>, <code>y</code> and <code>z</code> coordinates.
    <code>x</code> and <code>y</code> correspond to the place on the ground. The positive <code>x</code> axis faces towards east, the positive <code>y</code> axis faces towards north. 
    The <code>z</code> value corresponds to the altitude above sea level.
fr: Ce type permet de représenter les coordonnées d'un point dans l'espace. Ce type contient en fait 3 nombres réels, pour les coordonnées <code>x</code>, <code>y</code> et <code>z</code>.
    <code>x</code> et <code>y</code> correspondent à la position sur le sol, à plat. <code>x</code> positif va en direction de l'est et <code>y</code> positif va en direction du nord.
    <code>z</code> correspond à l'élévation.

note: type: Plain text
en: If you want to declare a variable of type point, you can write:
fr: Pour déclarer et initialiser un point, vous pouvez écrire:

note: type: Plain text
en: You can also set the variable taking one value after another:
fr: Il est possible d'accéder à une coordonnée particulière avec:

note: type: Plain text
en: With these examples, the following <a cbot|cond>condition</a> is true:
fr: Avec ces deux exemples, la <a cbot|cond>condition</a> suivante est vraie:

note: type: Plain text
en: <n/> 
    The following declaration :
fr: La déclaration suivante:

note: type: Plain text
en: Is equivalent to :
fr: Est équivalente à:

note: type: \b; header
en: References (for specialists)
fr: Les références (pour spécialistes)

note: type: Plain text
en: CBOT uses references for <a cbot|class>classes</a> and <a cbot|array>arrays</a>. Any class variable actually contains a reference to the instance. The instance actually contains the class fields. Several references can reference the same instance. A <code><a cbot|null>null</a></code> reference references nothing. You can compare an instance to a suitcase and a reference to a carrier. Each time we need a new suitcase we create a new instance with a carrier. But a suitcase can be carried by more than one carrier. A carrier who carries no suitcase is a <code><a cbot|null>null</a></code> reference.
fr: CBOT travaille avec des références aux instances de <a cbot|class>classes</a> et aux <a cbot|array>tableaux</a>. Une instance est un élément physique contenant les informations liées à la classe. On peut comparer cela à une petite valise avec des conteneurs correspondants à la description de la classe. A chaque fois que l'on a besoin d'une nouvelle valise pour y mettre quelque chose, il faut créer une nouvelle instance. Les références, quant à elles, peuvent être considérées comme les porteurs de ces valises, à cela prêt qu'il y a souvent plusieurs porteurs pour la même valise. Une référence <code><a cbot|null>null</a></code> ne référence rien; c'est comparable à un porteur sans valise.
    Le fait qu'une instance à une classe soit créée automatiquement (<code><a cbot|new>new</a></code> sous-entendu) ne change pas ce concept. On peut donc copier une référence dans une autre et avoir plusieurs références vers une même instance.

note: type: Plain text
en: Example:
    <c/><s/>{
fr: Examples:
    <c/><s/>{

note: type: Source code
en: 	MyClass item1(); // create a new instance
    	                 // referenced by item1
    	MyClass item2;   // create a null reference
    	item2 = item1;   // copy the reference,
    	                 // item2 and item1 now reference
    	                 // the same instance
    	item1.a = 12;    // modifies the instance
    	                 // referenced by item1 (and item2)
    	message(item2.a);// displays 12
    }
fr: 	MaClasse item1();  // crée une instance
    	MaClasse item2;    // crée une référence nulle
    	item2 = item1;     // copie la référence
    	item1.a = 12;      // modifie aussi item2
    	message(item2.a);  // affiche 12
    }

note: type: Plain text
en: If you pass a <a cbot|class>class</a> instance as parameter to a function, the function only receives a reference to the instance. That means if you modify the instance in the function, the instance that has been specified by the caller will be actuallay modified.
fr: Si vous passez une instance de <a cbot|class>classe</a> en paramètre, c'est toujours la référence qui est transmise à la <a cbot|function>fonction</a>. Cela signifie que si cette instance est modifiée dans la fonction, cela a un impact à l'extérieur de la fonction :

note: type: Plain text
en: <c/><s/>void Test( MyClass item )
fr: <c/><s/>void Test( MaClasse item )

note: type: Source code
en: {
    	item.a = 12;          // modify the original instance
    	item = new MyClass(); // new local instance
    	item.a = 33;          // modifie the local instance
    }
fr: {
    	item.a = 12;            // modifie l'instance d'origine
    	item = new MaClasse();  // nouvelle instance locale
    	item.a = 33;            // modifie l'instance locale
    }

note: type: Plain text
en: Calling the fucntion <code>Test()</code>:
    <c/><s/>{
fr: Un appel à cette fonction va donner cela :
    <c/><s/>{

note: type: Source code
en: 	MyClass toto();
    	Test(toto);
    	message(toto.a);  // displays 12
    }
fr: 	MaClasse toto();
    	Test(toto);
    	message(toto.a);  // affichage de toto.a qui vaut 12
    }

note: type: Plain text
en: The instance containing the field <code>a = 33</code> is referenced only by the newly created instance <code>item</code> inside the fucntion <code>Test</code>. At the end of <code>Test</code> this newly created instance referenced by <code>item</code> is automatically deleted.
fr: En effet, l'instance avec le résultat <code>33</code> n'était pointée que par <code>item</code> dans la fonction <code>Test</code>. A la sortie de <code>Test</code>, la référence <code>item</code> disparaît et l'instance qu'elle pointait n'a plus de raison d'être.

note: type: Plain text
en: A function can return an instance:
    <c/><s/>MyClass Test2( )
fr: Une <a cbot|function>fonction</a> peut rendre une instance en sortie. Pour cela, il faut la définir ainsi:
    <c/><s/>MaClasse Test2( )

note: type: Source code
en: {
    	MyClass item = new MyClass();
    	item.a = 33;
    	return item;
    }
fr: {
    	MaClasse item = new MaClasse();
    	item.a = 33;
    	return item;
    }

note: type: Plain text
en: Call the function like this:
    <c/><s/>{
fr: L'appel à cette fonction se fait alors ainsi:
    <c/><s/>{

note: type: Source code
en: 	MyClass toto;
    	toto = Test2(); // toto will contain a reference to
    	                // the instance created by Test2()
    	message(toto.a); // displays 33
    }
fr: 	MaClasse toto;
    	toto = Test2();
    	message(toto.a);  // affiche 33
    }

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|new>new</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: \b; header
en: Instruction <code>private</code> (for specialists)
fr: Instruction <code>private</code> (pour spécialistes)

note: type: Source code
en: public class MyClass
    {
    	int    b;                // public by default
    	public int a;            // also public 
    	private point position;  // private
    }
    void Test()
    {
    	MyClass item;
    	item.a = item.b = 12;      // ok
    	message( item.position );  // this is an error
    }
fr: public class MaClasse
    {
    	int    b;                // public par défaut
    	public int a;            // public aussi
    	private point position;  // privé
    }
    void Test()
    {
    	MaClasse item;
    	item.a = item.b = 12;      // ok
    	message( item.position );  // erreur élément non accessible
    }

note: type: \b; header
en: Instruction <code>public</code> (for specialists)
fr: Instruction <code>public</code> (pour spécialistes)

note: type: Plain text
en: This instruction has two distinct purposes:
fr: Cette instruction a deux rôles distincts:

note: type: Bullet: '1)'
en: Make a function available to other bots.
fr: Rendre une fonction accessible de tous les robots.

note: type: Bullet: '2)'
en: Make a class member accessible from outside the class definition.
fr: Rendre une méthode d'une classe accessible de l'extérieur.

note: type: \b; header
en: Instruction <code>public</code> for functions
fr: Instruction <code>public</code> pour les fonctions

note: type: Plain text
en: If you put <code>public</code> before a <a cbot|function>function</a> definition, you can make the function available to programs in other bots in the same mission.
fr: La présence de ce mot rend la <a cbot|function>fonction</a> disponible partout dans la mission. Cette fonction peut alors être utilisée dans le programme d'un autre robot.

note: type: Plain text
en: For example in the first bot we would have:
fr: Par exemple, dans un premier robot:

note: type: Plain text
en: And in another bot we would have:
fr: Et dans un autre robot:

note: type: Plain text
en: If you have declared a function <code>public</code>, you cannot define a function with the same name and arguments in another bot of the same mission.
fr: Il ne peut y avoir qu'une seule fonction ayant le même nom, parmi tous les programmes des robots de la mission en cours.

note: type: Plain text
en: If a bot containing a <code>public</code> function is destroyed, the other bots that make use of this function will be stopped with an error.
fr: Si le robot qui contenait la fonction déclarée <code>public</code> est détruit, les autres robots qui utilisent cette fonction sont stoppés sur une erreur!

note: type: \b; header
en: Instruction <code>public</code> for classes
fr: Instruction <code>public</code> pour les classes

note: type: Source code
en: public class MyClass
    {
    	int    b;                // public by default
    	public int a;            // also public 
    	private point position;  // privat
    }
    void Test()
    {
    	MyClass item;
    	item.a = item.b = 12;      // ok
    	message( item.position );  // this is an error
    }
fr: public class MaClasse
    {
    	int    b;                // public par défaut
    	public int a;            // public aussi
    	private point position;  // privé
    }
    void Test()
    {
    	MaClasse item;
    	item.a = item.b = 12;      // ok
    	message( item.position );  // erreur
    }

note: type: Plain text
en: Write in brackets the <a cbot|category>name of the object</a> that you look for. Put the result in a variable of the <a cbot|type>type</a> <code>object</code>. Here is an example that looks for the closest ant:
fr: Donnez entre parenthèses le <a cbot|category>nom de l'objet</a> que vous cherchez. Mettez le résultat dans une variable de <a cbot|type>type</a> <code>object</code>. Voici par exemple comment chercher la fourmi la plus proche:

note: type: Source code
en: // At the beginning of the program:
    object  item; // variable declaration
    
    // Look for the closest ant
    item = radar(AlienAnt);
fr: // Tout au début du programme:
    object  chose; // déclaration de la variable
    
    // Cherche la fourmi la plus proche
    chose = <a cbot|radar>radar</a>(AlienAnt);

note: type: Plain text
en: Detects an object according to several parameters.
fr: Détecte un objet selon divers critères.

note: type: Plain text
en: Seen from above, the purple zone corresponds to the zone where objects will be detected.
fr: La zone arrondie violette correspond, vue d'en haut, à la zone dans laquelle les objets sont détectés.

note: type: \t; header
en: category: <code><a cbot|int>int</a></code>
fr: catégorie: <code><a cbot|int>int</a></code>

note: type: Plain text
en: Direction that the radar is facing, in degrees. 
    <code>  0</code> -> radar is facing straight ahead
    <code>-90</code> -> radar is facing a quarter turn right
    <code> 90</code> -> radar is facing a quarter turn left
fr: Direction dans laquelle est dirigé le radar, en degrés.
    <code>  0</code> -> radar dirigé droit devant
    <code>-90</code> -> radar dirigé à gauche
    <code> 90</code> -> radar dirigé à droite

note: type: Plain text
en: Opening angle of the radar, in degrees.
fr: Angle d'ouverture du radar, en degrés.

note: type: Plain text
en: Minimum detection distance, in meters. Objects that are closer than the minimum distance will not be detected.
fr: Distance minimale de détection, en mètres. Avant cette distance, les objets sont ignorés.

note: type: Plain text
en: Maximum detection distance, in meters. Objects that are farther away than the maximum distance will not be detected.
fr: Distance maximale de détection, en mètres. Au delà de cette distance, les objets sont ignorés.

note: type: Plain text
en: Determines which way the objects are detected. With value <code>1</code>, returns the closest object found in the specified zone. With value <code>-1</code>, the farthest object in the zone will be returned.
fr: Sens dans lequel s'effectue la recherche. Avec la valeur <code>1</code>, on cherche de l'intérieur vers l'extérieur. Autrement dit, c'est l'objet le plus proche qui est trouvé. Avec <code>-1</code>, on cherche de l'extérieur vers l'intérieur. On trouvera donc l'objet le plus éloigné.

note: type: \t; header
en: Return value: <code><a cbot|object>object</a></code>
fr: Type du retour: <code><a cbot|object>objet (object)</a></code>

note: type: Plain text
en: Returns the first object found that corresponds to the specified category in the specified zone. If no object was found, returns the value <code><a cbot|null>null</a></code>.
fr: Objet trouvé le plus proche. La valeur <code><a cbot|null>null</a></code> indique que rien n'a été trouvé.

note: type: \t; header
en: Remark
fr: Remarque

note: type: Plain text
en: You do not have to give all the parameters. Here are two examples of instructions that are equivalent:
fr: Il n'est pas nécessaire de donner tous les paramètres. Voici deux exemples identiques:

note: type: Source code
en: 	radar(Titanium, 0, 360, 0, 1000);
    	radar(Titanium);  // equivalent
fr: 	<a cbot|radar>radar</a>(Titanium, 0, 360, 0, 1000);
    	<a cbot|radar>radar</a>(Titanium);  // identique

note: type: Source code
en: 	radar(Titanium, 0, 90, 0, 1000);
    	radar(Titanium, 0, 90);  // equivalent
fr: 	<a cbot|radar>radar</a>(Titanium, 0, 90, 0, 1000);
    	<a cbot|radar>radar</a>(Titanium, 0, 90);  // identique

note: type: Plain text
en: When one or more parameters are not specified, the default values indicated above are used instead; only the first parameter is compulsory.
    Generally, only the first parameter is specified: f. ex. <code>radar (AlienAnt)</code> detects the closest ant, wherever it may be.
fr: En fait, lorsque des paramètres manquent, ils prennent les valeurs par défaut indiquées plus haut. Le premier paramètre <code>catégorie</code> est obligatoire. Les cinq paramètres suivants sont facultatifs, et sont remplacés par <code>0</code>, <code>360</code>, <code>0</code>, <code>1000</code> et <code>1</code> s'ils manquent.
    Ceci est très utile. En effet, <code><a cbot|radar>radar</a>(XXX)</code> trouve l'objet le plus proche, où qu'il soit.

note: type: Plain text
en: Read one line from an open file in the files/ folder. This is a method of the <code><a cbot|file>file</a></code> class. This is the reason why we always write <code>handle.readln()</code>:
fr: L'instruction <c/>readln();<n/> lit une ligne de texte dans un fichier ouvert dans le dossier 'files/'. Cette instruction est une méthode de la classe <code><a cbot|file>file</a></code>. C'est la raison pour laquelle on n'écrit jamais <code>readln()</code> tout seul, mais <code>handle.readln()</code>:

note: type: Plain text
en: The file must have been opened for reading (<code>"r"</code>) with the <code><a cbot|open>open</a></code> instruction. <code>readln</code> returns the string containing the whole line but without the end of line characters 0x0D (CR) and 0x0A (LF).
fr: Le fichier doit être ouvert avec l'instruction <code><a cbot|open>open</a></code> et le mode <code>"r"</code> (lecture). L'instruction <code>readln</code> retourne une chaîne de caractères contenant la ligne lue, sans les deux caractères de fin de ligne 0x0D (CR) et 0x0A (LF).

note: type: Source code
en: <c/>string = handle.readln ( );<n/>
fr: <c/>string readln ( );<n/>

note: type: Source code
en: 	string s;
    	s = handle.readln();
    	if ( s == "abc" )
    	...
fr: 	string s;
    	s = readln();
    	if ( s == "abc" )
    	...

note: type: Plain text
en: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|writeln>writeln</a></code> and <code><a cbot|eof>eof</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|writeln>writeln</a></code> et <code><a cbot|eof>eof</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Retrieves an information from the closest <a object|exchange>information exchange post</a>.
fr: Reçoit une information de la <a object|exchange>station relais</a> la plus proche.

note: type: Plain text
en: Name of the information required from the exchange post. This name is a string: it must be written in quotation marks "".
fr: Nom de l'information à lire dans la station relais. Ce nom est une chaîne de caractères; il doit donc être donné entre guillemets "".

note: type: Plain text
en: Power of the receiver, which corresponds to maximal distance between the receiver and the exchange post. If the distance is longer, no information is received. Default value is 10 metres.
fr: Puissance du récepteur, qui correspond à la distance maximale jusqu'où peut être la station relais. La valeur par défaut est de 10 mètres.

note: type: Plain text
en: Value of the retrieved information. If no exchange post is close enough, or if the name of the requested information does not exist in the exchange post, the value <code>nan</code> is returned.
fr: Valeur de l'information lue. Si aucune station relais n'est à proximité, ou si le nom de l'information à lire n'existe pas dans la station, la valeur <code>nan</code> est retournée.

note: type: Plain text
en: <code><a cbot|send>send</a></code>, <code><a cbot|testinfo>testinfo</a></code> and <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|send>send</a></code>, <code><a cbot|testinfo>testinfo</a></code> et <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Recycles the derelict bot in front of the <a object|botrecy>recycler</a> into a <a object|titan>titanium cube</a>.
fr: Récupère l'épave placée devant le <a object|botrecy>robot</a>, qui sera transformée en <a object|titan>bloc de titane</a>.

note: type: Plain text
en: Zero if OK, or a value different from zero if an error occurred.
    <code>== 0 </code>the derelict bot has been recycled
    <code>!= 0 </code>error, no derelict bot could be recycled
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>épave recyclée
    <code>!= 0 </code>recyclage impossible

note: type: Source code
en: <c/>retobject ( number );<n/>
fr: <c/>retobject ( rank );<n/>

note: type: Plain text
en: Returns the object corresponding to the given number.
fr: Retourne un objet d'après son rang.

note: type: \t; header
en: number: <code><a cbot|int>int</a></code>
fr: rank: <code><a cbot|int>int</a></code>

note: type: Plain text
en: Number of the object, between 0 and n. "n" represents the total number of objects in the scene.
fr: Rang de l'objet, compris entre 0 et n. "n" représente ici le nombre total d'objets dans la scène.

note: type: Plain text
en: Object corresponding to the number. The return value <code><a cbot|null>null</a></code> means that no object corresponds to this number, because the number was too high, and there are not so many objects in the scene.
fr: Objet trouvé. La valeur <code><a cbot|null>null</a></code> indique que rien n'a été trouvé, par exemple lorsque le rang est trop grand.

note: type: Plain text
en: Returns from a function. Syntax:
fr: Cette instruction permet de sortir immédiatement d'une <a cbot|function>fonction</a>. Syntaxe:

note: type: Source code
en: void function ( )
    {
    	return;
    }
fr: <c/>void fonction ( )
    {
    	return;
    }

note: type: Plain text
en: If the <a cbot|function>function</a> has a return type, the <code>return</code> instruction must be followed by the value to be returned:
fr: Lorsqu'une <a cbot|function>fonction</a> rend un résultat, <code>return</code> doit être suivi de la valeur à retourner:

note: type: Source code
en: float Mean (float a, float b)
    {
    	return (a+b)/2;
    }
fr: float Moyenne (float a, float b)
    {
    	return (a+b)/2;
    }

note: type: Source code
en: string Sign (float a)
    {
    	if ( a > 0 )  return "positive";
    	if ( a < 0 )  return "negative";
    	return "null";
    }
fr: string Signe (float a)
    {
    	if ( a > 0 )  return "positif";
    	if ( a < 0 )  return "négatif";
    	return "nul";
    }

note: type: Source code
en: <c/>search ( category, position );<n/>
fr: <c/>search ( catégorie, pos );<n/>

note: type: \t; header
en: position: <code><a cbot|point>point</a></code>
fr: pos: <code><a cbot|point>point</a></code>

note: type: Plain text
en: <code>search</code> returns the object of the given category that is closest to the position indicated here.
fr: Position à partir de laquelle s'effectue la recherche.

note: type: Plain text
en: Characteristics of the object that has been found. The value <code><a cbot|null>null</a></code> means that no object of this category has been found.
fr: Objet trouvé. La valeur <code><a cbot|null>null</a></code> indique que rien n'a été trouvé.

note: type: Plain text
en: Sends an information to the closest <a object|exchange>information exchange post</a>.
fr: Envoie une information dans la <a object|exchange>station relais</a> la plus proche.

note: type: Plain text
en: Name of the information to be sent to the exchange post. This name is a string: it must be written in quotation marks "".
    If there is any information having this name, a new entry is created, as far as the total number of entries does not exceed 10. If there is already an information having this name, value is simply replaced by the new.
fr: Nom de l'information à écrire dans la station relais. Ce nom est une chaîne de caractères; il doit donc être donné entre guillemets "".
    S'il n'existe aucune information ayant ce nom, une nouvelle entrée est créée, pour autant que le nombre total d'entrées ne dépasse pas 10. S'il existe déjà une information ayant ce nom, la valeur est simplement remplacée par la nouvelle.

note: type: Plain text
en: Value of the information to be sent.
fr: Valeur de l'information à envoyer.

note: type: Plain text
en: Power of the transmitter, which corresponds to the maximal distance to where information can be the sent. Default value is 10 metres.
fr: Puissance de l'émetteur, qui correspond à la distance maximale jusqu'où peut être la station relais. La valeur par défaut est de 10 mètres.

note: type: Plain text
en: <code><a cbot|receive>receive</a></code>, <code><a cbot|testinfo>testinfo</a></code> and <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|receive>receive</a></code>, <code><a cbot|testinfo>testinfo</a></code> et <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Activates or deactivates the shield of the <a object|botshld>shielder</a>. You can of course move the shielder when the shield is active. It protects all objects that are inside the shielded sphere from enemy fire. The radius of the sphere can range between 10 and 25 meters.
fr: Déploie ou replie le bouclier du <a object|botshld>robot</a>. Lorsque le bouclier est déployé, il est possible d'avancer. Le bouclier protège de toutes les attaques <a object|mother>ennemies</a> dans un rayon compris entre 10 et 25 mètres.

note: type: Plain text
en: <code>1</code> activates the shield.
    <code>0</code> deactivates the shield
    A normal <a object|power>power cell</a> fully charged can maintain the shield active during 20 seconds. When the cell is empty, the shield deactivates.
fr: <code>1</code> déploie le bouclier.
    <code>0</code> replie le bouclier.
    Une <a object|power>batterie standard</a> à pleine charge permet de maintenir le bouclier pendant 20 secondes avec le rayon maximal de 25 mètres. Lorsque la batterie est à plat, le bouclier se replie.

note: type: Plain text
en: Radius of the shield, ranging between 10 and 25 meters.
fr: Rayon du bouclier, compris entre 10 et 25 mètres.

note: type: Plain text
en: The sizeof function lets you know the number of elements contained in an <a cbot|array>array</a>.
    That is the index of the last element plus one ("empty" elements are counted).
fr: L'instruction <code>sizeof(array)</code> permet de connaître le nombre d'éléments contenus dans un <a cbot|array>tableau</a>.
    En fait, c'est le dernier élément existant plus 1 (les cases "vides" sont comptées).

note: type: Source code
en: {
    	int a[12];
    	a[5] = 345;
    	message( sizeof(a) );  // will display 6
    }
fr: {
    	int a[12];
    	a[5] = 345;
    	message( sizeof(a) );  // affiche 6
    }

note: type: Plain text
en: In this example we have 6 elements in the array after <code>a[5]=345</code>. The non initialized elements <code>[0]</code>, <code>[1]</code>, <code>[2]</code>, <code>[3]</code> and <code>[4]</code> will be counted.
fr: Dans cet exemple, il y a 6 éléments dans le tableau après avoir fait <code>a[5]=345</code>. Les éléments non initialisés <code>[0]</code>, <code>[1]</code>, <code>[2]</code>, <code>[3]</code> et <code>[4]</code> sont comptés avec l'élément <code>[5]</code>.

note: type: Plain text
en: With multidimensionnal arrays you can get the size of a sub array:
fr: Avec un tableau à plusieurs dimensions, il est possible d'obtenir n'importe quelle taille:

note: type: Source code
en: float xy[][];  // 2 dimensionnal array
    xy[5][10] = 67;
    message( sizeof(xy)    );  // will display 6
    message( sizeof(xy[5]) );  // will display 11
fr: float xy[][];  // un tableau à 2 dimensions
    xy[5][10] = 67;
    message( sizeof(xy)    );  // affiche 6
    message( sizeof(xy[5]) );  // affiche 11

note: type: Plain text
en: Sounds the underground in front of the <a object|botsr>sniffer</a>. According to what raw materials were detected, the following objects will be created:
fr: Effectue un sondage du sous-sol devant le <a object|botsr>robot</a>. En fonction du sous-sol, les objets suivants sont créés:

note: type: Plain text
en: <code>TitaniumSpot</code>  ->  <a object|stonspot>Red cross</a>
    <code>UraniumSpot </code>  ->  <a object|uranspot>Yellow circle</a>
    <code>PowerSpot   </code>  ->  <a object|enerspot>Green cross</a>
fr: <code>TitaniumSpot</code>  ->  <a object|stonspot>Croix rouge</a>
    <code>UraniumSpot </code>  ->  <a object|uranspot>Rond jaune</a>
    <code>PowerSpot   </code>  ->  <a object|enerspot>Croix verte</a>

note: type: Plain text
en: Zero if everything is OK, or a value different from zero if an error occurred. 
    <code>== 0 </code>sounding performed
    <code>!= 0 </code>sounding impossible
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>sondage effectué
    <code>!= 0 </code>sondage impossible

note: type: Plain text
en: Determines the position of the nearest free space around a given position.
fr: Calcule un emplacement libre autour d'un point central.

note: type: \t; header
en: center: <code><a cbot|point>point</a></code> (default: bot position)
fr: center: <code><a cbot|point>point</a></code> (position du robot par défaut)

note: type: Plain text
en: Desired position of the free space.
fr: Position centrale autour de laquelle la recherche est effectuée.

note: type: \t; header
en: rmin: <code><a cbot|float>float</a></code> (default value: <code>8</code>)
fr: rmin: <code><a cbot|float>float</a></code> (valeur par défaut <code>10</code>)

note: type: Plain text
en: Minimum distance from the desired position.
fr: Rayon minimal à partir duquel la recherche est effectuée.

note: type: \t; header
en: rmax: <code><a cbot|float>float</a></code> (default value: <code>50</code>)
fr: rmax: <code><a cbot|float>float</a></code> (valeur par défaut <code>50</code>)

note: type: Plain text
en: Maximum distance from the desired position.
fr: Rayon maximal après lequel la recherche est stoppée.

note: type: \t; header
en: dist: <code><a cbot|float>float</a></code> (default value: <code>4</code>)
fr: dist: <code><a cbot|float>float</a></code> (valeur par défaut <code>4</code>)

note: type: Plain text
en: Required distance between two free spaces.
fr: Distance requise entre deux emplacements libres.

note: type: \t; header
en: Return: <code><a cbot|point>point</a></code>
fr: Type du retour: <code><a cbot|point>point</a></code>

note: type: Plain text
en: Position of the free space.
fr: Position libre.

note: type: \b; header
en: Instruction <code>static</code> (for specialists)
fr: Instruction <code>static</code> (pour spécialistes)

note: type: Plain text
en: <a cbot|class>Class</a> members declared with <code>static</code> are shared between all instances of the class.
fr: Les éléments d'une <a cbot|class>classe</a> précédés du mot <code>static</code> sont partagés en commun avec toutes les instances de cette classe. C'est à dire qu'une valeur écrite par l'une des instances sera lisible par toutes les autres.

note: type: Source code
en: public class MyClass
    {
    	static int nb = 1;
    	static string [ ] list = null;
    }
    void Test ()
    {
    	MyClasse item1();
    	MyClasse item2();
    	item1.nb = 3;
    	item1.list[item1.nb] = "Hello";
    	message( item2.list[item2.nb] ); // display "Hello"
    }
fr: public class MaClass
    {
    	static int nb = 1;
    	static string [ ] liste = null;
    }
    void Test ()
    {
    	MaClasse item1();
    	MaClasse item2();
    	item1.nb = 3;
    	item1.liste[item1.nb] = "Hello";
    	message( item2.liste[item2.nb] ); // affiche "Hello"
    }

note: type: Plain text
en: <code>Static</code> members can be declared <code><a cbot|private>private</a></code> so they will be only acessible from within class members (including constructors and destructors).
fr: Les éléments <code>static</code> peuvent également être déclarés comme <code><a cbot|private>private</a></code>. Dans ce cas, ces éléments ne sont accessibles que dans les méthodes de la classe (constructeur et destructeur inclus).

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|synchro>synchronized</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|synchro>synchronized</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Find a substring in a string and returns the position of the first substring found or <a cbot|nan>nan</a> if the substring has not been found.
fr: Cette instruction cherche une sous-chaîne dans une chaîne et retourne la position du début de la sous-chaîne. Si aucune correspondance n'est trouvée, la fausse "valeur"<a cbot|nan>nan (Not A Number)</a> est retournée.

note: type: Plain text
en: String we are searching in.
fr: Chaîne dans laquelle on effectue la recherche.

note: type: Plain text
en: Substring we are searching for.
fr: Sous-chaîne recherchée.

note: type: Source code
en: <c/>	int pos = strfind("abcdef", "ab"); // pos will be 0
    	int pos = strfind("abcdef", "de"); // pos will be 3
    	int pos = strfind("abcdef", "xy"); // pos will be <a cbot|nan>nan</a>
fr: <c/>	int pos = strfind("abcdef", "ab");  // pos vaut 0
    	int pos = strfind("abcdef", "de");  // pos vaut 3
    	int pos = strfind("abcdef", "xy");  // pos vaut <a cbot|nan>nan</a>

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Use a variable of this type for storing characters or strings.
fr: Ce type permet de représenter une chaîne de caractères, qui contiendra quelques caractères, ou toute une phrase.

note: type: Plain text
en: For example:
fr: Par exemple:

note: type: Source code
en: <c/>	"Hello!"
    	"This is a string"
    	"x"
    	""  // empty string
fr: <c/>"bonjour"
    "Ceci est une chaîne"
    "x"
    ""  // chaîne vide

note: type: Plain text
en: You can append two strings with the <code>+</code> operator :
fr: Pour appondre deux chaînes, on utilise l'opérateur <code>+</code>:

note: type: Source code
en: <c/>	"Good morning," + " " + "Sir"
fr: <c/>"bonjour" + " " + "Monsieur"

note: type: Plain text
en: Returns the string:
fr: Donne la chaîne:

note: type: Source code
en: <c/>	"Good morning, Sir"
fr: <c/>"bonjour Monsieur"

note: type: Plain text
en: If you want to put a quotation mark (") or a backslash (\) in a string you must write:
fr: Pour mettre un guillemet ou un slash inversé dans une chaîne, il faut écrire:

note: type: Source code
en: <c/>"This is \"very\" important"
fr: <c/>"Ceci est \"très\" important"

note: type: Plain text
en: <n/>which will result in the string <c/> This is "very" important.
fr: <n/>, ce qui donnera la chaîne de caractères <c/> Ceci est "très" important.

note: type: Plain text
en: <n/>will result in <c/>%user%\ant.txt
fr: <n/>, ce qui donnera <c/>%user%\ant.txt

note: type: Plain text
en: Following instructions can be used with strings:
    <code><a cbot|strlen>strlen</a>     </code>Get string length
    <code><a cbot|strleft>strleft</a>    </code>Extract left part
    <code><a cbot|strright>strright</a>   </code>Extract right part
    <code><a cbot|strmid>strmid</a>     </code>Extract center part
    <code><a cbot|strfind>strfind</a>    </code>Find a substring.
    <code><a cbot|strval>strval</a>     </code>Convert string to number
    <code><a cbot|strupper>strupper</a>   </code>Convert to upper case
    <code><a cbot|strlower>strlower</a>   </code>Convert to lower case
fr: Les instructions suivantes sont utiles pour gérer les chaînes de caractères:
    <code><a cbot|strlen>strlen</a>     </code>Longueur d'une chaîne.
    <code><a cbot|strleft>strleft</a>    </code>Extrait la partie gauche.
    <code><a cbot|strright>strright</a>   </code>Extrait la partie droite.
    <code><a cbot|strmid>strmid</a>     </code>Extrait la partie centrale.
    <code><a cbot|strfind>strfind</a>    </code>Cherche une sous-chaîne.
    <code><a cbot|strval>strval</a>     </code>Convertit en un nombre.
    <code><a cbot|strupper>strupper</a>   </code>Convertit en majuscules.
    <code><a cbot|strlower>strlower</a>   </code>Convertit en minuscules.

note: type: Plain text
en: Extracts the first (that is, leftmost) characters from a string.
fr: Cette instruction extrait la partie gauche d'une chaîne de caractères.

note: type: Plain text
en: Number of characters to be extracted.
fr: Nombre de caractères à extraire depuis la droite.

note: type: Source code
en: <c/>	string s = strleft("abcdef", 2);  // s is "ab"
    	string s = strleft("abc", 10);  // s is "abc"
fr: <c/>	string s = strleft("abcdef", 2);  // s vaut "ab"
    	string s = strleft("abc", 10);  // s vaut "abc"

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Get the length of a string.
fr: Cette instruction retourne la longueur d'une chaîne de caractères.

note: type: Source code
en: <c/>	int len = strlen("abc");  // len is 3
    	int len = strlen("");  // len is 0
    	if ( strlen(s) == 0 )  // is string empty ?
fr: <c/>	int len = strlen("abc");  // len vaut 3
    	int len = strlen("");  // len vaut 0
    	if ( strlen(s) == 0 )  // chaîne s vide ?

note: type: Plain text
en: <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Convert all characters in a string to lowercase.
fr: Cette instruction convertit tous les caractères d'une chaîne en minuscules.

note: type: Source code
en: <c/>	string s = strlower("Abc");  // s is "abc"
fr: <c/>	string s = strlower("Abc");  // s vaut "abc"

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Extracts a substring of a given length starting at a given position from a string.
fr: Cette instruction extrait la partie centrale d'une chaîne de caractères.

note: type: Plain text
en: The index of the first character that is to be included in the extracted substring.
fr: Position du premier caractère à extraire depuis la gauche.

note: type: Source code
en: <c/>	string s = strmid("abcdef", 1, 2);  // s is "bc"
    	string s = strmid("abcdef", 4, 5);  // s is "ef"
    	string s = strmid("abcdef", 9, 2);  // s is ""
fr: <c/>	string s = strmid("abcdef", 1, 2);  // s vaut "bc"
    	string s = strmid("abcdef", 4, 5);  // s vaut "ef"
    	string s = strmid("abcdef", 9, 2);  // s vaut ""

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Extracts the last (that is, rightmost) characters from a string.
fr: Cette instruction extrait la partie droite d'une chaîne de caractères.

note: type: Source code
en: <c/>	string s = strright("abcdef", 2);  // s is "ef"
    	string s = strright("abc", 10);  // s is "abc"
fr: <c/>	string s = strright("abcdef", 2);  // s vaut "ef"
    	string s = strright("abc", 10);  // s vaut "abc"

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Convert all characters in a string to uppercase.
fr: Cette instruction convertit tous les caractères d'une chaîne en majuscules.

note: type: Source code
en: <c/>	string s = strupper("Abc");  // s is "ABC"
fr: <c/>	string s = strupper("Abc");  // s vaut "ABC"

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strval>strval</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Convert a string to a number. Don't confuse the string <code>"45"</code> that contains actually the two characters <code>4</code> and <code>5</code> and the number <code>45</code>.
fr: Cette instruction convertit une chaîne représentant un nombre en un nombre. Il ne faut pas confondre la chaîne <code>"45"</code> qui contient les deux caractères <code>4</code> et <code>5</code> et le nombre <code>45</code>.

note: type: Source code
en: <c/>	string s = "45"+"12";  // s contains "4512"
    	float  n =  45 + 12;   // n contains 67
fr: <c/>	string s = "45"+"12";  // s vaut "4512"
    	float  n =  45 + 12;   // n vaut 67

note: type: Source code
en: <c/>	float n = strval("1.23");     // n is 1.23
    	float n = strval("12abc45");  // n is 12
    	float n = strval("abc");      // n is 0
    	float n = strval("100")+2;    // n is 102
fr: <c/>	float n = strval("1.23");     // n vaut 1.23
    	float n = strval("12abc45");  // n vaut 12
    	float n = strval("abc");      // n vaut 0
    	float n = strval("100")+2;    // n vaut 102

note: type: Plain text
en: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|strlen>strlen</a></code>, <code><a cbot|strleft>strleft</a></code>, <code><a cbot|strright>strright</a></code>, <code><a cbot|strmid>strmid</a></code>, <code><a cbot|strfind>strfind</a></code>, <code><a cbot|strupper>strupper</a></code>, <code><a cbot|strlower>strlower</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: \b; header
en: Instruction <code>synchronized</code> (for specialists)
fr: Instruction <code>synchronized</code> (pour spécialistes)

note: type: Plain text
en: A <a cbot|class>class</a> method can be declared <code>synchronized</code>. This is to make sure that the method is never being executed by more than one bot at the same time.
fr: Les méthodes d'une <a cbot|class>classe</a> peuvent être déclarées <code>synchronized</code>. Dans ce cas, on assure que deux exécutions de ces méthodes ne peuvent pas être simultanées.

note: type: Plain text
en: The following example illustrates the problem:
fr: Considérez par exemple, la classe absurde suivante:

note: type: Source code
en: class blocking
    {
    	static int nb = 33;
    	synchronized int inc( )
    	{
    		int val = nb;
    		wait ( 2 );  // wait 2 sec.
    		nb = nb + 1;
    		return val;
    	}
    }
fr: public class Bloquage
    {
    	static int nb = 33;
    	synchronized inc( )
    	{
    		int val = nb;
    		wait ( 2 );  // attendre 2 secondes pour voir...
    		nb = nb + 1;
    		return val;
    	}
    }

note: type: Plain text
en: What happens if two bots execute the <code>inc</code> method at the same time?
    Both of them will execute <code>val=nb</code> and wait 2 seconds so both of them will have <code>val=33</code>. With <code>synchronized</code> the first bot starts execution with <code>val=33</code> and then waits 2 seconds and returns. Only once the first bot has returned from the <code>inc</code> method, the second bot will be allowed to enter the <code>inc</code> method and therefore the second bot will always have <code>val=34</code>.
fr: Que se passe-t-il, sans le mot <code>synchronized</code>, si deux robots exécutent la méthode <code>inc</code> à peu près en même temps?
    Tous les deux vont faire <code>val=nb</code> avant d'attendre 2 secondes, donc les deux auront <code>val=33</code>.
    Puis tous les deux vont incrémenter <code>nb</code>, qui va passer à <code>35</code>.
    Avec <code>synchronized</code>, le premier des robots va commencer l'exécution avec <code>val=33</code>, et attendre les 2 secondes, alors que le second robot va attendre. Lorsque le premier robot va poursuivre, il met <code>nb=34</code> et quitte, alors seulement le second robot va pouvoir commencer la fonction avec <code>val=34</code> et finira en mettant <code>35</code>.

note: type: Plain text
en: You can have more than one synchronized method in your <a cbot|class>class</a> in order to prevent simultaneous execution across more than one method. In other words: as long as a bot's program is inside a synchronized method, no other bot can enter any synchronized method of the same class.
fr: Il est possible d'avoir plus d'une méthode synchrone par <a cbot|class>class</a> pour prévenir l'exécution simultanée à travers plusieurs méthodes. En d'autres termes: tant que le programme d'un robot est en train d'exécuter une méthode synchrone, aucun autre robot ne peut exécuter aucune autre méthode synchrone de la même classe.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|static>static</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|static>static</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: \b; header
en: Semicolon
fr: Le point-virgule

note: type: Plain text
en: Always use a semicolon <c/>;<n/> after a simple expression. For example:
fr: Le point-virgule <c/>;<n/> termine une expression simple. Par exemple:

note: type: Source code
en: 	int counter = 0;
fr: 	int compteur = 0;

note: type: Plain text
en: However, after a <a cbot|bloc>bloc</a>, never put a semicolon:
fr: Il n'est pas nécessaire pour terminer un <a cbot|bloc>bloc</a>:

note: type: Source code
en: 	{
    		float dist;
    		dist = distance(p1, p2);
    	} <n/>// no semicolon here!<c/>
fr: 	{
    		float dist;
    		dist = distance(p1, p2);
    	} <n/>// pas de ; ici!<c/>

note: type: Plain text
en: Do not use a semicolon either immediately after the instructions <code><a cbot|while>while</a></code>, <code><a cbot|if>if</a></code> or <code><a cbot|for>for</a></code>:
fr: Il ne doit jamais être utilisé après un <code><a cbot|while>while</a></code>, un <code><a cbot|if>if</a></code> ou un <code><a cbot|for>for</a></code>:

note: type: Source code
en: 	if ( a < b ) <n/>// no semicolon here!<c/>
    	{
    		b = 100-a;
    	}
fr: 	if ( a < b ) <n/>// surtout pas de ; ici<c/>
    	{
    		b = 100-a;
    	}

note: type: Plain text
en: An instruction is always ended by a semicolon, and not by the end of the line. So you can very well put several instructions on the same line:
fr: Une instruction est terminée par le point-virgule, et non par la fin de la ligne. Vous pouvez donc très bien mettre plusieurs instructions sur la même ligne:

note: type: Plain text
en: Is equivalent to:
fr: Est équivalent à:

note: type: Plain text
en: Tests if an information exists in the closest <a object|exchange>information exchange post</a>.
fr: Teste si une information existe dans la <a object|exchange>station relais</a> la plus proche.

note: type: Plain text
en: Name of the information to be tested in the exchange post. This name is a string: it must be written in quotation marks "".
fr: Nom de l'information à tester dans la station relais. Ce nom est une chaîne de caractères; il doit donc être donné entre guillemets "".

note: type: Plain text
en: Power of the transmitter, which corresponds to the maximal distance between the transmitter and the exchange post. If the distance is longer, the function returns <code>false</code>. Default value is 10 metres.
fr: Puissance de l'émetteur, qui correspond à la distance maximale jusqu'où peut être la station relais. La valeur par défaut est de 10 mètres.

note: type: \t; header
en: Return: <code><a cbot|bool>bool</a></code>
fr: Type du retour: <code><a cbot|bool>bool</a></code>

note: type: Plain text
en: Return <code>true</code> if the information exists. Return and <code>false</code> if the information does not exist or if the receiver is too far away from the exchange post.
fr: Retourne <code>true</code> si l'information existe (dans une station relais suffisamment proche) et <code>false</code> dans le cas contraire.

note: type: Plain text
en: <code><a cbot|receive>receive</a></code>, <code><a cbot|send>send</a></code> and <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|receive>receive</a></code>, <code><a cbot|send>send</a></code> et <code><a cbot|delinfo>deleteinfo</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: Occasionally, a <a cbot|class>class</a> method needs to know the reference to the instance it is acting upon. For example the instance might want to pass it's own reference to another function. An implicit reference name <code>this</code> is available to methods and <code>this</code> is a reference to the current instance.
fr: A l'intérieur d'une méthode d'une <a cbot|class>classe</a>, il est possible d'utiliser le mot <code>this</code> qui est une référence à l'instance courante. La plupart du temps, la référence <code>this</code> est utilisée lorsqu'on désire passer une référence à l'instance courante comme paramètre à une fonction.

note: type: Source code
en: public class MyClass
    {
    	int    m_int;
    	string m_str;
    	void MyFunction()
    	{
    		OtherFunction(this);
    		m_int = 2;
    	}
    }
    
    void OtherFunction(MyClass obj)
    {
    	message(obj.m_str);
    }
    
    extern void object::Test()
    {
    	MyClass item();
    	item.m_str = "Hello";
    	item.MyFunction();  // display "Hello"
    }
fr: public class MyClass
    {
    	int    m_int;
    	string m_str;
    	void MyFunction()
    	{
    		OtherFunction(this);
    		m_int = 2;
    	}
    }
    
    void OtherFunction(MyClass obj)
    {
    	message(obj.m_str);
    }
    
    extern void object::Test()
    {
    	MyClass item();
    	item.m_str = "Salut";
    	item.MyFunction();  // affiche "Salut"
    }

note: type: Plain text
en: You can also put <code>this</code> before a field name in a method but this is not necessary. In the example above in the method <code>MyFunction()</code> following two lines have strictly the same meaning:
fr: Il est aussi possible d'écrire <code>this.</code> devant un nom de champ, ce qui est plus explicite mais pas nécessaire. Dans l'exemple ci-dessus, nous pouvons écrire dans la fonction <code>MyFunction()</code>:

note: type: Source code
en: 	m_int = 2;
    	this.m_int = 2;  // identical
fr: 	m_int = 2;
    	this.m_int = 2;  // identique

note: type: Plain text
en: In a method of the <code><a cbot|object>object</a></code> class, you can also use <code>this.</code> before a fieldname.
fr: Dans une fonction de la classe <code><a cbot|object>object</a></code>, il est possible d'accéder à la position du robot, à son orientation, etc. En fait, on accède ainsi implicitement à l'instance du robot. Il est aussi possible d'écrire <code>this.</code> devant un nom de champ, ce qui est plus explicite:

note: type: Source code
en: extern void object::Display()
    {
    	message(orientation);
    	message(this.orientation); // same thing but
    	                           // more explicit
    }
fr: extern void object::Display()
    {
    	message(orientation);
    	message(this.orientation);  // identique mais plus explicite
    }

note: type: Plain text
en: However if a field name is hidden by a parameter declaration or a variable declaration you must use <code>this</code>. In the following example the name <code>value</code> of the parameter is the same as the name of the field <code>value</code> of the <a cbot|class>class</a> <code>MyClass</code>, we must therefore write <code>this.value</code> in order to distinguish the field from the parameter.
fr: Il est cependant nécessaire d'utiliser <code>this</code> lorsque le nom d'un champ est caché par une déclaration de variable ou de paramètre. L'exemple suivant montre une <a cbot|class>classe</a> appelée <code>MaClasse</code> avec une méthode <code>Put</code>. Comme le nom <code>value</code> du paramètre est le même que le nom du champ de la classe, il est nécessaire d'utiliser <code>this.value</code> pour utiliser le champ de la classe:

note: type: Source code
en: public class MyClass
    {
    	int  value;
    	void Put( int value )
    	{
    		this.value = value;
    	}
    }
fr: public class MaClasse
    {
    	int  value;
    	void Put( int value )
    	{
    		this.value = value;
    	}
    }

note: type: Plain text
en: Activates the weapon system of the <a object|bottump>thumper</a>, that turns ants and spiders belly up and makes them completely harmless for a while.
fr: Activer le système d'armement du <a object|bottump>robot secoueur</a>, cela fera trembler le sol et retournera les fourmis et les araignées sur le dos : les rendant complètement inoffensives pendant un certain temps.

note: type: Plain text
en: Zero if everything is OK, a value different from zero if an error occurred. 
    <code>== 0 </code>Thumping performed
    <code>!= 0 </code>Operation impossible
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>terrain secoué
    <code>!= 0 </code>opération impossible

note: type: Plain text
en: Returns the altitude of the ground at a give position. The altitude zero corresponds to sea level. A negative value indicates that at this position ground is covered with water.
fr: Retourne l'élévation d'un point quelconque du terrain. Le niveau zéro correspond toujours au niveau de la mer. Une valeur négative indique donc que le point en question se trouve sous l'eau.

note: type: Plain text
en: Coordinates of the position whose altitude you want to know.
fr: Coordonnée de la position dont on désire connaître l'élévation.

note: type: Plain text
en: Altitude of the ground at the given position.
fr: Elévation du point donné en entrée.

note: type: Plain text
en: This value means that a condition is true; it is one of the two values that a <a cbot|bool>boolean</a> <a cbot|var>variable</a> can take.
fr: Cette valeur signifie "vrai" pour une <a cbot|var>variable</a> <a cbot|bool>booléenne</a>.

note: type: Plain text
en: Use the instruction <c/>turn();<n/> to instruct the bot to perform a rotation on itself of a certain number of degrees.
fr: Utilisez l'instruction <c/>turn();<n/> pour faire tourner le robot d'un certain nombre de degrés sur lui-même.

note: type: Plain text
en: 90 degreed means a quarter turn, 180 degrees means a half turn. A positive angle will perform a counterclockwise rotation, a negative angle means a clockwise rotation. Here are some examples with <c/>turn();<n/>:
fr: 90 degrés signifie un quart de tour, 180 degrés signifie un demi-tour, 360 degrés signifie un tour complet. Voici quelques exemples avec <c/>turn();<n/>:

note: type: Plain text
en: <c/>turn(90);<n/>  quarter turn to the left
    <c/>turn(-90);<n/> quarter turn to the right (negative angle)
    <c/>turn(180);<n/> half turn
fr: <c/>turn(90);<n/>  quart de tour à gauche
    <c/>turn(-90);<n/> quart de tour à droite (angle négatif)
    <c/>turn(180);<n/> demi-tour

note: type: Plain text
en: In order to turn the bot towards an object found with the instruction <c/><a cbot|radar>radar</a>();<n/>, you must calculate the rotation angle with the instruction <code><a cbot|direct>direction</a>()</code>:
fr: Pour se tourner vers un objet trouvé avec l'instruction <c/><a cbot|radar>radar</a>();<n/>, il faut calculer l'angle de la rotation avec l'instruction <code><a cbot|direct>direction</a>()</code>:

note: type: Source code
en: 	item = <a cbot|radar>radar</a>(AlienSpider);
    	turn(<a cbot|direct>direction</a>(item.position));
fr: 	chose = <a cbot|radar>radar</a>(AlienSpider);
    	turn(<a cbot|direct>direction</a>(chose.position));

note: type: Plain text
en: After these lines, just fire the cannon, and there is one hostile element less.
fr: Puis il suffit de faire feu, et il y a un élément hostile en moins.

note: type: Plain text
en: Turns the bot with a given angle, right or left, without moving either forward or backward.
fr: Tourne d'un certain angle, à gauche ou à droite, sans avancer ni reculer.

note: type: Plain text
en: Angle of the required rotation, in degrees. A positive value turns left, a negative value turns right. <code>turn(180)</code> turns round completely.
fr: Angle de la rotation désirée, en degrés. Une valeur positive fait tourner à gauche et une valeur négative à droite. 180 signifie un demi-tour.

note: type: Plain text
en: Zero if everything is OK, or a value different from zero if an error occurred. 
    <code>== 0 </code>rotation performed
    <code>!= 0 </code>rotation impossible
fr: Zéro si tout est ok, ou valeur non nulle si une erreur est intervenue.
    <code>== 0 </code>rotation effectuée
    <code>!= 0 </code>rotation impossible

note: type: \b; header
en: Variable types
fr: Les types des variables

note: type: Plain text
en: When you define a <a cbot|var>variable</a>, you must give two elements:
fr: Une <a cbot|var>variable</a> est décrite par trois éléments:

note: type: Bullet: '1)'
en: a name
fr: Un nom.

note: type: Bullet: '2)'
en: a type
fr: Le type du contenu.

note: type: Plain text
en: Once you defined a variable, you can use it to put information in it. However, the information that a variable can contain must always be of the correct type: a variable of type <a cbot|float>float</a> can not contain a string, etc.
fr: Une fois la variable définie, elle peut être utilisée pour stocker de l'information. Cependant, l'information contenue dans une variable doit toujours être du bon type: une variable de type <a cbot|float>float</a> ne peut pas contenir de chaîne de caractères, etc.

note: type: Plain text
en: For a whole number (12, -500, etc.).
fr: Pour un nombre entier (12, -500, etc.).

note: type: Plain text
en: For a real number (12, 3.14, 0.2, -99.98, etc.).
fr: Pour un nombre réel (3.14, 0.2, -99.98, etc.).

note: type: Plain text
en: For a boolean variable, that can only take the values <code>true</code> or <code>false</code>.
fr: Pour un variable booléenne valant vrai ou faux (true ou false).

note: type: Plain text
en: For texts ("Hello!", "No object found", etc.)
fr: Pour une chaîne de caractères ("bonjour", "le chat", etc.)

note: type: Plain text
en: For the coordinates of a point in space; a variable of this type consists of three parts named x, y and z.
fr: Pour une coordonnée dans l'espace x,y,z.

note: type: Plain text
en: A variable of this type contains the information about an object (bot, building, enemy, etc.).
fr: Pour décrire un objet (robot, bâtiment, etc.).

note: type: Plain text
en: This type is an "empty type", that you use when you do not want to specify a type.
fr: Pour indiquer "rien".

note: type: \b; header
en: Variables
fr: Les variables

note: type: Plain text
en: A variable is like a box, where you can put some information. The content of the variable can change during the execution of the program.
fr: Une variable est un nom qui repère un emplacement en mémoire, dont on peut faire évoluer la valeur durant l'exécution du programme.

note: type: Plain text
en: For example, you can use a variable to count the number of titanium ore units that the grabber has collected and carried to the converter. First, you must find a name for it: the name should not be too long, but explain by itself what the variable is used for. Let's call it <code>countTit</code>. This variable must contain only whole numbers, so choose the type <code>int</code>. At the beginning of the program, you must declare the variable. Then you put the value <code>0</code> into the variable, and every time you grab a titanium ore, you increase the variable by <code>1</code>. At every moment, the variable contains the number of titanium ore units that the grabber collected.
fr: Par exemple, vous pouvez utiliser une variable pour compter le nombre d'unités de minerai de titane que le préhenseur a collectées et transportées à la raffinerie. Tout d'abord, vous devez lui trouver un nom : le nom ne doit pas être trop long, mais expliquer par lui-même à quoi sert la variable. Appelons-le <code>cptTit</code>. Cette variable ne doit contenir que des nombres entiers, choisissez donc le type <code>int</code>. Au début du programme, vous devez déclarer la variable. Ensuite, vous l'initialisez en mettant la valeur <code>0</code> dans la variable, et chaque fois que vous saisissez un minerai de titane, vous augmentez la variable de <code>1</code>. A chaque instant, la variable contient le nombre d'unités de minerai de titane que le préhenseur a récupéré.

note: type: Plain text
en: For the declaration of the variable, write the following line: 
    <c/><s/>	int  countTit;<n/>
fr: La déclaration de la variable <code>compteur</code> s'écrit avec:
    <c/><s/>	int  cptTit;<n/>

note: type: Plain text
en: To put <code>0</code> into the variable, write:
    <c/><s/>	countTit = 0;<n/>
fr: L'initialisation à zéro se fait avec:
    <c/><s/>	cptTit = 0;<n/>

note: type: Plain text
en: At every titanium ore grabbed, write:
    <c/><s/>	countTit = countTit + 1<n/>
fr: À chaque minerai de titane trouvé et saisi, vous l'augmentez de 1 avec:
    <c/><s/>	cptTit++;	// équivalent à cptTit = cptTit+1;<n/>

note: type: Plain text
en: You have much freedom in the choice of the name for a variable, you can call them by any name, f. ex.: <code>dist</code>, <code>direct</code>, <code>p2</code>, <code>a</code>, <code>x</code>, <code>nothing_2_shoot_at</code>, etc.
    A variable name must always begin with a letter. It can be followed by any combination of letters, digits or the underscore character <code>_</code>. You can of course not use the keywords of the CBOT language like <code><a cbot|for>for</a></code>, <code><a cbot|while>while</a></code>, <code><a cbot|break>break</a></code>, <code><a cbot|continue>continue</a></code>, <code>do</code>, etc.
    You should be careful about the choice of the names that you give to variables; writing a program can become very difficult if you forget the names of variables or if you do not remember what they are used for. Elaborate your own system to find variable names, and do not use names like <code>Bmo45</code>, <code>a</code> or <code>tgBinX</code>.
fr: Notez bien que le nom <code>cptTit</code> n'est qu'un exemple. Vous avez pratiquement toute liberté pour inventer le nom qui vous convient le mieux.Par exemple: <code>dist</code>, <code>direct</code>, <code>p2</code>, <code>a</code>, <code>x</code>, <code>chute_2_pierre</code>, etc.
    Le nom doit commencer par une lettre. Il peut contenir ensuite des lettres ou des chiffres, ainsi que le caractère souligné. Par contre, vous ne pouvez pas utiliser les mots-clés réservés du langage, tels que <code><a cbot|for>for</a></code>, <code><a cbot|while>while</a></code>, <code><a cbot|break>break</a></code>, <code><a cbot|continue>continue</a></code>, <code>do</code>, etc.
    On peut utiliser des noms anglais (plus courts et internationaux), ou plutôt des noms français, on peut aussi utiliser des abréviations, cela n'a pas d'importance. Ce qu'il faut, c'est que le nom exprime clairement à quoi sert la variable. A vous de bien choisir votre convention de nommage. Ne soyez pas trop cryptiques : <code>Bmo45</code>, <code>a</code>, <code>tgbin</code> ne sont pas de très bons exemples !

note: type: Plain text
en: In the example above, the keyword <code>int</code> indicates that this variable can contain only whole numbers, which is adequate to counting objects. If you want to measure a distance, better use a variable that can contain also real numbers, with a fractional part (like 3.45 or 0.034): in this case, use the type <code>float</code>.
fr: Dans l'exemple ci-dessus, le mot-clé <code>int</code> indique que cette variable ne peut contenir que des nombres entiers, ce qui est suffisant pour compter les objets. Si vous voulez mesurer une distance, mieux vaut utiliser une variable qui peut aussi contenir des nombres réels, avec une partie fractionnaire (comme 3.45 ou 0.034) : dans ce cas, utilisez le type <code>float</code>.

note: type: Plain text
en: In fact, a variable is made up of three parts:
fr: En fait, une variable est décrite par trois éléments:

note: type: Bullet: '1)'
en: the name,
fr: Son nom,

note: type: Bullet: '2)'
en: the type of the information stored inside,
fr: Le type du contenu,

note: type: Bullet: '3)'
en: the content, i.e. the information itself.
fr: Le contenu.

note: type: \t; header
en: the name
fr: Le nom

note: type: Plain text
en: You need the name to be able to distinguish the different variables from each other.
fr: Le nom permet d'accéder au contenu.

note: type: \t; header
en: the type
fr: Le type

note: type: Plain text
en: The <a cbot|type>type</a> determines what kind of information the variable can contain. According to the type, a variable can contain a whole number, a real number, a string, the coordinates of a point, information about an object, etc. 
    Here is a list of the most common variable types:
fr: Le <a cbot|type>type</a> détermine ce que contient la variable. En effet, une variable peut contenir un nombre entier, un nombre réel, une chaîne de caractères, une coordonnée d'un point, etc.
    Les types les plus courants sont:

note: type: Bullet: 'o'
en: <code><a cbot|int>int</a></code> for a whole number (12, -500, etc.)
fr: <code><a cbot|int>int</a></code> pour un nombre entier (12, -500, etc.)

note: type: Bullet: 'o'
en: <code><a cbot|float>float</a></code> for a real number (3.14, 0.2, -99.98, etc.)
fr: <code><a cbot|float>float</a></code> pour un nombre réel (3.14, 0.2, -99.98, etc.)

note: type: Bullet: 'o'
en: <code><a cbot|string>string</a></code> for a character string ("Hello!", "No object found", etc.)
fr: <code><a cbot|string>string</a></code> pour une chaîne de caractères ("bonjour", "le chat", etc.)

note: type: Bullet: 'o'
en: <code><a cbot|point>point</a></code> for a x,y,z-coordinate in space
fr: <code><a cbot|point>point</a></code> pour une coordonnée dans l'espace x,y,z

note: type: Bullet: 'o'
en: <code><a cbot|object>object</a></code> for information about an object (bot, building, etc.)
fr: <code><a cbot|object>object</a></code> pour décrire un objet (robot, bâtiment, etc.)

note: type: \t; header
en: The content
fr: Le contenu

note: type: Plain text
en: The content of a variable is an information of the kind specified in the type. It can change during the execution of the program.
fr: Le contenu d'une variable peut être une ou plusieurs valeurs, une chaîne de caractères ou une coordonnée, selon le type.

note: type: Plain text
en: Once you declared a variable, it still does not contain any value. Before you can use it, you must put a value inside: 
    <c/><s/>	int  i, j;
fr: Lorsqu'une variable est déclarée, elle n'a encore aucune valeur. Avant de l'utiliser, il faut obligatoirement lui assigner une valeur:
    <c/><s/>	int  i, j;

note: type: Source code
en: 	j = 25;  // j takes the value 25
    	j = i;   // can not write this, because i has got no content yet.
fr: 	j = 25;  // j prend la valeur 25
    	j = i;   // impossible, car i est inconnu

note: type: Plain text
en: You can also declare a variable and put a value inside in the same line, writing: 
    <c/><s/>	int  countTit = 0;
fr: Notez que vous pouvez très bien déclarer une variable et l'initialiser directement avec:
    <c/><s/>	int  i=0;

note: type: Plain text
en: When you assign a value to a variable with the equals sign <code>=</code>, the value on the right side is copied into the value on the left side. Consider the following example: 
    <c/><s/>	int  i, j;
fr: Notez que l'assignation <code>=</code> copie la valeur de l'<a cbot|expr>expression</a> de droite dans la variable de gauche. Soit l'exemple suivant:
    <c/><s/>	int  i, j;

note: type: Source code
en: 	i = 5+2;  // i takes the value 7
    	j = i+6;  // j takes the value of i plus 6, this is 13
    	i = j;    // i takes the value of j, this is 13
fr: 	i = 5+2;  // i prend la valeur 7
    	j = 6+i;  // j prend la valeur de i : 13
    	i = j;    // i prend la valeur de j : 13

note: type: Plain text
en: At the end of this example, both variables <code>i</code> and <code>j</code> contain the value <code>13</code>.
fr: A la fin de cet exemple, les variables <code>i</code> et <code>j</code> contiennent toutes deux la valeur <code>13</code>.

note: type: Plain text
en: The following assignment is not correct, because on the left side of the equals sign <code>=</code>, there can be only a variable name:
    <c/><s/>	i+2 = j;  // impossible
fr: L'assignation suivante est incorrecte, car il ne peut y avoir qu'un nom de variable simple à gauche du signe <code>=</code>:
    <c/><s/>	i+2 = j;  // impossible

note: type: Plain text
en: If you want to exchange the values of two variables, you must use a third variable. Here is an example to exchange the content of two variables <code>a</code> and <code>b</code> :
    <c/><s/>	int temp;
fr: Pour permuter les contenus de deux variables, il faut obligatoirement utiliser une troisième variable temporaire. Voici comment permuter <code>a</code> et <code>b</code>:
    <c/><s/>	int temp;

note: type: Source code
en: 	temp = a;  // temp takes the value of a
    	a = b;     // the content of b is copied into a
    	b = temp;  // the content of temp is copied into b
fr: 	temp = a;  // temp prend la valeur de a
    	a = b;     // b est copié dans a
    	b = temp;  // temp est copié dans a

note: type: Plain text
en: Use this type when you want to declare a function that returns nothing.
fr: Ce type particulier signifie qu'il n'y a rien.

note: type: Plain text
en: Example:
    <c/><s/>void MyFunction(int a)
fr: Examples:
    <c/><s/>void MyFunction(int a)

note: type: Plain text
en: The instruction <c/>wait();<n/> instructs the bot to wait for some seconds, according to the value written in brackets.
fr: L'instruction <c/>wait();<n/> permet d'attendre un certain laps de temps donné en secondes.

note: type: Plain text
en: In order to wait until the <a object|power>power cell</a> is recharged on a power station, wait 5 seconds with <c/>wait(5);<n/>.
fr: Pour attendre que le robot se soit <a object|power>rechargé</a> sur une station des recharge, attendez 5 secondes en écrivant <c/>wait(5);<n/>.

note: type: Plain text
en: In order to wait until the <a object|convert>converter</a> finished transforming some <a object|titanore>titanium ore</a> in a <a object|titan>titanium cube</a>, wait 15 seconds with <c/>wait(15);<n/>.
fr: Pour attendre que la <a object|convert>raffinerie</a> ait transformé du <a object|titanore>minerai de titane</a> en un <a object|titan>bloc de titane</a>, attendez 15 secondes avec <c/>wait(15);<n/>.

note: type: Plain text
en: Waits for a moment.
fr: Attend un certain temps.

note: type: Plain text
en: Specifies the time that the bot must wait.
fr: Durée à attendre, en secondes.

note: type: Plain text
en: The instruction <code>while () {}</code> is used to repeat a set of instructions several times.
fr: L'instruction <code>while () {}</code> permet de répéter des instructions plusieurs fois.

note: type: Plain text
en: The most frequent use of <code>while</code> consists in repeating a set of instructions again and again. In order to achieve this, write <code>while (true) {}</code> and put the instructions to be repeated in braces <code>{}</code>. As an example, here is a program that repeats again and again the following actions:
fr: L'utilisation la plus courante de <code>while</code> consiste à répéter des instructions encore et encore, à l'infini. Pour ce faire, on écrit <code>while (true) {}</code> et on met les instructions à répéter entre les accolades <code>{}</code>. Par exemple, voici un programme qui répète à l'infini les instructions suivantes:

note: type: Bullet: 'o'
en: look for a spider,
fr: cherche une araignée,

note: type: Bullet: 'o'
en: turn towards it,
fr: tourne dans sa direction,

note: type: Bullet: 'o'
en: shoot.
fr: tire,

note: type: Source code
en: 	while (true)
    	{
    		item = <a cbot|radar>radar</a>(AlienSpider);
    		<a cbot|turn>turn</a>(direction(item.position));
    		<a cbot|fire>fire</a>(1);
    	}
fr: 	while (true)
    	{
    		chose = <a cbot|radar>radar</a>(AlienSpider);
    		<a cbot|turn>turn</a>(direction(chose.position));
    		<a cbot|fire>fire</a>(1);
    	}

note: type: Plain text
en: Just execute this program once, and it will kill all spiders around it.
fr: Il suffit d'exécuter ce programme une seule fois, il tuera toutes les araignées autour de lui.

note: type: Plain text
en: This instruction allows you to perform the instructions inside the <a cbot|bloc>block</a> several times.
fr: Cette structure de boucle permet d'exécuter plusieurs fois les instructions comprises dans le <a cbot|bloc>bloc</a>.

note: type: Plain text
en: Be careful not to confuse the instruction <code>while( ) { }</code> with the instruction <c/><a cbot|do>do</a> { } while( );<n/>; the latter tests the condition only after the instructions in the block have been performed a first time.
fr: Attention de ne pas confondre <code>while( ) { }</code> avec <c/><a cbot|do>do</a> { } while( );<n/>, qui n'effectue le test qu'après le premier tour de boucle.

note: type: Plain text
en: Do not put a <a cbot|term>semicolon</a> at the end of the line <code>while ( )</code>.
fr: Il ne faut pas mettre un <a cbot|term>point-virgule</a> à la fin de la ligne <code>while ( )</code>.

note: type: Plain text
en: The instructions <code><a cbot|break>break</a></code> and <code><a cbot|continue>continue</a></code> can be useful inside a block following the instruction <code>while { }</code>.
fr: Les instructions <code><a cbot|break>break</a></code> et <code><a cbot|continue>continue</a></code> sont utiles à l'intérieur d'un bloc <code>while { }</code>.

note: type: Plain text
en: Write one line of text to an open file in the files/ folder. This is a method of the <code><a cbot|file>file</a></code> class. This is the reason why we always write <code>handle.writeln()</code>:
fr: L'instruction <c/>writeln();<n/> écrit une ligne de texte dans un fichier ouvert dans le dossier 'files/'. Cette instruction est une méthode de la classe <code><a cbot|file>file</a></code>. C'est la raison pour laquelle on n'écrit jamais <code>writeln()</code> tout seul, mais <code>handle.writeln()</code>:

note: type: Plain text
en: The file must have been opened for writing (<code>"w"</code>) with the <code><a cbot|open>open</a></code> instruction. The line will automatically be terminated by the end of line characters 0x0D (CR) and 0x0A (LF).
fr: Le fichier doit être ouvert avec l'instruction <code><a cbot|open>open</a></code> et le mode <code>"w"</code> (écriture). Dans le fichier, la ligne sera automatiquement terminée par les deux caractères de fin de ligne 0x0D (CR) et 0x0A (LF).

note: type: Source code
en: <c/>handle.writeln ( string );<n/>
fr: <c/>writeln ( string );<n/>

note: type: Source code
en: 	writeln("Line of text");
fr: 	writeln("Ligne de texte");

note: type: Plain text
en: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code> and <code><a cbot|eof>eof</a></code>.
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|file>file</a></code>, <code><a cbot|open>open</a></code>, <code><a cbot|close>close</a></code>, <code><a cbot|readln>readln</a></code> et <code><a cbot|eof>eof</a></code>.
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Source code
en: <c/>acos ( value );<n/>
fr: <c/>acos( valeur);</n>

note: type: \t; header
en: value: <code><a cbot|float>float</a></code>
fr: valeur : <code><a cbot|float>float</a></code>

note: type: Plain text
en: Number between -1 and 1 (including both).
fr: Nombre entre -1 et 1 (compris).

note: type: Plain text
en: Arcus cosine (in degrees) of the value.
fr: Arc cosinus de la valeur (en degrés).

note: type: Plain text
en: <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|expr>expressions</a>.
fr: <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|expr>expressions</a>.

note: type: Plain text
en: This instruction sets the vertical and the horizontal angle of the cannon. The following robots are equipped with a cannon:
fr: Cette instruction définit les angles verticaux et horizontaux du canon. Les robots suivants sont équipés de canons:

note: type: Plain text
en: When controlling the robot through programming, the gun can be also turned left or right by turning the whole robot with the instruction <code><a cbot|turn>turn</a></code>.
fr: Lorsqu'un robot est contrôlé par un programme, le canon peut aussi être tourné horizontalement en tournant le robot entier, avec l'instruction <code><a cbot|turn>turn</a></code>.

note: type: \t; header
en: x: <code><a cbot|float>float</a></code> (default value: <code>0</code>)
fr: x: <code><a cbot|float>float</a></code> (valeur par défaut : <code>0</code>)

note: type: Plain text
en: Angle in degrees of the gun relative to the robot. A positive value orients the gun to the right. The angle must range from <code>-40</code> to <code>+40</code> degrees for all shooters.
fr: Angle en degrés du canon par rapport au robot. Une valeur positive oriente le canon vers la droite. L'angle doit être compris entre <code>-40</code> et <code>+40</code> degrés, pour tous les robots équipés.

note: type: Plain text
en: Arcus sine (in degrees) of the value.
fr: Arc sinus de la valeur (en degrés).

note: type: Plain text
en: Number.
fr: Nombre.

note: type: Plain text
en: Arcus tangent (in degrees) of the value.
fr: Arc tangente de la valeur (en degrés).

note: type: Plain text
en: The purpose of using two arguments instead of one is to gather information on the signs of the inputs in order to return the appropriate quadrant of the computed angle, which is not possible for the single-argument <c/><a cbot|atan>atan();</a><n/> function. For example, consider a point <code>(-1, -1)</code>: <c/>atan(-1/-1);<n/> is <code>45.00</code> degrees, whereas <c/>atan2(-1, -1);<n/> is <code>-135.00</code> degrees, which is obviously more correct in this case.
fr: L'intérêt d'utiliser deux arguments au lieu d'un est l'obtention de l'information sur les signes des entrées, afin de retourner le quadrant correct pour l'angle calculé, ce qui n'est pas possible avec la fonction <c/><a cbot|atan>atan();</a><n/> à un seul argument. Par exemple, pour un point <code>(-1, -1)</code>: <c/>atan(-1/-1);<n/> vaut <code>45.00</code> degrés, mais <c/>atan2(-1, -1);<n/> vaut <code>-135.00</code> degrés, ce qui est évidemment plus correct dans ce cas.

note: type: Plain text
en: Arcus tangent (in degrees) of <code>y/x</code>.
fr: Arc tangente de <code>y/x</code> (en degrés).

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>build()</code>.
    <code>== 0 </code>Successfully built
    <code>!= 0 </code>Impossible to build (for example, the nearest titanium cube is too far away or the specified building is not available in the mission)
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <code>build()</code>.
    <code>== 0 </code>Construction réussie
    <code>!= 0</code> Impossible de construire (par exemple, le cube de titane le plus proche est trop loin ou le bâtiment spécifié n'est pas disponible dans la mission; ou encore, le terrain n'est pas assez plat)

note: type: Plain text
en: It is similar to the <c/><a cbot|canbuild>canbuild();</a><n/> instruction. However, it does not check if a required research has been done.
fr: Elle est similaire à l'instruction <c/><a cbot|canbuild>canbuild();</a><n/>. À noter cependant, elle ne vérifie pas si l'éventuelle recherche requise a été effectuée.

note: type: \t; header
en: Return value: <code><a cbot|bool>bool</a></code>
fr: Type du retour: <code><a cbot|bool>booléen (bool)</a></code>

note: type: Plain text
en: Any building which can take some action (e.g. <a cbot|convert>Converter</a>).
fr: Tout bâtiment qui peut effectuer une action (par exemple <a cbot|convert>Converter</a>).

note: type: Plain text
en: <code><format const>true</format></code> if the object is doing something (e.g. converting)
    <code><format const>false</format></code> if the object is not doing anything
fr: <code><format const>true</format></code> si l'objet fait quelque chose (par exemple, une conversion)
    <code><format const>false</format></code> si l'objet ne fait rien.

note: type: Plain text
en: It helps to prevent errors in programs using the <c/><a cbot|build>build();</a><n/> instruction. Here is an example:
fr: Elle aide à éviter des erreurs lors de l'exécution des programmes lors de l'exécution de l'instruction <c/><a cbot|build>build();</a><n/>. En voici un exemple :

note: type: Plain text
en: <code>true</code> if the building can be built, <code>false</code> otherwise.
fr: <code>true</code> si le bâtiment peut être construit, <code>false</code> sinon.

note: type: Plain text
en: <format const>true</format> if the research can be done (even if it is already done, to check that, use the <a cbot|researched>researched</a> instruction)
    <format const>false</format> if the research cannot be done
fr: <format const>true</format> si la recherche peut être effectuée dans le niveau en cours (même si elle a déjà été recherchée, pour vérifier cela, utilisez l'instruction <a cbot|researched>researched</a>)
    <format const>false</format> si la recherche ne peut pas être effectuée.

note: type: Plain text
en: Below are the different categories available:
fr: Vous trouverez ci-dessous les différentes catégories disponibles :

note: type: \t; header
en: Buildings:
fr: Bâtiments :

note: type: \t; header
en: Portable Objects:
fr: Objets transportables :

note: type: \t; header
en: Robots:
fr: Robots :

note: type: \t; header
en: Enemies:
fr: Ennemis

note: type: \t; header
en: Miscellaneous:
fr: Divers :

note: type: \t; header
en: Flags and Other Indicators:
fr: Drapeaux et autres indicateurs :

note: type: Plain text
en: Rounds up a number.
fr: Arrondir un nombre.

note: type: Plain text
en: Ceiling of the value, i.e. the smallest integer not less than <code>value</code>. For example, <code>ceil(2.1)</code> is <code>3.0</code>.
fr: Valeur entière d'un nombre, c'est-à-dire le plus petit entier non inférieur à <code>valeur</code>. Par exemple, <code>ceil(2.1)</code> est <code>3.0</code>.

note: type: Plain text
en: <a cbot|round>round</a>, <a cbot>programming</a>, <a cbot|type>types</a> and <a cbot|expr>expressions</a>.
fr: <a cbot|round>round</a>, <a cbot>programmation</a>, <a cbot|type>types</a> et <a cbot|expr>expressions</a>.

note: type: \b; header
en: Value <code>Colors</code>
fr: Valeurs de <code>Colors</code>

note: type: Plain text
en: Color names are used to define a specific color to use. They can be passed to functions like <a cbot|pendown>pendown</a> or <a cbot|pencolor>pencolor</a>.
fr: Les noms de couleur sont utilisés pour définir une couleur spécifique à utiliser. Elles peuvent être passés à des fonctions telles que <a cbot|pendown>pendown</a> ou <a cbot|pencolor>pencolor</a>.

note: type: Plain text
en: In a program, colors are always displayed on a <format const>red background</format>. If a color isn't highlighted in red, it is misspelled. Caps and lower cases should be kept as is.
fr: Dans un programme, les couleurs sont toujours affichées sur un fond <format const>fond rouge</format>. Si une couleur n'est pas surlignée en rouge, c'est qu'elle est mal orthographiée. Les majuscules et les minuscules sont importantes et doivent être respectées.

note: type: Plain text
en: Below are the different colors available:
fr: Vous trouverez ci-dessous les différentes couleurs disponibles :

note: type: Plain text
en: <code><format const>White</format></code>
    <code><format const>Black</format></code>
    <code><format const>Gray</format></code>
    <code><format const>LightGray</format></code>
    <code><format const>Red</format></code>
    <code><format const>Pink</format></code>
    <code><format const>Purple</format></code>
    <code><format const>Orange</format></code>
    <code><format const>Yellow</format></code>
    <code><format const>Beige</format></code>
    <code><format const>Brown</format></code>
    <code><format const>Skin</format></code>
    <code><format const>Green</format></code>
    <code><format const>LightGreen</format></code>
    <code><format const>Blue</format></code>
    <code><format const>LightBlue</format></code>
fr: <code><format const>White</format></code> : Blanc
    <code><format const>Black</format></code> : Noir
    <code><format const>Gray</format></code> : Gris
    <code><format const>LightGray</format></code> : Gris clair
    <code><format const>Red</format></code> : Rouge
    <code><format const>Pink</format></code> : Rose
    <code><format const>Purple</format></code> : Pourpre
    <code><format const>Orange</format></code> : Orange
    <code><format const>Yellow</format></code> : Jaune
    <code><format const>Beige</format></code> : Beige
    <code><format const>Brown</format></code> : Brun
    <code><format const>Skin</format></code> : couleur peau 
    <code><format const>Green</format></code> : Vert
    <code><format const>LightGreen</format></code> : Vert clair
    <code><format const>Blue</format></code> : Bleu
    <code><format const>LightBlue</format></code> : Bleu clair

note: type: Plain text
en: You can also draw colored symbols:
fr: Vous pouvez aussi dessiner des symboles colorisés :

note: type: Plain text
en: <code><format const>BlackArrow</format></code>
    <code><format const>RedArrow</format></code>
fr: <code><format const>BlackArrow</format></code>: flèches noires
    <code><format const>RedArrow</format></code>: flèches rouges

note: type: Plain text
en: Angle in degrees.
fr: Angle en degrés.

note: type: Plain text
en: Cosine of the angle.
fr: Cosinus d'un angle.

note: type: Plain text
en: Destroys an object.
fr: Détruire un objet.

note: type: Plain text
en: <a object|destroy>Destroyer</a>.
fr: <a object|destroy>Destructeur</a>.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>destroy()</code>.
    <code>== 0 </code>The operation of destroying of an object was started
    <code>!= 0 </code>The instruction could not be done (e.g. nothing to destroy)
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <code>destroy()</code>.
    <code>== 0 </code> L'opération de destruction d'un objet a été commencée
    <code>!= 0 </code> L'instruction ne peut être réalisée (ex.: rien à détruire)

note: type: Plain text
en: With the instruction <c/>detect();<n/>, you can look for objects like <a object|mother>enemies</a>, bots, buildings or raw materials, which are in front of the bot. It is a simpler version of <c/><a cbot|radar>radar</a>();<n/>.
fr: Avec l'instruction <c/>detect();<n/>, vous pouvez rechercher des objets comme des <a object|mother>ennemis</a>, des robots, des bâtiments ou de la matière première, qui sont devant le robot. C'est une version plus simple de <c/><a cbot|radar>radar</a>();<n/>.

note: type: Plain text
en: Detects the nearest object of the specified <a cbot|category>category</a> being in front of the bot. It is similar to the following instruction:
fr: Détecte l'objet le plus proche de la  <a cbot|category>catégorie spécifiée</a> étant devant le robot. Elle est similaire à l'instruction suivante :

note: type: Source code
en: <c/>radar(cat, 0, 45, 0, 20);<n/>
fr: <c/><a cbot|radar>radar</a>(cat, 0, 45, 0, 20);<n/>

note: type: Bullet: 'o'
en: <a cbot|category>Category</a> of the objects that should be detected. For example, when you are looking for an ant, write <code>radar(AlienAnt)</code>.
fr: <a cbot|category>Catégorie/a> de l'objet qui doit être détecté. Par exemple, si vous cherchez une fourmi, écrivez <code><a cbot|radar>radar</a>(AlienAnt)</code>.

note: type: Bullet: 'o'
en: <a cbot|array>Array</a> of categories of the objects that should be detected. For example, when you are looking only for grabbers:<c/>
fr: <a cbot|array>Tableau</a> de catégories des objets à détecter. Par exemple, lorsque vous cherchez uniquement des préhenseurs :<c/>

note: type: Source code
en: int bots[4];
    bots[0] = WheeledGrabber;
    bots[1] = TrackedGrabber;
    bots[2] = WingedGrabber;
    bots[3] = LeggedGrabber;
    object nearestGrabber = radar(bots);
fr: int bots[4];
    bots[0] = WheeledGrabber;
    bots[1] = TrackedGrabber;
    bots[2] = WingedGrabber;
    bots[3] = LeggedGrabber;
    object nearestGrabber = <a cbot|radar>radar</a>(bots);

note: type: Bullet: 'o'
en: Keyword <format const>Any</format> if you are looking for any object (including even plants and so on).
fr: Mot clef <format const>Any</format> si vous cherchez tous type d'objets (incluant les plantes etc.).

note: type: Plain text
en: <format const>true</format> if the object was found
    <format const>false</format> if the object was not found
fr: <format const>true</format> si l'objet a été trouvé
    <format const>false</format> sinon

note: type: Plain text
en: <a cbot|category>Category</a> of the robot to construct.
fr: <a cbot|category>Catégorie</a> du robot à construire.

note: type: \t; header
en: program: <code><a cbot|string>string</a></code> (default value: <code>""</code>)
fr: program: <code><a cbot|string>string</a></code> (valeur par défaut: <code>""</code>)

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>factory()</code>.
    <code>== 0 </code>The construction successfully started
    <code>!= 0 </code>The construction could not be started (e.g. no <a object|titan>Titanium</a> in the factory, the bot is not researched)
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <code>factory()</code>.
    <code>== 0 </code>La construction a démarré avec succès
    <code>!= 0 </code>La construction n'a pu démarrer (par ex. pas de <a object|titan>titane</a> dans l'usine ou le type de robot demandé n'a pas été recherché)

note: type: Plain text
en: Determines the position of the nearest free space with at least <code>flatmin</code> of flat ground around a given position. Works similar to <c/><a cbot|space>space();</a><n/>. Useful for finding a place for a <a cbot|category>building</a>.
fr: Détermine la position de l'espace libre le plus proche avec au moins <code>flatmin</code> de terrain plat autour d'une position donnée. Fonctionne comme <c/><a cbot|space>space();</a><n/>. Utile pour trouver une place pour un <a cbot|category>bâtiment</a>.

note: type: \t; header
en: flatmin: <code><a cbot|float>float</a></code>
fr: flatmin: <code><a cbot|float>réel</a></code>

note: type: Plain text
en: Minimum radius of flat ground around the desired position.
fr: Rayon minimum du sol plat autour de la position désirée.

note: type: Source code
en: <c/>floor ( value );<n/>
fr: <c/>floor ( valeur );<n/>

note: type: Plain text
en: Rounds down a number.
fr: Partie entière d'un nombre.

note: type: Plain text
en: Floor of the value, i.e. the largest integer not greater than <code>value</code>. For example, <code>floor(2.9)</code> is <code>2.00</code>.
fr: Tronque la valeur entière, c'est-à-dire le plus grand entier ne dépassant pas <code>valeur</code>. Par exemple, <code>floor(2.9)</code> est <code>2.00</code>.

note: type: Plain text
en: Example: count from 1 to 4
    <c/><s/><c/>for ( i = 1 ; i <= 4 ; i++ )
fr: Example: compter de 1 à 4
    <c/><s/><c/>for ( i = 1 ; i <= 4 ; i++ )

note: type: Plain text
en: Function, simply put, is an instruction created by you.
fr: Une fonction : une instruction créée par vous.

note: type: \b; header
en: Main function
fr: Fonction principale

note: type: Plain text
en: You probably already know how to create a function. Every program in CBOT must have a main function, which looks like this:
fr: Vous savez probablement déjà comment créer une fonction. Chaque programme du CBOT doit avoir une fonction principale, qui ressemble à ceci :

note: type: Source code
en: extern void object::ProgramName()
    {
    	
    	// instructions
    	
    }
fr: extern void object::nomFonctionPrincipale()
    {
    	
    	;// ..instructions.. (sans oublier les ';')
    	
    }

note: type: Plain text
en: With functions you can divide your program into several parts. Each of them will execute a specific task. For example, see the following program:
fr: Grâce aux fonctions, vous pouvez diviser votre programme en plusieurs parties plus simple. Chacune d'elles exécutera une tâche spécifique. Par exemple :

note: type: Plain text
en: <code><a cbot|send>send</a></code> and <code><a cbot|wait>wait</a></code> are repeated several times. So it would be a good thing if we created a function that executes these two instructions:
fr: <code><a cbot|send>send</a></code> et <code><a cbot|wait>wait</a></code> sont répétés plusieurs fois. Ce serait donc une bonne chose si nous créions une fonction qui exécute ces deux instructions :

note: type: Plain text
en: Now the program is much easier to read. It is a good practice to split the program into several functions with self-describing names.
fr: Maintenant, le programme est beaucoup plus facile à lire. C'est une bonne pratique de diviser le programme en plusieurs fonctions avec des noms auto-descriptifs.

note: type: \b; header
en: Syntax
fr: Syntaxe

note: type: Source code
en: result_type FunctionName(optional_parameters)
    {
    	body
    }
fr: TypeResultat nomFonction(parametresOptionnels)
    {
    	contenu;
    }

note: type: Plain text
en: Result <a cbot|type>type</a> should be <a cbot/void>void</a> if the function does not give any. Body is just a set of instructions. Function name must be created with the exact same rules applied to <a cbot|var>variables</a>.
fr: <a cbot|type>TypeResultat</a> doit être précisé comme <a cbot/void>void</a> si la fonction ne retourne rien. Contenu est un ensemble d'instructions. NomFonction doit être choisi comme un nom de <a cbot|var>variable</a>, sans espace...

note: type: \t; header
en: Parameters
fr: Paramètres

note: type: Plain text
en: A function can have parameters:
fr: Une fonction peut avoir des paramètres:

note: type: Source code
en: void Example(int a, float x, string s)
    {
    	message(a);
    	message(x);
    	message(s);
    }
fr: void exemple(int a, float x, string s)
    {
    	message(a);
    	message(x);
    	message(s);
    }

note: type: Plain text
en: The <code>Example</code> function will receive an <a cbot|int>integer</a> <code>a</code>, a <a cbot|float>floating point number</a> <code>x</code> and a <a cbot|string>string</a> <code>s</code>. Parameters are "passed by value", that is the values of parameter variables in a function are copies of the values the caller specified as variables. If you pass an <code><a cbot|int>int</a></code> to a function, its parameter is a copy of whatever value was being passed as the argument, and the function can change its parameter value without affecting values in the code that invoked the function.
fr: La fonction <code>exemple</code> recevra un <a cbot|int>entier</a> <code>a</code>, un <a cbot|float>réel</a> <code>x</code> et une <a cbot| string>chaîne</a> <code>s</code>. Les paramètres sont "passés par valeur", c'est-à-dire que les valeurs des variables paramètres dans une fonction sont des copies des valeurs que l'appelant a spécifiées comme variables. Si vous passez un <code><a cbot|int>int</a></code> à une fonction, son paramètre est une copie de n'importe quelle valeur passée en argument, et la fonction peut changer sa valeur de paramètre sans affecter les valeurs du code qui a appelé la fonction.

note: type: Plain text
en: If you pass a <a cbot|class>class</a> instance or an <a cbot|array>array</a> as parameter to a function, the function only receives a <a cbot|pointer>reference</a> to the instance or the array. That means if you modify the instance or the array in the function, the instance or the array that has been specified by the caller will be actually modified.
fr: Par contre, si vous passez une instance de <a cbot|class>classe</a> ou un <a cbot|array>tableau</a> en paramètre d'une fonction, la fonction reçoit seulement une <a cbot|pointer>référence</a> à l'instance ou au tableau. Cela signifie que si vous modifiez l'instance ou le tableau dans la fonction, l'instance ou le tableau qui a été spécifié par l'appelant sera effectivement modifié.

note: type: \t; header
en: Result
fr: Résultat

note: type: Plain text
en: A function can also return a result with the <code><a cbot|return>return</a></code> instruction. Therefore the function must be declared no longer as <code><a cbot|void>void</a></code> but as an other <a cbot|type>type</a>:
fr: Une fonction peut aussi retourner un résultat avec l'instruction <code><a cbot|return>return</a></code>. Par conséquent, la fonction ne doit plus être déclarée comme <code><a cbot|void>void</a></code> mais comme retournant une valeur d'un autre <a cbot|type>type</a> :

note: type: Source code
en: float Average(float a, float b)
    {
    	return (a+b)/2;
    }
    
    extern void object::Test( )
    {
    	float value;
    	value = Average(2, 6);
    	message(value);  // will display 4
    }
fr: float Average(float a, float b)
    {
    	return (a+b)/2;
    }
    
    extern void object::Test( )
    {
    	float value;
    	value = Average(2, 6);
    	message(value);  // affichera 4
    }

note: type: Plain text
en: Some other examples:
fr: Quelques autres exemples :

note: type: \b; header
en: Overloading
fr: Surcharge

note: type: Plain text
en: You can declare several functions with the same name but different parameters:
fr: Vous pouvez déclarer plusieurs fonctions avec le même nom, mais avec des paramètres différents :

note: type: Plain text
en: CBOT will call either the one or the other function depending on the parameters passed. They must be distinguishable, i.e. you can't declare two functions with the same name and parameter types in the exact same order, e.g. declaring <code>int Pythagoras(float b, float a)</code> will result in error. Note that result type does not matter.
fr: CBOT appellera l'une ou l'autre fonction en fonction des paramètres passés. Ils doivent pouvoir être distingués, c'est-à-dire que vous ne pouvez pas déclarer deux fonctions avec le même nom et les mêmes types de paramètres dans le même ordre exact, par exemple en déclarant <code>int Pythagoras(float b, float a)</code> entraînera une erreur. Notez que le type de résultat n'a pas d'importance.

note: type: Plain text
en: Declaring a function as a part of the <a cbot|object>object</a> namespace gives it access to <code><a cbot|this>this</a></code> <a cbot|pointer>pointer</a>, in other words, to all available properties of the robot which the program is run on.
fr: Déclarer une fonction comme faisant partie de l'espace de nommage <a cbot|object>object</a> lui donne accès au pointeur <a cbot|pointer>pointeur</a> <code><a cbot|this>this</a></code> , c'est-à-dire à toutes les propriétés disponibles du robot où le programme est exécuté.

note: type: Plain text
en: Use this type for variables that contain the characteristics of an object, be it a bot, a building, some raw material, an enemy, etc. Here are all properties of an object:
fr: Utilisez ce type pour les variables qui contiennent les caractéristiques d'un objet, que ce soit un robot, un bâtiment, une matière première, un ennemi, etc. Voici toutes les propriétés d'un objet :

note: type: Plain text
en: <code><a cbot|int>int</a>    object.category     </code><a cbot|category>Category</a> of the object
    <code><a cbot|point>point</a>  object.position     </code>Position of the object (x,y,z)
    <code><a cbot|float>float</a>  object.orientation  </code>Orientation of the object (0..360)
    <code><a cbot|float>float</a>  object.pitch        </code>Forward/backward angle of the object
    <code><a cbot|float>float</a>  object.roll         </code>Right/left angle of the object 
    <code><a cbot|float>float</a>  object.energyLevel  </code>Energy level (0..1)
    <code><a cbot|float>float</a>  object.shieldLevel  </code>Shield level (0..1)
    <code><a cbot|float>float</a>  object.temperature  </code>Jet temperature (0..1)
    <code><a cbot|float>float</a>  object.altitude     </code>Altitude above ground
    <code><a cbot|float>float</a>  object.lifeTime     </code>Lifetime of the object
    <code>object object.energyCell   </code>Power cell on the bot
    <code>object object.load         </code>Object carried by the bot
    <code><a cbot|int>int</a>    object.team         </code>The object's team (see <a battles>code battles</a>)
    <code><a cbot|point>point</a>  object.velocity     </code>Velocity of the object
fr: <code><a cbot|int>int</a>    object.category     </code><a cbot|category>Catégorie</a> de l'objet
    <code><a cbot|point>point</a>  object.position     </code>Position de l'objet (x,y,z)
    <code><a cbot|float>float</a>  object.orientation  </code>Orientation de l'objet (0..360)
    <code><a cbot|float>float</a>  object.pitch        </code>Angle de bascule de l'objet
    <code><a cbot|float>float</a>  object.roll         </code>Angle d'inclinaison de l'object 
    <code><a cbot|float>float</a>  object.energyLevel  </code>Niveau d'énergie (0..1)
    <code><a cbot|float>float</a>  object.shieldLevel  </code>Niveau de bouclier (0..1)
    <code><a cbot|float>float</a>  object.temperature  </code>Chaleur du jet (0..1)
    <code><a cbot|float>float</a>  object.altitude     </code>Altitude par rapport au sol
    <code><a cbot|float>float</a>  object.lifeTime     </code>Durée de vie de l'objet
    <code>object object.energyCell   </code>batterie ou pile du robot
    <code>object object.load         </code>Objet transporté par le préhenseur
    <code><a cbot|int>int</a>    object.team         </code>Équipe de l'objet (Voir <a battles>batailles de code</a>)
    <code><a cbot|point>point</a>  object.velocity     </code>Vitesse de l'objet

note: type: Plain text
en: Also, some objects have additional methods (instructions). See them in <a cbot>the main list</a> in the <c/>"Instructions specific for some objects" section.
fr: De plus, certains objets ont des méthodes (instructions) supplémentaires. Se reporter à la <a cbot>la liste principale</a> dans la section <c/>"Instructions spécifiques pour certains objets".

note: type: Plain text
en: The <n/><a cbot|category>category</a> of an object allows you to know what it is, f. ex. what kind of bot, building, enemy, etc.
fr: <n/>La <a cbot|category>catégorie</a> d'un objet vous permet de savoir de quoi il s'agit, par exemple de quel type de robot, bâtiment, ennemi, etc.

note: type: Plain text
en: The bot's team. Used in <a battles>code battles</a>. If the object has no team assigned (e.g. in no team-based levels, the object being a resource), this is equal to <code>0</code>.
fr: L'équipe du robot. Utilisé dans <a battles>bataille de codes</a>. Si l'objet n'a pas d'équipe affectée (par exemple, dans les niveau non basé sur les équipes ou l'objet étant une ressource), ceci est égal à <code>0</code>.

note: type: Plain text
en: Current velocity of the object. Should be treated as a three-dimensional vector.
fr: Vitesse actuelle de l'objet, dans chacun des axes x,y et z. Doit être traité comme un vecteur tridimensionnel.

note: type: Plain text
en: The instruction <c/>pencolor();<n/> instructs the bot to change the color of the pencil.
fr: L'instruction <c/>pencolor();<n/> demande au robot de changer la couleur de son crayon.

note: type: \t; header
en: color: <code><a cbot|int>int</a></code> (default value: <code>Black</code>)
fr: color: <code><a cbot|int>int</a></code> (valeur par défaut: <code>Black</code>)

note: type: Plain text
en: <a cbot|colors>Color name</a>.
fr: <a cbot|colors>Couleur</a>.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>pencolor();<n/>.
    <code>== 0 </code>The color was changed
    <code>!= 0 </code>The instruction did not work
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <c/>pencolor();<n/>.
    <code>== 0 </code> La couleur a été modifiée
    <code>!= 0 </code>  L'instruction ne fonctionne pas

note: type: Plain text
en: The instruction <c/>pendown();<n/> instructs the bot to have the pen down, so it starts drawing.
fr: L'instruction <c/>pendown();<n/> demande au robot de baisser son crayon au sol, donc il commence à dessiner.

note: type: \t; header
en: width: <code><a cbot|float>float</a></code> (default value: <code>0.5</code>)
fr: width: <code><a cbot|float>float</a></code> (valeur par défaut: <code>0.5</code>)

note: type: Plain text
en: Width of the pen. The width cannot be higher than <code>1.0</code> and cannot be lower than <code>0.0</code>. Passing a higher value will result in the width being the highest possible and passing a lower value will result in the width being the lowest possible.
fr: Largeur du crayon. La largeur ne peut être supérieure à <code>1.0</code> et ne peut être inférieure à <code>0.0</code>. Si vous passez une valeur supérieure, la largeur sera la plus grande possible et si vous passez une valeur inférieure, la largeur sera la plus petite possible.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>pendown();<n/>.
    <code>== 0 </code>The pen is now down
    <code>!= 0 </code>The instruction did not work
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <c/>pendown();<n/>.
    <code>== 0 </code>Le crayon est maintenant abaissé
    <code>!= 0  </code>La commande ne fonctionne pas

note: type: Plain text
en: The instruction <c/>penup();<n/> instructs the bot to have the pen up, so it stops drawing. The pen is up by default, so it should be used only after using <code><a cbot|pendown>pendown</a></code>.
fr: L'instruction <c/>penup();<n/>indique au robot d'avoir son crayon relevé, pour qu'il arrête de dessiner. Le crayon est en haut par défaut, il ne doit donc être utilisé qu'après avoir utilisé <code><a cbot|pendown>pendown</a></code>.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>penup();<n/>.
    <code>== 0 </code>The pen is now up
    <code>!= 0 </code>The instruction did not work
fr: Normalement, une erreur arrête le programme Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <c/>penup();.
    <code>== 0 </code>Le crayon est maintenant relevé
    <code>!= 0  </code>La commande ne fonctionne pas

note: type: Plain text
en: The instruction <c/>penwidth();<n/> instructs the bot to change the width of the pencil.
fr: L'instruction <c/>penwidth();<n/> demande au robot de changer la largeur de son trait de crayon.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <c/>penwidth();<n/>.
    <code>== 0 </code>The width was changed
    <code>!= 0 </code>The instruction did not work
fr: Normalement, une erreur arrête le programme Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <c/>penwidth();.
    <code>== 0 </code> La largeur du trait a été modifiée
    <code>!= 0 </code>  L'instruction ne fonctionne pas

note: type: Plain text
en: Base.
fr: Base. (mantisse)

note: type: Plain text
en: Exponent.
fr: Exposant.

note: type: Plain text
en: x to the y (x raised to the yth power).
fr: x à la puissance y (x * x  * x ... y fois ).

note: type: Bullet: 'o'
en: <a cbot|array>Array</a> of categories of the objects that should be detected. For example, when you are looking only for grabbers:
fr: <a cbot|array>Tableau</a> de catégories des objets à détecter. Par exemple, lorsque vous cherchez uniquement des préhenseurs :

note: type: Source code
en: bots[0] = WheeledGrabber;
    bots[1] = TrackedGrabber;
    bots[2] = WingedGrabber;
    bots[3] = LeggedGrabber;
    object nearestGrabber = radar(bots);<n/>
fr: bots[0] = WheeledGrabber;
    bots[1] = TrackedGrabber;
    bots[2] = WingedGrabber;
    bots[3] = LeggedGrabber;
    object nearestGrabber = <a cbot|radar>radar</a>(bots);<n/>

note: type: Bullet: 'o'
en: Keyword <format const>Any</format> if you are looking for any object (including even plants and so on). Filters may be useful to use with this keyword.
fr: Mot clef <format const>Any</format> si vous cherchez tous type d'objets (incluant les plantes etc.). Les filtres sont particulièrement utiles avec ce mot clef.

note: type: \t; header
en: angle: <code><a cbot|float>float</a></code> (default value: <code>0</code>)
fr: angle: <code><a cbot|float>float</a></code> (valeur par défaut : <code>0</code>)

note: type: \t; header
en: focus: <code><a cbot|float>float</a></code> (default value: <code>360</code>)
fr: focus : <code><a cbot|float>float</a></code> (valeur par défaut : <code>360</code>)

note: type: \t; header
en: min: <code><a cbot|float>float</a></code> (default value: <code>0</code>)
fr: min: <code><a cbot|float>float</a></code> (valeur par défaut : <code>0</code>)

note: type: \t; header
en: max: <code><a cbot|float>float</a></code> (default value: <code>1000</code>)
fr: max: <code><a cbot|float>float</a></code> (valeur par défaut : <code>1000</code>)

note: type: \t; header
en: sens: <code><a cbot|float>float</a></code> (default value: <code>1</code>)
fr: sens: <code><a cbot|float>float</a></code> (valeur par défaut : <code>1</code>)

note: type: \t; header
en: filter: <code><a cbot|int>int</a></code> (default value: <code><format const>FilterNone</format></code>)
fr: filter: <code><a cbot|int>int</a></code> (valeur par défaut : <code><format const>FilterNone</format></code>)

note: type: Plain text
en: Determines which type of objects should be detected. Especially useful in use with an <a cbot|array>array</a> or <format const>Any</format>. The following filters are available:
fr: Détermine le type d'objets à détecter. Particulièrement utile avec un <a cbot|array>array</a> ou <format const>Any</format>. Les filtres suivants sont disponibles :

note: type: Plain text
en: <code><format const>FilterNone</format>        </code>Detects everything (default)
    <code><format const>FilterOnlyLanding</format> </code>Detects only objects being on the ground
    <code><format const>FilterOnlyFlying</format>  </code>Detects only objects not being on the ground
    <code><format const>FilterFriendly</format>    </code>Detects only allies (objects in the same team)
    <code><format const>FilterEnemy</format>       </code>Detects only enemies (objects in an other team except neutral)
    <code><format const>FilterNeutral</format>     </code>Detects only neutral objects (e.g. resources)
fr: <code><format const>FilterNone</format> </code>Détecte tout (par défaut)
    <code><format const>FilterOnlyLanding</format> </code>Détecte uniquement les objets au sol
    <code><format const>FilterOnlyFlying</format> </code>Détecte uniquement les objets au sol non présents
    <code><format const>FilterFriendly</format> </code>Détecte uniquement les alliés (objets de la même équipe)
    <code><format const>FilterEnemy</format> </code>Détecte uniquement les ennemis (objets dans une autre équipe sauf neutre)
    <code><format const>FilterNeutral</format> </code>Détecte seulement les objets neutres (ex. ressources)

note: type: Plain text
en: The last three are mainly useful in <a battles>code battles</a>. You can also pass a team ID to search only for objects from a specific team. Attention: you should use <format const>FilterNeutral</format> instead of <code>0</code> or else it will not work.
fr: Les trois derniers sont principalement utiles dans <a battles>bataille de codes</a>. Vous pouvez également passer un ID d'équipe pour rechercher uniquement les objets d'une équipe spécifique. Attention : vous devez utiliser <format const>FilterNeutral</format> au lieu de <code>0</code> ou sinon cela ne fonctionnera pas.

note: type: Plain text
en: Filters and IDs can be mixed using bitwise OR operator <code>|</code>, for example <c/>radar(Any, 0, 360, 0, 1000, 1, 2 | FilterOnlyLanding);<n/> will only detect an object from team <code>2</code> that is on the ground. Attention: you can specify only one team ID at once, but you can specify several filters at once.
fr: Les filtres et les ID peuvent être mélangés à l'aide de l'opérateur OU <code>|</code>, par exemple <c/><a cbot|radar>radar</a>(Any, 0, 360, 0, 1000, 1, 2 | FilterOnlyLanding);<n/> détecte uniquement un objet d'équipe <code>2</code> qui sont posés sur terre. Attention : vous ne pouvez spécifier qu'un seul ID d'équipe à la fois, mais vous pouvez spécifier plusieurs filtres à la fois.

note: type: Plain text
en: Pseudorandom number between 0 and 1 (including 0, but excluding 1).
fr: Nombre pseudo-aléatoire entre 0 et 1 (0 inclus, mais 1 exclu).

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>research()</code>.
    <code>== 0 </code>The research successfully started
    <code>!= 0 </code>The research could not be started (e.g. the research is disabled in the level, no power cell)
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <code>research()</code>.
    <code> == 0 </code>La recherche a bien démarré
    <code>!= 0 </code>  La recherche n'a pas pu démarrer (par exemple, cette recherche n'est pas active dans le niveau ou le centre de recherche n'a pas de courant)

note: type: \b; header
en: Value <code>Research names</code>
fr: Valeur <code>Noms des recherches possibles</code>

note: type: Plain text
en: Research names represent the types of available researches in the CBOT language. You can use them to control <a object|research>ResearchCenter</a> by passing them to appropriate instructions (e.g. <a cbot|research>research</a>, <a cbot|canresearch>canresearch</a>, <a cbot|researched>researched</a>).
fr: Les Noms des recherches possibles représentent les types de recherches disponibles dans le langage CBOT. Vous pouvez les utiliser pour contrôler <a object|research>le centre de recherche</a> en les passant aux instructions appropriées (par exemple <a cbot|research>research</a>, <a cbot|canresearch>canresearch</a>, <a cbot|researched>researched</a>).

note: type: Plain text
en: In a program, research names are always displayed on a <format const>red background</format>. If a research name is not highlighted in red, it is misspelled. Caps and lower cases should be kept as is.
fr: Dans un programme, les noms de recherche sont toujours affichés sur un fond <format const>fond rouge</format>. Si un nom de recherche n'est pas surligné en rouge, le robot ne la reconnaîtra pas : il est mal orthographié. Les majuscules et les minuscules doivent être conservées telles quelles.

note: type: Plain text
en: Below are the different research names available.
fr: Vous trouverez ci-dessous les différents noms de recherche disponibles.

note: type: \t; header
en: Done by <a object|research>ResearchCenter</a>:
fr: Effectuée par le <a object|research>centre de recherche</a>:

note: type: \t; header
en: Done by <a object|labo>AutoLab</a>:
fr: Effectuée par le <a object|labo>laboratoire d'analyse de matières organiques</a>:

note: type: \t; header
en: Impossible to research:
fr: Impossible d'effectuer la recherche :

note: type: Plain text
en: Rounds a number.
fr: Arrondir un nombre.

note: type: Plain text
en: Rounded <code>value</code>. For example, <code>round(2.5)</code> is <code>3.0</code>, whereas <code>round(2.4)</code> is <code>2.0</code>.
fr: Arrondir <code>valeur</code>. Par exemple, <code>round(2.5)</code> donne<code>3.0</code>, tandis que<code>round(2.4)</code> retourne <code>2.0</code>.

note: type: Plain text
en: <a cbot|trunc>trunc</a>, <a cbot|floor>floor</a>, <a cbot|ceil>ceil</a>, <a cbot>programming</a>, <a cbot|type>types</a> and <a cbot|expr>expressions</a>.
fr: <a cbot|trunc>trunc</a>, <a cbot|floor>floor</a>, <a cbot|ceil>ceil</a>, <a cbot>programmation</a>, <a cbot|type>types</a> et <a cbot|expr>expressions</a>.

note: type: Plain text
en: Detects the object of the given category that is closest to the given position. Similar to <c/><a cbot|radar>radar();</a><n/>, but can search starting from the specific point instead of the actual bot's position.
fr: Détecte l'objet de la catégorie donnée qui est le plus proche de la position donnée. Similaire à <c/><a cbot|radar>radar();</a><n/>, mais peut commencer à rechercher à partir du point spécifique au lieu de depuis la position actuelle du robot.

note: type: Bullet: 'o'
en: <a cbot|category>Category</a> of the objects that should be detected. For example, when you are looking for an ant, write <code>search(AlienAnt)</code>.
fr: <a cbot|category>Catégorie</a> des objets qui doivent être détectés. Par exemple, lorsque vous cherchez une fourmi, écrivez <code>search(AlienAnt)</code>.

note: type: Bullet: 'o'
en: <a cbot|array>Array</a> of categories of the objects that should be detected. For example, when you are looking only for grabbers, starting from a certain point in the level:
fr: <a cbot|array>Tableau</a> de catégories des objets à détecter. Par exemple, lorsque vous cherchez uniquement des préhenseurs; en commençant depuis un certain point du niveau :

note: type: \t; header
en: position: <code><a cbot|point>point</a></code> (default value: <code><a cbot|this>this</a>.<a cbot|object>position</a></code>)
fr: position: <code><a cbot|point>point</a></code> (valeur par défaut: <code><a cbot|this>this</a>.<a cbot|object>position</a></code>)

note: type: Plain text
en: Sine of the angle.
fr: Sinus d'un angle.

note: type: Plain text
en: Non-negative number.
fr: Nombre non-négatif.

note: type: Plain text
en: Square root of the value.
fr: Racine carrée d'une valeur.

note: type: \b; header
en: Instructions <code>switch</code>, <code>case</code> and <code>default</code>
fr: Instructions <code>switch</code>, <code>case</code> et <code>default</code>

note: type: Plain text
en: With the instruction <code>switch() {}</code> you can execute a proper set of instructions (a case) basing on some value.
fr: Avec l'instruction <code>switch() {}</code> vous pouvez exécuter un ensemble approprié d'instructions ("case") en vous basant sur chaque valeur voulue.

note: type: Plain text
en: See the following <a cbot|function>function</a>: the bot will be <a cbot|wait>waiting</a> a proper amount of time for a certain task to be completed:
fr: Voir la <a cbot|function>fonction</a> suivante : le robot sera en train d'<a cbot|wait>attendre</a> un temps approprié pour une certaine tâche à accomplir :

note: type: Plain text
en: This function can be also written using the <code>switch() {}</code> instruction:
fr: Cette fonction peut également être écrite en utilisant l'instruction <code>switch() {}</code> :

note: type: Plain text
en: Which way to write this kind of choice structures, is a matter of taste.
fr: Cette façon d'écrire ce genre de structures de choix est une question de goût.

note: type: Plain text
en: You can also make cases like this:
fr: Vous pouvez aussi faire des "cases" regroupés comme celui-ci :

note: type: Plain text
en: <a object|convert>Converter</a> and <a object|factory>bot factory</a> have the same waiting time, so in order to not write the same instructions twice, we made multiple cases run the same code. In fact, all code after the highest case used will be executed if we do not <code><a cbot|break>break</a></code> it.
fr: La <a object|convert>raffinerie</a> et l'<a object|factory>usine de robots</a> ont le même temps d'attente, donc afin de ne pas écrire les mêmes instructions deux fois, nous avons fait exécuter le même code dans plusieurs cas. En fait, tout le code après le "case" le plus haut sera exécuté si nous ne faisons pas de <code><a cbot|break>break</a></code>.

note: type: Source code
en: <c/>switch ( value )
    {
    	case value1: instructions1
    	case value2: instructions2
    	...
    	case valueN: instructionsN
    	default: instructionsDefault
    }
fr: <c/>switch ( value )
    {
    	case value1: 		instructions1;
    		break;
    	case value2: 		instructions2;
    		break;
    	...
    	case valueN: 		instructionsN;
    		break;
    	default: 
    		instructionsDefault;
    } <n/> Ici, ça ne ferait qu'une instruction selon le cas, 
    Si on étudie plutôt cette forme : 
    <c/> <c/>switch ( value )
    {
    	case value1: instructions1
    	case value2: instructions2
    	...
    	case valueN: instructionsN
    		break;
    	default: instructionsDefault
    }

note: type: Plain text
en: With this conditional structure you can execute <code>instructions1</code> or <code>instructions2</code> ... or <code>instructionsN</code> or <code>instructionsDefault</code> depending on the <code>value</code>.
fr: Avec cette structure conditionnelle, vous pouvez exécuter <code>instructions1</code> ou <code>instructions2</code> ou <code>instructionsN</code> ou <code>instructionsDefault</code> selon le <code> valeur</code> puis toutes les autres (tant qu'il n'y a pas de break et que le bloc du switch n'est pas terminé).

note: type: Plain text
en: If the <code>value</code> is equal to <code>value1</code>, <code>instructions1</code> to <code>N</code> (including <code>instructionsDefault</code>) are executed.
    If the <code>value</code> is equal to <code>value2</code>, <code>instructions2</code> to <code>N</code> (including <code>instructionsDefault</code>) are executed.
    And so on.
    If the <code>value</code> is equal to <code>valueN</code>, <code>instructionsN</code> and <code>instructionsDefault</code> are executed.
    If the <code>value</code> is not equal to any value in the given cases, <code>instructionsDefault</code> are executed.
fr: Si <code>value</code> est égal à <code>value1</code>, alors on exécute <code>instructions1</code> jusqu'à <code>N</code> .
    Si <code>value</code> est égal à <code>value2</code>, alors on exécute <code>instructions2</code> jusqu'à <code>N</code> .
    etc...
    Si <code>value</code> est égal à <code>valueN</code>, alors on exécute <code>instructionsN</code>.
    Si <code>value</code> ne fait pas partie des valeurs citées dans les "cases", alors on exécute <code>instructionsDefault</code>.

note: type: Plain text
en: You can exit from the the <code>switch() {}</code> instruction using <code><a cbot|break>break</a></code>.
fr: Vous pouvez quitter l'instruction <code>switch() {}</code> en utilisant <code><a cbot|break>break</a></code>.

note: type: Plain text
en: Do not put a <a cbot|term>semicolon</a> at the end of the <code>switch ( ) { }</code> instruction.
fr: Il ne faut pas mettre de <a cbot|term>point-virgule</a> à la fin de l'instruction <code>switch ( ) { }</code>.

note: type: Plain text
en: Normally an error stops the program. You can prevent the program from stopping on errors by using the <code><a cbot|errmode>errmode</a>(0)</code> instruction. A value different from zero if an error occurred is then returned by <code>takeoff()</code>.
    <code>== 0 </code>Spaceship takes off
    <code>!= 0 </code>Spaceship could not take off (e.g. mission is not finished yet)
fr: Normalement, une erreur arrête le programme. Vous pouvez empêcher le programme de s'arrêter en cas d'erreur en utilisant l'instruction <code><a cbot|errmode>errmode</a>(0)</code>. Une valeur différente de zéro en cas d'erreur est alors retournée par <code>takeoff()</code>.
    <code>== 0 </code>Le vaisseau spatial se referme puis décolle
    <code>!= 0 </code>Le vaisseau spatial n'a pas pu décoller (par exemple, la mission n'est pas encore terminée ou quelque chose empêche les portes de se refermer)

note: type: Plain text
en: Angle in degrees (except multiples of 90).
fr: Angle en degrés (en ne précisant jamais de multiples de 90).

note: type: Plain text
en: Tangent of the angle.
fr: Tangente d'un angle.

note: type: Plain text
en: Truncation is a method of approximating a decimal number by dropping all decimal places past a certain point without rounding. For positive numbers, it works like the <c/><a cbot|floor>floor();</a><n/> function, and for negative numbers, it works like the <c/><a cbot|ceil>ceil();</a><n/> function. It can be said that it rounds towards zero.
fr: La troncature est une méthode d'approximation d'un nombre décimal en enlevant les décimales après un certain point sans arrondir. Pour les nombres positifs, il fonctionne comme la fonction <c/><a cbot|floor>floor();</a><n/>, et pour les nombres négatifs, il fonctionne comme la fonction <c/><a cbot|ceil>ceil();</a><n/>. On peut dire qu'il s'arrondit vers zéro.

note: type: Plain text
en: Truncated <code>value</code>. For example, <code>trunc(-2.5)</code> is <code>-2.00</code>.
fr: <code>Valeur tronquée</code>. Par exemple, <code>trunc(-2.5)</code> donne<code>-2.00</code>.

note: type: Plain text
en: In a program, categories are always displayed like that: <format const>category</format>. If a category isn't highlighted, it is misspelled. Caps and lower cases should be kept as is.
fr: Dans un programme, les catégories sont toujours affichées comme ça : <format const>catégorie</format>. Si une catégorie n'est pas surlignée, c'est qu'elle est mal orthographiée. Les majuscules et les minuscules doivent être conservées telles quelles.

note: type: Plain text
en: In a program, the name of a type is always displayed like that: <format type>type</format>. If the name of a type is not highlighted, this means that the name is misspelled. Type names are always written with lower case characters. Here is a list of the different types:
fr: Dans un programme, le nom d'un type est toujours affiché comme ça : <type de format>type</format>. Si le nom d'un type n'est pas surligné, cela signifie que le nom est mal orthographié. Les noms de type sont toujours écrits en minuscules. Voici une liste des différents types :

note: type: Bullet: 'o'
en: r
fr: ou

note: type: Plain text
en: Immediately creates an <a cbot|category>object</a>.
fr: Créer immédiatement un <a cbot|category>objet</a>.

note: type: Plain text
en: Orientation (angle) of the object.
fr: Orientation (angle) de l'objet.

note: type: Plain text
en: <a cbot|category>Category</a> of the object.
fr: <a cbot|category>Catégorie</a> de l'objet.

note: type: Plain text
en: Energy level.
fr: Niveau d'énergie.

note: type: \t; header
en: Return: <code><a cbot|void>void</a></code>
fr: Type du retour: aucun (<code><a cbot|void>void</a></code>)

note: type: Plain text
en: Nothing.
fr: Rien.

note: type: \b; header
en: Example usage
fr: Exemple d'utilisation

note: type: Plain text
en: It is used by <a object|mother>AlienQueen</a> to produce <a object|egg>AlienEggs</a>.
fr: Cette fonction est utilisée par <a object|mother>la reine mère alien</a> pour produire ses <a object|egg>œufs</a>.

note: type: Plain text
en: Where object will be created. The second syntax creates the object at the current bot's position.
fr: Où l'objet sera créé. La seconde syntaxe crée l'objet à la position actuelle du robot.

note: type: Plain text
en: Program for the object. Will have effect only for programmable objects like robots or aliens.
fr: Programme pour l'objet. N'aura d'effet que pour les objets programmables comme les robots ou les aliens.

note: type: Plain text
en: Expressions are used for various calculations with many different variables, which return the desired result. What distinguishes them from standard instructions are operators, which are described below.
fr: Des expressions sont utilisées pour différents calculs avec de nombreuses variables différentes, qui donnent le résultat souhaité. Ce qui les distingue des instructions standard, ce sont les opérateurs, qui sont décrits ci-dessous.

note: type: \b; header
en: Binary operations
fr: Opérateurs binaires

note: type: Plain text
en: Assuming that <code>a</code>, <code>b</code> can be values of declared and initialized variables of types <code>t1</code> and <code>t2</code>, the binary operations can be described as follows:
fr: En supposant que <code>a</code> et <code>b</code> peuvent être des valeurs de variables déclarées et initialisées de types <code>t1</code> et <code>t2</code>, les opérations binaires peuvent être décrites ainsi :

note: type: Plain text
en: Where <code>r</code> is the result of the operation and <code>op</code> is a binary operator which works with values of types <code>t1</code> and <code>t2</code>.
fr: Où <code>r</code> est le résultat de l'opération et <code>op</code> est un opérateur binaire qui travaille avec des valeurs de types <code>t1</code> et <code>t2</code>.

note: type: \t; header
en: Order of operations
fr: Ordre des opérations

note: type: Plain text
en: Let <code>a op1 b op2 c</code> be a legal expression, then the following rules apply:
fr: En admettant que <code>a op1 b op2 c</code> soit une expression légale, alors les règles suivantes s'appliquent :

note: type: Bullet: 'o'
en: If <code>op1 == op2</code> or <code>op1</code> is as strong as <code>op2</code> or <code>op1</code> is stronger than <code>op2</code>, first calculate <code>a op1 b</code> and store its result in a temporary variable <code>r</code>, then calculate <code>r op2 c</code>, which is the final result of the expression.
fr: Si <code>op1 == op2</code> ou <code>op1</code> est aussi fort que <code>op2</code> ou <code>op1</code> est plus fort que <code>op2</code>, calcule d'abord <code>a op1 b</code> et stocker son résultat dans une variable temporaire <code>r</code>, puis calcule <code>r op2 c</code>, qui correspond au résultat final de l'expression.

note: type: Bullet: 'o'
en: If <code>op1</code> is weaker than <code>op2</code>, first calculate <code>b op2 c</code> and store its result in a temporary variable <code>r</code>, then calculate <code>a op1 r</code>, which is the final result of the expression.
fr: Si <code>op1</code> est moins fort que <code>op2</code>, calcule d'abord <code>b op2 c</code> et enregistrer son résultat dans une variable temporaire <code>r</code>, puis calcule <code>a op1 r</code>, qui correspond au résultat final de l'expression.

note: type: Plain text
en: Note: an operation can be made stronger by surrounding it in brackets, so for example assuming that <code>op1</code> is weaker than <code>op2</code>, in an expression <code>(a op1 b) op2 c</code> the <code>a op1 b</code> operation will be executed first.
fr: Note : une opération peut être rendue plus forte en l'entourant entre parenthèses, par exemple en supposant que <code>op1</code> est plus faible que <code>op2</code>, dans une expression <code>(a op1 b) op2 c</code> le <code>a op1 b</code> sera la premier opération exécutée.

note: type: Plain text
en: Tip: always use brackets if you are not sure about the order of operations, do not try to remember how strong are each of the operators. Generally it should be fairly obvious.
fr: Conseil : toujours utiliser des parenthèses si vous n'êtes pas sûr de l'ordre des opérations, n'essayez pas de vous rappeler la force de chacun des opérateurs. En général, cela devrait être assez évident.

note: type: Plain text
en: Here is a complicated example, which uses arithemtic operations described below, showing how expressions are calculated:
    <c/>Assume a, b, c, d, x, y, z, e are all initialized variables of type float or int. Then the following expression should be calculated the following way:
      a * b + c - d / x % (y * z) - e =
    = r1 + c - d / x % (y * z) - e    = , r1 = a * b
    = r2 - d / x % (y * z) - e        = , r2 = r1 + c
    = r2 - r3 % (y * z) - e           = , r3 = d / x
    = r2 - r3 % r4 - e                = , r4 = y * z
    = r2 - r5 - e                     = , r5 = r3 % r4
    = r6 - e                          = , r6 = r2 - r5
    = r7                                , r7 = r6 - e
    r7 is the final result of this expression.
fr: Voici un exemple compliqué, qui utilise les opérations arithmétiques décrites ci-dessous, montrant comment les expressions sont calculées:
    <c/>Supposons que a, b, c, d, e, x, y et z sont toutes des variables initialisées de type float ou int. Ensuite, l'expression suivante devrait être calculée de la manière suivante :
     a * b + c - d / x % (y * z) - e = ?? 
    = r1 + c - d / x % (y * z) - e , avec r1 = a * b
    = r2 - d / x % (y * z) - e ,       avec r2 = r1 + c
    = r2 - r3 % (y * z) - e  ,          avec r3 = d / x
    = r2 - r3 % r4 - e ,                 avec r4 = y * z
    = r2 - r5 - e ,                          avec r5 = r3 % r4
    = r6 - e ,                               avec r6 = r2 - r5
    = r7,                                      avec r7 = r6 - e
    r7 est le résultat de cette expression.

note: type: \b; header
en: Assignment operator
fr: Opérateur d'affectation

note: type: Plain text
en: <code>=</code> is the assignment operator. It is used to store the result of an expression in a variable.
fr: <code>=</code> est l'opérateur d'affectation. Il permet de stocker le résultat d'une expression dans une variable.

note: type: Plain text
en: On the left side of this operator there must be so called l-value and on the right side - r-value. L-values are just <a cbot|var>variables</a><n/>, r-values are expressions or just usual values. This makes the assignment operator kind of special, because what is l-value is pretty restrictive (it cannot be an expression, constant and so on, only single variable). Also, the type of l-value must match the type of r-value (unless a conversion is possible, for example assigning a <code><a cbot|float>float</a></code> to <code><a cbot|int>int</a></code>).
fr: Sur le côté gauche de cet opérateur il doit y avoir la valeur dite "l-value" et sur le côté droit la valeur "r-value". La valeur "l-value" ne peuvent être que des <a cbot|var>variables</a><n/>, les valeurs "r-value" sont des expressions ou juste des valeurs standard. Ceci rend l'opérateur d'assignation assez spéciale, parce que la l-value est assez restrictive (elle ne peut pas être une expression, constante et ainsi de suite, seulement une variable). De plus, le type de l-value doit correspondre au type de valeur r-value (à moins qu'une conversion ne soit possible, par exemple en assignant un <code><a cbot|float>réel (float)</a></code> dans un <code><a cbot|int>entier (int)</a></code>).

note: type: Plain text
en: This example is actually really confusing, but this property is actually useful, because it lets doing something like this:
fr: Cet exemple est en fait vraiment déroutant, mais cette propriété est en fait utile, car elle permet de faire quelque chose comme ceci :

note: type: \b; header
en: Basic arithmetic operations
fr: Opérations arithmétiques de base

note: type: Plain text
en: Binary operators below are working with fundamental number types (<code><a cbot|int>int</a></code>, <code><a cbot|float>float</a></code>).
fr: Les opérateurs binaires ci-dessous fonctionnent avec les types de nombres fondamentaux (<code><a cbot|int>int</a></code>, <code><a cbot|float>float</a></code>).

note: type: \t; header
en: List
fr: Listes

note: type: Plain text
en: <code>+</code>  addition
    <code>-</code>  subtraction
    <code>*</code>  multiplication
    <code>/</code>  division
    <code>%</code>  remainder of the division (only for the type <code><a cbot|int>int</a></code>)
fr: <code>+</code>  addition
    <code>-</code>   soustraction
    <code>*</code>  multiplication
    <code>/</code>   division
    <code>%</code>  reste de la division ( seulement pour le type <code><a cbot|int>int</a></code>)

note: type: Bullet: 'o'
en: The <code>*</code>, <code>/</code>, <code>%</code> are all stronger than <code>+</code> and <code>-</code>.
fr: Les opérations <code>*</code>, <code>/</code>, <code>%</code> sont plus fortes que <code>+</code> et <code>-</code>.

note: type: Bullet: 'o'
en: The result <a cbot|type>type</a> is always <code><a cbot|float>float</a></code>. If <code>a</code> or <code>b</code> are of type <code><a cbot|int>int</a></code>, they are automatically converted to <code><a cbot|float>float</a></code>. Note: this means that results of intermediate calculations tends to be as precise as possible, the precision is lost only during converting the final (<code><a cbot|float>float</a></code>) result to <code><a cbot|int>int</a></code>, for example by the assignment <code>=</code> operator.
fr: Le <a cbot|type>type</a>de résultat est toujours <code><a cbot|float>float</a></code>. Si <code>a</code> ou <code>b</code> sont de type <code><a cbot|int>int</a></code>, ils sont automatiquement convertis en <code><a cbot|float>float</a></code>. 
    Note : cela signifie que les résultats des calculs intermédiaires ont tendance à être aussi précis que possible, la précision n'est perdue que lors de la conversion du résultat final (<code><a cbot|float>float</a></code>) en <code><a cbot|int>int</a></code>, par exemple avec l'opérateur d'assignation <code>=</code>.

note: type: \t; header
en: Real life examples
fr: Exemples dans la vie réelle

note: type: \t; header
en: Compound assignment operators
fr: Opérateurs d'assignation composée

note: type: Plain text
en: Besides the <code>=</code> operator for variable assignment there are several compound-assignment operators.
fr: En plus de l'opérateur <code>=</code> pour l'assignation de variables, il existe plusieurs opérateurs d'assignation composée.

note: type: Plain text
en: The compound-assignment operators combine the <code>=</code> assignment operator with another binary operator such as <code>+</code> or <code>-</code>. Compound-assignment operators perform the operation specified by the additional operator and then assign the result to the left operand. For example, a compound-assignment expression such as
fr: Les opérateurs d'assignation composée combinent l'opérateur assignation <code>=</code> avec un autre opérateur binaire tel que <code>+</code> ou <code>-</code>. Les opérateurs d'assignation composée effectuent l'opération spécifiée par l'opérateur supplémentaire et affectent ensuite le résultat à l'opérande de gauche. Par exemple, une expression d'affectation composée telle que

note: type: \b; header
en: String concatenation
fr: Concaténation de chaînes (string)

note: type: Plain text
en: If at least one of the values used with the <code>+</code> operator is a <a cbot|string>string</a>, then the operation of concatenation is performed. The result of the operator is then a string, which is created by joining end-to-end the string and the other value. If the other value is not a string, then it is converted to string beforehand.
fr: Si au moins une des valeurs utilisées avec l'opérateur <code>+</code> est un <a cbot|string>string</a>, l'opération de concaténation est effectuée. Le résultat de l'opérateur est alors une chaîne, qui est créée en joignant la chaîne de bout en bout et l'autre valeur. Si l'autre valeur n'est pas une chaîne de caractères, elle est convertie en chaîne au préalable.

note: type: Source code
en: 	string s = "a" + "bc";  // returns "abc"
    	string s = 1 + "bc";    // returns "1bc"
    	string s = 2.5 + "bc";  // returns "2.5bc"
    	string s = "a" + true;  // returns "atrue"
fr: 	string s = "a" + "bc";  // retourne "abc"
    	string s = 1 + "bc";      // retourne "1bc"
    	string s = 2.5 + "bc";    // retourne "2.5bc"
    	string s = "a" + true;    // retourne "atrue"

note: type: Plain text
en: Tip: the properties of the concatenation <code>+</code> operator is useful with the <a cbot|message>message();</a> function, because it does not work with other types than string. An empty string can be used together with a value in order to create a string, which actually can be passed to the <a cbot|message>message();</a> function:
fr: Astuce : les propriétés de l'opérateur concaténation <code>+</code> sont utiles avec la fonction <a cbot|message>message();</a>, car elle ne fonctionne pas avec d'autres types que la chaîne. Une chaîne vide peut être utilisée avec une valeur pour créer une chaîne, qui peut être passée à la fonction <a cbot|message>message();</a> :

note: type: \b; header
en: Prefix and postfix increment- and decrement operators
fr: Opérateurs préfixés et postfixés d'incrémentation et de décrémentation

note: type: Plain text
en: For example to increment the variable <code>a</code> you can write
fr: Par exemple pour pré-incrémenter la variable <code>a</code> vous pouvez écrire

note: type: Plain text
en: instead of
fr: au lieu de

note: type: Plain text
en: The result of the operation <code>a++</code> is the value of the variable <code>a</code> *before* the increment. If you use the prefix operator <code>++a</code> the result of the operation is the value of the variable <code>a</code> *after* the increment. The same holds for the <code>--</code> decrement operator.
fr: Le résultat de l'opération <code>a++</code> est la valeur de la variable <code>a</code> *avant* l'incrément. Si vous utilisez le préfixe opérateur <code>++a</code> le résultat de l'opération est la valeur de la variable <code>a</code> *après* l'incrément. Il en va de même pour l'opérateur <code>--</code> de décrémentation.

note: type: Plain text
en: Specifically speaking, an expression is an ordered series of operations which yield a result. Operations consist of operators, which are special <a cbot|function>functions</a> <code>T f(t1 x1, t2 x2, ..., tn xn)</code>, where <code>xi</code> is a value of type <code>ti</code>, and <code>T</code> is the result type. For example, <code>float +(float a, float b)</code> returns a sum of values <code>a</code> and <code>b</code>. Note: Operators are a part of the CBOT language and they cannot be defined in program. Also, the operators cannot be used as usual <a cbot|function>functions</a>, they need to be written using a special notation depending on the operator, for example <code>a+b</code>.
fr: Plus précisément, une expression est une série ordonnée d'opérations qui donnent un résultat. Les opérations se composent d'opérateurs, qui sont des <a cbot|function>fonctions</a> spéciales <code>T f(t1 x1, t2 x2, ..., tn xn)</code>, où <code>xi</code> est une valeur du type <code>ti</code> et <code>T</code> est le type de résultat. 
     Par exemple, <code>float +(float a, float b)</code> renvoie une somme de valeurs <code>a</code> et <code>b</code>. 
    Note : Les opérateurs font partie du langage CBOT et ne peuvent pas être définis dans le programme. De plus, les opérateurs ne peuvent pas être utilisés comme les <a cbot|function>fonctions</a> habituelles , elles doivent être écrites avec une notation spéciale selon l'opérateur, par exemple <code>a+b</code>.

note: type: Plain text
en: In nearly all operations, <a cbot>constants</a>, <a cbot|var>variables</a>, <a cbot|function>functions</a> returning non-<a cbot|void>void</a> type and also other operations can be used as values.
fr: Presque toutes les opérations, <a cbot>constantes</a>, <a cbot|var>variables</a>, <a cbot|function>fonctions</a> et d'autres, sauf le type <a cbot|void>void</a>, peuvent être utilisées comme valeurs.

note: type: Plain text
en: Note: it may be not obvious at first, but notice that <code>=</code> is an *operator* not an instruction. This mean that it can be used in the middle of an other expression! The result of <code>=</code> is the value which was assigned to the l-value - the result of the expression on the right. Example:
fr: Note : ce n'est peut-être pas évident au début, mais remarquez que <code>=</code> est un *opérateur* et non une instruction. Cela signifie qu'il peut être utilisé au milieu d'une autre expression ! Le résultat de <code>=<</code> est la valeur attribuée à la valeur de droite. Exemple :

note: type: Source code
en:  int    i = 12 + 3;      // i == 15
     int    i = 2 - 5;       // i == -3
     
     float  f = 3.01 * 10;   // f == 30.1
     
     int    i = 5 / 3;       // i == 1 (automatic conversion to int)
     float  f = 5 / 3;       // f == 1.67
     float  f = 5 / 0;       // returns an error (division by zero)
     
     int    i = 13 % 5;      // i == 3
     int    i = -8 % 3;      // i == -2
     
     float  f = sin(90) * i; // f == -2.0
fr:  int    i = 12 + 3;      // i == 15
     int    i = 2 - 5;       // i == -3
     
     float  f = 3.01 * 10;   // f == 30.1
     
     int    i = 5 / 3;       // i == 1 ( conversion automatique en int)
     float  f = 5 / 3;       // f == 1.67
     float  f = 5 / 0;       // retourne une erreur (division par zéro)
     
     int    i = 13 % 5;      // i == 3
     int    i = -8 % 3;      // i == -2
     
     float  f = sin(90) * i; // f == -2.0

note: type: Source code
en:  float pi = 3.14;
     // message(pi); // does not work
     message(""+pi);
fr:  float pi = 3.14;
     // message(pi); // ne fonctionnerait pas : une chaîne est attendue en paramètre de message....
     message(""+pi);	//fonctionne

note: type: Source code
en:  a = 2;
     b = a++;
     // now b contains 2 and a contains 3
fr:  a = 2;
     b = a++; 
     // ici, b contient 2 et a contient 3

note: type: Source code
en:  a = 2;
     b = ++a;
     // now b contains 3 and a contains 3
fr:  a = 2;
     b = ++a; 
     // ici, b contient 3 et a contient 3

note: type: \b; header
en: Logical operators
fr: Opérateurs logiques

note: type: Plain text
en: Logical operators work with values of type <a cbot|bool>bool</a> and they always return a <a cbot|bool>bool</a>. They are mainly used in <a cbot|cond>conditions</a>.
fr: Les opérateurs logiques travaillent avec des valeurs de type booléennes <a cbot|bool>bool</a> et retournent toujours un <a cbot|bool>bool</a>. Elles sont principalement utilisées dans des <a cbot|cond>conditions</a>.

note: type: \b; header
en: Ternary operator
fr: Opérateur ternaire

note: type: Plain text
en: The ternary operator is nothing more than a syntax sugar. It is also known as "inline if". It might be confusing at first, because its syntax is a little more complicated than other operators. It can be described as follows:
    <code>(condition) ? (result when true) : (result when false)</code>
    Brackets are not needed.
fr: L'opérateur ternaire n'est rien de plus qu'un astuce syntaxique. Il est également connu sous le nom de "inline if". Il peut être déroutant au début, parce que sa syntaxe est un peu plus compliquée que celle des autres opérateurs. Elle peut être décrite comme suit:
    <code>(condition) ? (résultat quand vrai) : (résultat quand faux)</code>
    Les parenthèses ne sont pas nécessaires.

note: type: Plain text
en: Firstly, the condition is valued and then the first result is returned if the condition is true, otherwise the second result is returned.
fr: Tout d'abord, la condition est évaluée, puis le premier résultat est retourné si la condition est vraie, sinon le second résultat est retourné.

note: type: \t; header
en: Example
fr: Exemple

note: type: Plain text
en: A condition is a special <a cbot|expr>expression</a> that returns a <a cbot|bool>boolean</a> value, that can only be either <code><a cbot|true>true</a></code> or <code><a cbot|false>false</a></code>. With a condition, you can choose f. ex. if the instructions in a <code><a cbot|while>while</a></code> loop must be repeated again, or if the instruction in a <code><a cbot|if>if</a></code> bloc must be executed.
fr: Une condition est une <a cbot|expr>expression</a> spéciale  qui retourne une valeur <a cbot|bool>booléenne</a>, qui peut être soit <code><a cbot|true>vraie (true)</a></code> soit <code><a cbot|false>fausse (false)</a></code>. Avec une condition, vous pouvez choisir par exemple si les instructions dans une boucle <code><a cbot|while>while</a></code> doivent être répétées à nouveau, ou si l'instruction dans un bloc <code><a cbot|if>if</a></code> doit être exécutée.

note: type: \b; header
en: Comparison operators
fr: Opérateurs de comparaison

note: type: Plain text
en: Comparison operators work with values of type <a cbot|bool>float</a> and they always return a <a cbot|bool>bool</a>. They are mainly used in <a cbot|cond>conditions</a>.
fr: Les opérateurs de comparaison travaillent avec des valeurs de type <a cbot|bool>float</a> et retournent toujours un <a cbot|bool>booléen (bool)</a>. Ils sont principalement utilisés dans les <a cbot|cond>conditions</a>.

note: type: Plain text
en: <code>!a      </code>not <code>a</code>
    <code>a && b  </code><code>a</code> and <code>b</code>
    <code>a || b  </code><code>a</code> or <code>b</code>
fr: <code>!a      </code>// inverse de <code>a</code>
    <code>a && b  </code>// <code>a</code> ET <code>b</code>
    <code>a || b  </code>// <code>a</code> OU <code>b</code>

note: type: Plain text
en: <code>!false        </code>returns true
    <code>true && false </code>returns false 
    <code>true || false </code>returns true
fr: <code>!false        </code>// retourne vrai (true)
    <code>true && false </code>// retourne faux (false) 
    <code>true || false </code>// retourne vrai (true)

note: type: \b; header
en: Bitwise operators
fr: Opérateurs bits à bits

note: type: Plain text
en: Bitwise operators are similar to the logical operator, because they are operating on bits (which can be only 0 or 1, conditions can have a value only of false or true). So in theory, they should be working with basically any type of variable, because each value in the computer must be stored as a sequence of bits.
fr: Les opérateurs bits à bits sont similaires aux opérateurs logiques, parce qu'ils opèrent sur des bits (qui peuvent être seulement 0 ou 1, les conditions peuvent valoir seulement une valeur faux ou vrai). Donc, en théorie, ils devraient fonctionner avec n'importe quel type de variable, parce que chaque valeur dans l'ordinateur doit être stockée sous la forme d'une séquence de bits.

note: type: Plain text
en: <code>a & b  </code><code>a</code> AND <code>b</code>
    <code>a | b  </code><code>a</code> OR <code>b</code>
    <code>a ^ b  </code><code>a</code> XOR <code>b</code>
    <code>a >> b  </code>shift bits of <code>a</code> to the right <code>b</code> times
    <code>a << b  </code>shift bits of <code>a</code> to the left <code>b</code> times
fr: <code>a & b  </code><code>a</code> ET <code>b</code>
    <code>a | b  </code><code>a</code> OU <code>b</code>
    <code>a ^ b  </code><code>a</code> OU EXCUSIF (XOR) <code>b</code>
    <code>a >> b  </code>décale les bits de <code>a</code> <code>b</code> fois vers la droite 
    <code>a << b  </code>décale les bits of <code>a</code> <code>b</code>  fois vers la gauche

note: type: Plain text
en: <code>2 & 1         </code>returns 0
    <code>2 | 1         </code>returns 3
    <code>2 ^ 2         </code>returns 0
    <code>2 >> 1        </code>returns 1
    <code>2 << 1        </code>returns 4
fr: <code>2 & 1         </code>retourne 0
    <code>2 | 1         </code>retourne 3
    <code>2 ^ 2         </code>retourne 0
    <code>2 >> 1        </code>retourne 1
    <code>2 << 1        </code>retourne 4

note: type: Source code
en: int    [ ] a;   // an array of int
    int    a [12];  // an array of int limited to 12 elements
    string s[3];    // an array of 3 strings
    float  xy[][];  // a 2 dimensionnal array of floats
fr: int    [ ] a;   // un tableau d'entiers
    int    a[12];   // un tableau de 12 entiers (! :le nombre d'éléments n'est pas modifiable a priori.)
    string s[3];    // une chaîne (tableau) de 3 caractères
    float  xy[][];  // un tableau de réels à 2 dimensions (taille non spécifiée)

note: type: \b; header
en: Initialization syntax
fr: Syntaxe d'initialisation

note: type: Plain text
en: You can initialize a new array using the following syntax:
fr: Vous pouvez initialiser un nouveau tableau en utilisant la syntaxe suivante :

note: type: Plain text
en: With the instruction <c/>radar();<n/>, you can look for objects like <a object|mother>enemies</a>, bots, buildings or raw materials.
fr: Avec l'instruction <c/><a cbot|radar>radar</a>();<n/>, vous pouvez rechercher des objets comme des <a object|mother>enemis</a>, des robots, des bâtiments ou des matières premières.

note: type: Plain text
en: <c/><a cbot|radarall>radarall</a>();<n/>, <a cbot>programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <c/><a cbot|radarall>radarall</a>();<n/>, <a cbot>programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: <c/>radarall();<n/> is an enhancement of the <c/><a cbot|radar>radar</a>();<n/> function -- it detects all objects matching the given criteria.
fr: <c/>radarall();<n/> est une amélioration de la fonction <c/><a cbot|radar>radar</a>();<n/> -- il détecte tous les objets correspondant au critère donné.

note: type: \b; header
en: Example<c/>
fr: Exemple<c/>

note: type: Plain text
en: The function works generally the same as the <c/><a cbot|radar>radar</a>();<n/> function with the only difference being that it returns an <a cbot|array>array</a> of <a cbot|object>objects</a> instead of one object. If no object is found, <code><a cbot|null>null</a></code> is returned.
fr: La fonction fonctionne de manière générale de la même manière que la fonction <c/><a cbot|radar>radar</a>();<n/>,  la seule différence étant qu'elle renvoie un <a cbot|array>tableau</a> d'<a cbot|object>objects</a> plutôt qu'un seul objet. Si aucun objet n'est trouvé, la "non-valeur" <code><a cbot|null>null</a></code> est retournée.

note: type: Plain text
en: The order of objects in the returned array is sorted by distance and depends on the <code>sens</code> parameter. The first object in the array is the object which would be returned by the <c/>radar();<n/> function called with the exactly same parameters.
fr: L'ordre des objets dans le tableau retourné est trié par distance et dépend du paramètre <code>sens</code>. Le premier objet du tableau est l'objet qui serait renvoyé par la fonction <c/>radar();<n/> appelée avec exactement les mêmes paramètres.

note: type: Plain text
en: <c/><a cbot|radar>radar</a>();<n/>, <a cbot>programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <c/><a cbot|radar>radar</a>();<n/>, , <a cbot>programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: This set of instructions is executed before the first loop instance.
fr: Cet ensemble d'instructions est exécuté avant la première instance de boucle.

note: type: Plain text
en: This set of instructions is executed at the end of every instance of the loop.
fr: Cet ensemble d'instructions est exécuté à la fin de chaque instance de la boucle.

note: type: \t; header
en: Executing more instructions
fr: Exécution d'autres instructions

note: type: Plain text
en: In the <code>before</code> and <code>end</code> part of a <code>for</code> loop you can specify more than one instruction by using comma. Example:
fr: Dans la partie <code>avant</code> et <code>fin</code>d'une boucle <code>pour</code>vous pouvez spécifier plus d'une instruction en utilisant des virgules. Exemple :

note: type: Plain text
en: The output of the above code is <code>1 2 2 1</code>.
fr: L'affichage du code ci-dessus est <code>1 2 2 1 1</code>.

note: type: Plain text
en:        <code><a object|flag>BlueFlag</a>          </code>Blue Flag
           <code><a object|flag>RedFlag</a>           </code>Red Flag
           <code><a object|flag>GreenFlag</a>         </code>Green Flag
           <code><a object|flag>YellowFlag</a>        </code>Yellow Flag
           <code><a object|flag>VioletFlag</a>        </code>Violet Flag
           <code><a object|waypoint>WayPoint</a>          </code>Checkpoint
           <code><a object|target2>Target2</a>           </code>Flying checkpoint
           <code><a object|enerspot>PowerSpot</a>        </code>Underground Energy Deposit
           <code><a object|stonspot>TitaniumSpot</a>      </code>Underground Titanium Deposit
           <code><a object|uranspot>UraniumSpot</a>       </code>Underground Uranium Deposit
fr:               <code><a object|flag>BlueFlag</a>          </code>Drapeau bleu
                  <code><a object|flag>RedFlag</a>           </code>Drapeau rouge
                  <code><a object|flag>GreenFlag</a>         </code>Drapeau vert
                  <code><a object|flag>YellowFlag</a>        </code>Drapeau jaune
                  <code><a object|flag>VioletFlag</a>        </code>Drapeau violet
                  <code><a object|waypoint>WayPoint</a>          </code>Point de passage
                  <code><a object|target2>Target2</a>           </code>Point de passage aérien
                  <code><a object|enerspot>PowerSpot</a>        </code>Énergie sous-terraine
                  <code><a object|stonspot>TitaniumSpot</a>      </code>Strate de Titane
                  <code><a object|uranspot>UraniumSpot</a>       </code>Strate d'Uranium

note: type: Plain text
en: <button 176/>   <code><a object|huston>Houston</a>          </code>Mission Control
    <button 171/>   <code><a object|base>SpaceShip</a>        </code>Spaceship
    <button 160/>   <code><a object|factory>BotFactory</a>       </code>Robot Factory
    <button 163/>   <code><a object|research>ResearchCenter</a>   </code>Research Center
    <button 168/>   <code><a object|radar>RadarStation</a>     </code>Radar
    <button 172/>   <code><a object|exchange>ExchangePost</a>     </code>Information Exchange Post
    <button 169/>   <code><a object|repair>RepairCenter</a>     </code>Repair Center
    <button 165/>   <code><a object|tower>DefenseTower</a>     </code>Defense Tower
    <button 166/>   <code><a object|labo>AutoLab</a>          </code>Organic Matter Analyzer 
    <button 164/>   <code><a object|station>PowerStation</a>     </code>Power Station
    <button 167/>   <code><a object|energy>PowerPlant</a>       </code>Power Cell Factory
    <button 170/>   <code><a object|nuclear>NuclearPlant</a>     </code>Nuclear Plant
    <button 162/>   <code><a object|convert>Converter</a>        </code>Titanium Converter
    <button 161/>   <code><a object|derrick>Derrick</a>          </code>Derrick
    <button 174/>   <code><a object|captor>PowerCaptor</a>      </code>Parabolic Lightning Conductor
    <button 175/>   <code><a object|safe>Vault</a>            </code>Vault
           <code><a object|start>StartArea</a>        </code>Starting Pad
           <code><a object|goal>GoalArea</a>         </code>Finishing Pad
           <code><a object|target1>Target1</a>          </code>Flying target
           <code><a object|nest>AlienNest</a>        </code>Alien Nest
fr: <button 176/>   <code><a object|huston>Houston</a>          </code>Contrôle mission de Huston
    <button 171/>   <code><a object|base>SpaceShip</a>        </code>Vaisseau spacial
    <button 160/>   <code><a object|factory>BotFactory</a>       </code>Usine de robots
    <button 163/>   <code><a object|research>ResearchCenter</a>   </code>Centre de recherches
    <button 168/>   <code><a object|radar>RadarStation</a>     </code>Radar
    <button 172/>   <code><a object|exchange>ExchangePost</a>     </code>Station relais
    <button 169/>   <code><a object|repair>RepairCenter</a>     </code>Centre de réparations
    <button 165/>   <code><a object|tower>DefenseTower</a>     </code>Tour de défence
    <button 166/>   <code><a object|labo>AutoLab</a>          </code>Laboratoire mobile d'analyses
    <button 164/>   <code><a object|station>PowerStation</a>     </code>Station de recharges
    <button 167/>   <code><a object|energy>PowerPlant</a>       </code>Usine de batteries
    <button 170/>   <code><a object|nuclear>NuclearPlant</a>     </code>Centrale nucléaire
    <button 162/>   <code><a object|convert>Converter</a>        </code>Raffinerie
    <button 161/>   <code><a object|derrick>Derrick</a>          </code>Derrick
    <button 174/>   <code><a object|captor>PowerCaptor</a>      </code>Parafoudre
    <button 175/>   <code><a object|safe>Vault</a>            </code>Coffre
           <code><a object|start>StartArea</a>        </code>Plateau de départ
           <code><a object|goal>GoalArea</a>         </code>Plateau d'arrivée
           <code><a object|target1>Target1</a>          </code>Objectif volant
           <code><a object|nest>AlienNest</a>        </code>Nid alien

note: type: Plain text
en: Classes can be only <a cbot|public>public</a>. This means that they can be used by all bots in a mission.
fr: Les classes ne peuvent être que <a cbot|public>publiques</a>. Cela signifie qu'elles peuvent être utilisées par tous les robots dans une mission.

note: type: \b; header
en: Class Members
fr: Membre des classes

note: type: Plain text
en: Class members are fields (<a cbot|var>variables</a>) and methods (<a cbot|function>functions</a>).
fr: Les membres de la classe sont des champs (<a cbot|var>variables</a>) et des méthodes (<a cbot|function>fonctions</a>).

note: type: Plain text
en: For example, the following class dubbed <code>MyClass</code> contains 4 fields (<code>a</code>, <code>b</code>, <code>x</code> and <code>s</code>) and one method (<code>MyFunction</code>).
fr: Par exemple, la classe suivante intitulée <code>MyClass</code> contient 4 champs (<code>a</code>, <code>b</code>, <code>x</code> et <code>s</code>) et une méthode (<code>MyFunction</code>).

note: type: \t; header
en: Member Initialization
fr: Initialisation de variable membre

note: type: Plain text
en: Example:<c/>
fr: Exemple:<c/>

note: type: Plain text
en: As the names of the parameters of the second constructor are the same as the names of the two members <code>a</code> and <code>b</code>, we must use the <code><a cbot|this>this</a></code> <a cbot|pointer>reference</a> to avoid confusion with the parameters' names.
fr: Comme les noms des paramètres du second constructeur sont les mêmes que les noms des deux membres <code>a</code> et <code>b</code>, nous devons utiliser la <a cbot|pointer>référence</a> <code><a cbot|this>this</a></code> pour éviter la confusion avec les noms des paramètres.

note: type: \b; header
en: Object Creation
fr: Création d'objet

note: type: Plain text
en: You can create objects of type <code>YourClass</code> using the <code><a cbot|new>new</a></code> keyword. Example:
fr: Vous pouvez créer des objets de type <code>VotreClasse</code>en utilisant le mot-clé <code><a cbot|new>new</a></code>. Exemple :

note: type: \b; header
en: Object Destruction
fr: Destruction d'objet

note: type: \b; header
en: Passing Objects to Functions
fr: Passage d'objet aux fonctions

note: type: Plain text
en: Objects in CBOT are passed by <a cbot|pointer>reference</a>. This means that when an object is passed to a <a cbot|function>function</a>, the function receives a copy of a pointer to the instance, not a copy of the object, so any modifications on the object will be visible outside of the function.
fr: Les objets dans CBOT sont passés par <a cbot|pointer>référence (:la zone où il est stocké en mémoire)</a>. Cela signifie que lorsqu'un objet est passé à une fonction <a cbot|function>fonction</a>, la fonction reçoit une copie d'un pointeur vers l'instance, pas une copie de l'objet, donc toute modification sur l'objet aura un impact en dehors de la fonction, c'est l'objet réellement qui est modifié.

note: type: \b; header
en: Inheritance
fr: Héritage

note: type: Plain text
en: A class can inherit public and protected members of another class by using the <code><a cbot|extends>extends</a></code> keyword.
fr: Une classe peut hériter des membres publiques et protégés d'une autre classe en utilisant le mot-clé <code><a cbot|extends>extends</a></code>.

note: type: Plain text
en: This keyword allows you to create a class definition by using the following syntax:
fr: Ce mot-clé vous permet de créer une définition de classe en utilisant la syntaxe suivante :

note: type: \t; header
en: All Classes Are Public
fr: Toutes les classes sont publiques

note: type: \t; header
en: Class Members Modifiers
fr: Modification des membres de classe

note: type: \t; header
en: Using <code><a cbot|this>this</a></code>
fr: En utilisant<code><a cbot|this>this</a></code>

note: type: Source code
en: extern void object::Test()
    {
    	MyClass object1();       // Call default constructor (without parameters)
    	MyClass object2(4, 5);   // Call constructor with two int parameters
    	MyClass object3;         // No constructor called, object3 == null
    	object3 = new MyClass(); // We call constructor now, object3 != null
    }
fr: extern void object::Test()
    {
    	MyClass object1();       // Appelle le constructeur par défaut (sans paramètre)
    	MyClass object2(4, 5);   // Appelle le constructeur avec deux paramètres entiers
    	MyClass object3;         // Pas de constructeur appelé, l'object object3 vaut "null"
    	object3 = new MyClass(); // Maintenant, initialise object3 avec le constructeur par défaut, ses membres existent et sont initialisés
    }

note: type: Plain text
en: You can also define a destructor. This must be a <code><a cbot|void>void</a></code> fonction without parameters, which has the same name as the class but prefixed with the <code>~</code> character. The destructor is called automatically as soon as the class instance is no more referenced by anyone. Example:
fr: Vous pouvez également définir un destructeur. Il doit s'agir d'une fonction <code><a cbot|void>void</a></code> sans paramètres, qui porte le même nom que la classe mais préfixé par le caractère <code>~</code>. Le destructeur est appelé automatiquement dès que l'instance de classe n'est plus référencée, cad n'est plus sensée exister. Exemple :

note: type: Source code
en: public class MyClass
    {
    	static private int counter = 0; // instance counter
    	void  MyClass( )
    	{
    		counter++;  // one instance more
    	}
    	void ~MyClass( )
    	{
    		counter--;  // one instance less
    	}
    }
    extern void object::Test()
    {
    	                   // counter == 0
    	MyClass item1( );  // counter == 1
    	MyClass item2( );  // counter == 2
    	item1 = null;      // counter == 1
    }
    // counter == 0
fr: public class MyClass
    {
    	static private int counter = 0; // compteur d'instances
    	void  MyClass( )
    	{
    		counter++;  // une nouvelle instance
    	}
    	void ~MyClass( )
    	{
    		counter--;  // une instance en moins
    	}
    }
    extern void object::Test()
    {
    	                   // counter == 0
    	MyClass item1( );  // counter == 1
    	MyClass item2( );  // counter == 2
    	item1 = null;      // counter == 1
    }
    // counter == 0

note: type: \b; header
en: Accessing Class Members
fr: Accès aux membres d'une classe

note: type: Plain text
en: Class members can be accessed outside of the class definition by using the <code>.</code> operator. Example:
fr: Il est possible d'accéder aux membres de la classe en dehors de leur définition en utilisant l'opérateur <code>.</code>. Exemple :

note: type: Plain text
en: Class members are <a cbot|public>public</a> by default, which means that they are accessible outside of the class definition. They can also be declared as <code><a cbot|private>private</a></code> or <code><a cbot|protected>protected</a></code>. Such members can only be accessed inside of the class definition.
fr: Dans CBOT, les membres du classe sont <a cbot|public>publics (public)</a> par défaut, ce qui signifie qu'ils sont accessibles depuis l'exérieur de la classe. Ils peuvent également -et c'est conseillé- être déclarés comme <code><a cbot|private>privés (private)</a></code> ou <code><a cbot|protected>protégé (protected)</a></code>. Ces membres ne sont alors accessibles qu'à l'intérieur de la définition de classe.

note: type: Plain text
en: Fields and methods can also be declared as <code><a cbot|static>static</a></code>. Methods can be additionaly declared as <code><a cbot|synchro>synchronized</a></code>.
fr: Les champs et méthodes peuvent également être déclarés comme <code><a cbot|static>statique (static)</a></code>. Les méthodes peuvent être déclarées en plus comme <code><a cbot|synchro>synchronisées (synchronized)</a></code>.

note: type: Plain text
en: Another way of initiliazing fields is by defining a constructor which is a special method having the same name as the class. This method will be called automatically at <a cbot|new>creation</a> time of a class instance. Constructors can be <a cbot|function>overloaded</a>.
fr: Une autre façon d'initialiser les champs est de définir un constructeur qui est une méthode spéciale ayant le même nom que la classe. Cette méthode sera appelée automatiquement à chaque <a cbot|new>création</a> d'une instance de la classe. Les constructeurs peuvent être <a cbot|function>surchargés</a>.

note: type: Source code
en: public class MyClass
    {
    	int myField = 0;
    	int MyFunction()
    	{
    		return myField * 2;
    	}
    }
    
    extern void object::Test()
    {
    	MyClass myObject();
    	myObject.myField = 10;
    	message(myObject.MyFunction()); // 20
    	MyClass mySecondObject();
    	mySecondObject.myField = myObject.myField - 2;
    	message(mySecondObject.MyFunction()); // 16
    }
fr: public class MyClass
    {
    	int myField = 0;
    	int MyFunction()	{
    		return myField * 2;
    	}
    }
    
    extern void object::Test()
    {
    	MyClass myObject();
    	myObject.myField = 10;
    	message(myObject.MyFunction()); // 20
    	MyClass mySecondObject();
    	mySecondObject.myField = myObject.myField - 2;
    	message(mySecondObject.MyFunction()); // 16
    }

note: type: Plain text
en: <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|static>static</a></code>, <code><a cbot|synchro>synchronized</a></code>, <code><a cbot|new>new</a></code>, <code><a cbot|pointer>reference</a></code>, <code><a cbot|this>this</a></code>, <code><a cbot|super>super</a></code>, <code><a cbot|extends>extends</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|static>static</a></code>, <code><a cbot|synchro>synchronized</a></code>, <code><a cbot|new>new</a></code>, <code><a cbot|pointer>reference</a></code>, <code><a cbot|this>this</a></code>, <code><a cbot|super>super</a></code>, <code><a cbot|extends>extends</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: This is an access modifier for <a cbot|class>class</a> members. Protected class members can be accessed in a child class, but they can't be accessed outside of classes definitions being part of the same inheritance tree (see the <code><a cbot|extends>extends</a></code> keyword).
fr: Il s'agit d'un modificateur d'accès pour <a cbot|class>membres de classe</a>. Les membres de classe protégés sont accessibles dans la classe elle-même et dans ses classes enfant, mais ils ne sont pas accessibles en dehors des définitions de classes faisant partie de la même arborescence d'héritage (voir le mot clef <code><a cbot|extends>extends</a></code>).

note: type: Source code
en: public class Parent
    {
    	protected int field = 0;
    }
    
    public class Child extends Parent
    {
    	void Print()
    	{
    		message(field);
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.Print(); // 0
    	//child.field = 1; // Error!
    }
fr: public class Mere
    {
    	protected int champProtege = 0;
    }
    
    public class Fille extends Mere
    {
    	void Print()
    	{
    		message(champProtege);
    	}
    }
    
    extern void object::Test()
    {
    	Fille enfant();
    	enfant.Print(); // 0
    	//enfant.champProtege = 1; // Erreur !
    }

note: type: Plain text
en: This is an access modifier for <a cbot|class>class</a> members. Private members are not accessible outside of the class definition.
fr: Il s'agit d'un modificateur d'accès pour <a cbot|class>membres de classe</a>. Les membres privés ne sont pas accessibles en dehors de la définition de la classe.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|protected>protected</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|protected>protected</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: <code>public</code> is also an access modifier for <a cbot|class>class</a> members, which is the default one. Public members can be accessed from outside of the class definition.
fr: <code>public</code> est aussi un modificateur d'accès pour les <a cbot|class>membres de classe</a>, c'est celui par défaut. Il est possible d'accéder aux membres publics en dehors de la définition de la classe. (d'autres langages sont protectifs et par défaut ont leurs membres et méthodes private par défaut)

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|function>functions</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|function>fonctions</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|extends>extends</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|extends>extends</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|this>this</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|this>this</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|super>super</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|super>super</a></code>
     <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: \b; header
en: Inherited Members
fr: Membres hérités

note: type: Plain text
en: Only <code><a cbot|public>public</a></code> and <code><a cbot|protected>protected</a></code> members are inherited. <code><a cbot|private>private</a></code> members are directly inaccessible even for a child, although they can be accessed indirectly through inherited methods.
fr: Seuls les membres <code><a cbot|public>publics</a></code> et <code><a cbot|protected>protégés</a></code> sont hérités. Les membres <code><a cbot|private>privés</a></code> sont inaccessibles directement même pour un enfant, bien qu'ils puissent être accessibles indirectement par des méthodes héritées.

note: type: Plain text
en: Constructors and destructors are not inherited, however, they can be overriden.
fr: Les constructeurs et les destructeurs ne sont pas hérités, cependant, ils peuvent être surchargés (remplacés).

note: type: \b; header
en: Method Overriding
fr: Surcharges de méthode

note: type: Plain text
en: Inherited methods can be overriden (redefined) in the child class definition. Example:
fr: Les méthodes héritées peuvent être redéfinies dans la définition de classe enfant. Exemple :

note: type: Source code
en: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void foo()
    	{
    		message("bar");
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.foo(); // Will show "bar"
    }
fr: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void foo()
    	{
    		message("bar");
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.foo(); // Affichera : "bar"
    }

note: type: \b; header
en: Polymorphism
fr: Polymorphisme

note: type: Plain text
en: <code><a cbot|pointer>Reference</a></code> of type Parent can point to an object of type Child. However, such a pointer can't be used to access a child member. In order to access a child member, it must be assured that the Parent reference really points to a Child object. If that's the case, it can be safely copied to a pointer of type Child, which has access to the child members.
fr: Les <code><a cbot|pointer>références</a></code> de type Parent peuvent pointer vers un objet de type enfant.
    Cependant, un tel pointeur ne peut pas être utilisé pour accéder à un membre enfant. Pour accéder à un enfant membre, il faut s'assurer que la référence à Parent pointe réellement vers un objet Enfant. Si c'est le cas, il peut être copié en toute sécurité sur un pointeur de type Child, qui a accès aux membres de l'enfant.

note: type: Source code
en: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void foo()
    	{
    		message("bar");
    	}
    	void bar()
    	{
    		message("foo bar");
    	}
    }
    
    extern void object::Test()
    {
    	Parent people[2];
    	people[0] = new Parent();
    	people[1] = new Child();
    	for (int i = 0; i < 2; ++i)
    	{
    		people[i].foo();
    	}
    	//people[1].bar(); // Error
    	Child child = people[1];
    	child.bar(); // OK
    }
fr: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void foo()
    	{
    		message("bar");
    	}
    	void bar()
    	{
    		message("foo bar");
    	}
    }
    
    extern void object::Test()
    {
    	Parent people[2];
    	people[0] = new Parent();
    	people[1] = new Child();
    	for (int i = 0; i < 2; ++i)
    	{
    		people[i].foo();
    	}
    	//people[1].bar(); // Erreur
    	Child child = people[1];
    	child.bar(); // OK
    }

note: type: \b; header
en: Multiple Inheritance
fr: Héritage multiple

note: type: Plain text
en: A child cannot have multiple parents, however, a parent can have many children.
fr: Un enfant ne peut pas avoir plusieurs parents, mais un parent peut avoir plusieurs enfants.

note: type: Plain text
en: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|new>new</a></code>, <code><a cbot|pointer>reference</a></code>, <code><a cbot|this>this</a></code>, <code><a cbot|super>super</a></code>
    <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
fr: <code><a cbot|class>class</a></code>, <code><a cbot|public>public</a></code>, <code><a cbot|private>private</a></code>, <code><a cbot|protected>protected</a></code>, <code><a cbot|new>new</a></code>, <code><a cbot|pointer>reference</a></code>, <code><a cbot|this>this</a></code>, <code><a cbot|super>super</a></code>
    <a cbot>Programmation</a>, <a cbot|type>types</a> et <a cbot|category>catégories</a>.

note: type: Plain text
en: This keyword is similar to <code><a cbot|this>this</a></code>, however, it grants access to methods from the parent class (see the <code><a cbot|extends>extends</a></code> keyword), which is especially useful for method overriding.
fr: Ce mot-clé est similaire à <code><a cbot|this>this</a></code>, mais il donne accès aux méthodes de la classe mère (voir le mot-clé <code><a cbot|extends>extends</a></code>), qui est particulièrement utile pour remplacer une méthode.

note: type: Source code
en: public class Parent
    {
    	protected int field;
    	
    	void Parent()
    	{
    		field = 0;
    	}
    	
    	void Print()
    	{
    		message("Parent's field: " + field);
    	}
    }
    
    public class Child extends Parent
    {
    	private int childsField;
    	
    	void Child()
    	{
    		super.Parent();
    		childsField = field + 1;
    	}
    	
    	void Print()
    	{
    		super.Print();
    		message("Child's field: " + childsField);
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.Print(); // Will show both 0 and 1
    }
fr: public class Mere
    {
    	protected int field;
    	
    	void Mere()
    	{
    		field = 0;
    	}
    	
    	void Print()
    	{
    		message("Champs mère: " + field);
    	}
    }
    
    public class Fille extends Mere
    {
    	private int childsField;
    	
    	void Fille()
    	{
    		super.Mere();
    		childsField = field + 1;
    	}
    	
    	void Print()
    	{
    		super.Print();
    		message("Champs fille : " + childsField);
    	}
    }
    
    extern void object::Test()
    {
    	Fille child();
    	child.Print(); // Affiche Champs mère : 0 puis Champs fille : 1
    }

note: type: Plain text
en: This keyword is used in a <code><a cbot|class>class</a></code> definition when we want the class to inherit members from another class. The class which is extended we usually call a parent or base, the extending class we call a child.
fr: Ce mot-clé est utilisé dans une définition de <code><a cbot|class>classe</a></code> quand on veut que la classe hérite des membres d'une autre classe. La classe qui est étendue appelée habituellement classe mère, un parent ou une base. Elle étend la classe que nous appelons un enfant ou classe fille.

note: type: Source code
en: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void bar()
    	{
    		message("bar");
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.foo(); // Will show "foo"
    	child.bar(); // Will show "bar"
    }
fr: public class Parent
    {
    	void foo()
    	{
    		message("foo");
    	}
    }
    
    public class Child extends Parent
    {
    	void bar()
    	{
    		message("bar");
    	}
    }
    
    extern void object::Test()
    {
    	Child child();
    	child.foo(); // Affiche "foo"
    	child.bar(); // Affiche "bar"
    }

note: type: Plain text
en: A parent's method can be called inside an overriden method by using the <code><a cbot|super>super</a></code> keyword.
fr: La méthode de la classe mère peut être appelée à l'intérieur d'une méthode surchargée en utilisant le mot-clé <code><a cbot|super>super</a></code>.

note: type: Plain text
en: As shown in the previous example, the class members can be initialized in the class definition (<c/>int x = 3.33;<n/>).
fr: Comme montré dans l'exemple précédent, les membres de la classe peuvent être initialisés dans la définition de classe (<c/>int x = 3.33;<n/>).

note: type: Plain text
en: <code>"r"</code> mode: open for reading.
    <code>"w"</code> mode: open for writing.
    <code>"a"</code> mode: open for appending.
fr: <code>"r"</code> mode lecture : fichier ouvert pour lecture. 
    <code>"w"</code> mode écriture: fichier ouvert à l'écriture.<code>"a"</code> mode mise à jour: fichier ouvert pour ajout/modification.

note: type: Plain text
en: <c/>openfile();<n/> opens an text file in the files/ folder. This is not a method of the <code><a cbot|file>file</a></code> class but openfile returns a <a cbot|pointer>reference</a> to a new instance of the file class. You must supply two parameters, the filename and the opening mode.
fr: <c/>openfile();<n/> ouvre un fichier texte dans le dossier 'files/'. Il ne s'agit pas d'une méthode de la classe <code><a cbot|file>file</a></code> mais openfile retourne une <a cbot|pointer>référence</a> sur une nouvelle instance de la classe file. Il faut préciser deux paramètres: le nom du fichier et le mode d'ouverture.

note: type: Plain text
en: <code>"r"</code> mode: open for reading.
    <code>"w"</code> mode: open for writing.
    <code>"w"</code> mode: open for appending.
fr: <code>"r"</code> mode lecture : fichier ouvert pour lecture. 
    <code>"w"</code> mode écriture: fichier ouvert à l'écriture.<code>"a"</code> mode mise à jour: fichier ouvert pour ajout/modification.

note: type: Plain text
en: Nothing but a name can be changed in the main function. The keyword <code><a cbot|extern>extern</a></code> distinguishes the main function from others.
fr: Rien d'autre qu'un nom ne peut être changé dans la fonction principale. Il faut qu'elle respecte le prototype fixé. 
    Le mot-clé <code><a cbot|extern>extern</a></code> distingue la fonction principale des autres.

note: type: \b; header
en: Public Functions
fr: Fonctions publiques

note: type: \b; header
en: Default Parameters
fr: Paramètres par défaut

note: type: Plain text
en: Last function parameters can have default values that can be omitted when calling.
fr: Les derniers paramètres des fonction peuvent avoir des valeurs par défaut qui peuvent être omises lors de l'appel.

note: type: Source code
en: float Add(float a = 0.0, float b = 0.0)
    {
    	return a + b;
    }
    
    // Somewhere in the main program...
    Add(); // Will return 0.0
    Add(2.0); // Will return 2.0
    Add(2.0, 3.0); // Will return 5.0
    // ...
fr: float Add(float a = 0.0, float b = 0.0)
    {
    	return a + b;
    }
    
    // Plus loin, dans le programme ou dans une autre fonction...
    val=Add(); // val vaut 0.0
    val=Add(2.0); // val vaut 2.0
    val=Add(2.0, 3.0); // val vaut 5.0
    // ...

note: type: \t; header
en: Default Parameters and Overloading
fr: Paramètres par défaut et surcharge

note: type: Plain text
en: Functions with default parameters still can be overloaded, one must only ensure that function calls are not ambiguous. For example, consider the following code:
fr: Les fonctions avec des paramètres par défaut peuvent encore être surchargées, il faut seulement s'assurer que les appels de fonction ne sont pas ambigus. Par exemple, considérez le code suivant :

note: type: Source code
en: float Add(float a = 0.0, float b = 0.0)
    {
    	return a + b;
    }
    
    string Add(string a = "", string b = "")
    {
    	return a + b;
    }
    
    // Somewhere in the main program...
    Add(); // Compilation error: ambiguous call
    Add(""); // Ok
    Add(0.0); // Ok
    // ...
fr: float Add(float a = 0.0, float b = 0.0)
    {
    	return a + b;
    }
    
    string Add(string a = "", string b = "")
    {
    	return a + b;
    }
    
    // plus loin dans une autre fonction...
    Add(); // Erreur de compilation : appel ambigu
    Add(""); // Ok
    Add(0.0); // Ok
    // ...

note: type: Plain text
en: Note that in the above example overloading causes the first default parameter to be useless as caller needs to pass it anyway in order to distinguish the two functions.
fr: Notez que dans l'exemple ci-dessus, la surcharge rend le premier paramètre par défaut inutile car l'appelant doit le passer de toute façon pour pouvoir distinguer les deux fonctions.

note: type: Plain text
en: <button 192/>   <code><a object|botbr>WheeledBuilder</a>         </code>Wheeled Builder
    <button 193/>   <code><a object|botbc>TrackedBuilder</a>         </code>Tracked Builder
    <button 194/>   <code><a object|botbj>WingedBuilder</a>          </code>Winged Builder
    <button 195/>   <code><a object|botbs>LeggedBuilder</a>          </code>Legged Builder
fr: <button 192/> <code><a object|botbr>WheeledBuilder</a> </code>Constructeur à roues
    <button 193/> <code><a object|botbc>TrackedBuilder</a> </code>Constructeur à chenilles
     <button 194/> <code><a object|botbj>WingedBuilder</a> </code>Constructeur volant
     <button 195/> <code><a object|botbs>LeggedBuilder</a> </code>Constructeur à pattes
