colobot-data 0.1.7 - en to pt_PT translation catalogue (25 entries)

note: type: Title-text
en: A function
pt_PT: Uma função

note: type: Resume-text
en: Create a function in order to make your program shorter.
pt_PT: Crie uma função para tornar seu programa mais curto.

note: type: ScriptName-text
en: Move
pt_PT: Mover

note: type: \b; header
en: Exercise
pt_PT: Exercício

note: type: Plain text
en: The <a object|bottr>bot</a> must pass over all the <a object|waypoint>blue crosses</a> on the ground. The way that must be covered is made of two squares. The first one measures 15 meters, the second 25 meters.
pt_PT: O <a object|bottr>robô</a> deve passar por todas as <a object|waypoint>cruzes azuis</a> no solo. O caminho que deve ser coberto é feito de dois quadrados. O primeiro mede 15 metros, o segundo 25 metros.

note: type: \b; header
en: General principle
pt_PT: Princípio geral

note: type: Plain text
en: In order to solve this problem, the most efficient solution consists in creating a <a cbot|function>function</a> that instructs the bot to move on a square shape of a certain size. The main program becomes then very simple:<c/>
pt_PT: Para resolver esse problema, a solução mais eficiente consiste em criar uma <a cbot|function>função</a> que instrui o robô a se mover em uma forma quadrada de um determinado tamanho. O programa principal torna-se então muito simples: <c/>

note: type: Source code
en: extern void object::Function1( )
    {
    	Square(15);
    	Square(25);
    }
pt_PT: extern void object::Funcao1( )
    {
    	Quadrado(15);
    	Quadrado(25);
    }

note: type: Plain text
en: You still have to define the function called <code>Square</code>. In order to do this, you will have to write some instructions outside the <a cbot|bloc>block</a> that until now was the frame of each one of your programs. At the very end of the program, after the last closing brace, we will define the function <code>Square</code>. The program will take the following shape:
pt_PT: Você ainda precisa definir a função chamada <code>Quadrado</code>. Para fazer isso, você terá que escrever algumas instruções fora do <a cbot|bloc>bloco</a> que até agora era o quadro de cada um dos seus programas. No final do programa, após a última chave de fechamento, definiremos a função <code>Quadrado</code>. O programa terá a seguinte forma:

note: type: Source code
en: extern void object::Function1( )
    {
    	<n/>main function ...<code>
    }
    
    void object::Square(float length)
    {
    	</code>new function ...<c/>
    }
pt_PT: extern void object::Funcao1( )
    {
    	<n/>função principal...<code>
    }
    
    void object::Quadrado(float comprimento)
    {
    	</code>nova função...<c/>
    }

note: type: Plain text
en: Let us look in detail at the different elements of the declaration of the function <code>Square</code>:
pt_PT: Vamos olhar detalhadamente os diferentes elementos da declaração da função <code>Quadrado</code>:

note: type: Plain text
en: <code><a cbot|void>void</a></code>
    This means that this function will return no value.
pt_PT: <code><a cbot|void>void</a></code>
    Isso significa que essa função não retornará nenhum valor.

note: type: Plain text
en: <code><a cbot|object>object</a>::</code>
    When you write this in front of the function name, you can have access in the function to all the characteristics of the bot, such as <code>position</code>, <code>orientation</code>, etc. In this exercise, this element is not compulsory, as we will not need the characteristics of the bot in the function.
pt_PT: <code><a cbot|object>object</a>::</code>
    Quando você escreve isso na frente do nome da função, você pode ter acesso na função a todas as características do robô, como <code>position</code>, <code>orientation</code>, etc. Neste exercício, este elemento não é obrigatório, pois não precisaremos das características do robô na função.

note: type: Plain text
en: <code>Square (  )</code>
    This is the name of the function. You can call it Square, or any other name.
pt_PT: <code>Quadrado (  )</code>
    Este é o nome da função. Você pode chamá-lo de Quadrado ou qualquer outro nome.

note: type: Plain text
en: <code><a cbot|float>float</a> length</code>
    Here you define the parameters that the function will get when it is called. The first time the function is actually called with <code>Square(15)</code>, the variable <code>length</code> will contain the value <code>15</code>. The second time, <code>length</code> will contain <code>25</code>.
pt_PT: <code><a cbot|float>float</a> comprimento</code>
    Aqui você define os parâmetros que a função receberá quando for chamada.  A primeira vez que a função é chamada com <code>Quadrado(15)</code>,  a variável <code>comprimento</code> conterá o valor <code>15</code>. A  segunda vez, <code>comprimento</code> conterá <code>25</code>.

note: type: Plain text
en: Here is in detail what will happen when the program is executed:
pt_PT: Aqui está em detalhes o que acontecerá quando o programa for executado:

note: type: Bullet: '-'
en: First the main function <code>Function</code> will be executed.
pt_PT: Primeiro a função principal <code>Funcao1</code> será executada.

note: type: Bullet: '-'
en: At the line <code>Square(15)</code>, the program will follow the red arrow and enter the function <code>Square</code> a first time, <code>length</code> containing <code>15</code>.
pt_PT: Na linha <code>Quadrado(15)</code>, o programa seguirá a seta vermelha e entrará na função <code>Quadrado</code> pela primeira vez, <code>comprimento</code> contendo <code>15</code>.

note: type: Bullet: '-'
en: At the end of the function <code>Square</code>, the program follows the orange arrow and comes back to the main function.
pt_PT: No final da função <code>Quadrado</code>, o programa segue a seta laranja e volta para a função principal.

note: type: Bullet: '-'
en: At the line <code>Square(25)</code>, the program will follow the blue arrow and enter the function <code>Square</code> a second time.
pt_PT: Na linha <code>Quadrado(25)</code>, o programa seguirá a seta azul e entrará na função <code>Quadrado</code> uma segunda vez.

note: type: Bullet: '-'
en: At the end of the function <code>Square</code>, the program follows the light blue arrow and comes back to the main function.
pt_PT: No final da função <code>Quadrado</code>, o programa segue a seta azul clara e volta para a função principal.

note: type: Plain text
en: In the function <code>Square</code>, use the instructions <code><a cbot|move>move</a></code> and <code><a cbot|turn>turn</a></code>. In order to make it shorter, you can use a <code><a cbot|for>for</a></code> loop, that will repeat the instructions <code><a cbot|move>move</a></code> and <code><a cbot|turn>turn</a></code> 4 times; however, this is not compulsory.
pt_PT: Na função <code>Quadrado</code>, use as instruções <code><a cbot|move>move</a></code> e <code><a cbot|turn>turn</a></code>. Para torná-lo mais curto, você pode usar um laço <code><a cbot|for>for</a></code>, que irá repetir as instruções <code><a cbot|move>move</a></code> e <code><a cbot|turn>turn</a></code> 4 vezes; no entanto, isso não é obrigatório.

note: type: Source code
en: void object::Square(float length)
    {
    	for ( int i=0 ; i<4 ; i=i+1 )
    	{
    		move(length);
    		turn(90);
    	}
    }
pt_PT: void object::Quadrado(float comprimento)
    {
    	for ( int i=0 ; i<4 ; i=i+1 )
    	{
    		move(comprimento);
    		turn(90);
    	}
    }

note: type: \t; header
en: See also
pt_PT: Veja também

note: type: Plain text
en: <a cbot>Programming</a>, <a cbot|type>types</a> and <a cbot|category>categories</a>.
pt_PT: <a cbot>Programação</a>, <a cbot|type>tipos</a> e <a cbot|category>categorias</a>.
