IntegerToString

Esta função converte um valor de tipo inteiro em uma string de comprimento especificado e retorna a string obtida.

string  IntegerToString(
   long    number,              // número
   int     str_len=0,           // comprimento da string resultado
   ushort  fill_symbol=' '      // símbolo de preenchimento
   );

Parâmetros

number

[in]  Número para conversão.

str_len=0

[in]  Comprimento da string. Se o comprimento da string resultante for maior que aquele especificado, a string não é truncada. Se ela for menor, os símbolos de preenchimento (filler) serão adicionados a esquerda.

fill_symbol=' '

[in]  Símbolo de preenchimento. Por padrão, ele é um espaço.

Valor do Retorno

String.

 

Exemplo:

#define DATA_TOTAL 1001
 
//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
  {
//--- em um ciclo percorrendo DATA_TOTAL, exibimos as strings com índice divisível por 100
//--- na string é exibido o valor do índice no formato de quatro caracteres
//--- caso o comprimento da string seja menor que 4 caracteres, o valor do índice do ciclo
//--- na string é precedido por zeros à esquerda
   for(int i=0; i<DATA_TOTAL; i++)
     {
      if(i%100==0)
         Print("Converted index value: ",IntegerToString(i,4,'0'));
     }
   /*
  resultado:
   Converted index value: 0000
   Converted index value: 0100
   Converted index value: 0200
   Converted index value: 0300
   Converted index value: 0400
   Converted index value: 0500
   Converted index value: 0600
   Converted index value: 0700
   Converted index value: 0800
   Converted index value: 0900
   Converted index value: 1000
   */
  }

Também Veja

StringToInteger