Funkcje konwersji:   IntegerToString()

Funkcja string IntegerToString() konwertuje wartość liczby całkowitej w tekst określonej długości. Więcej informacji można znaleźć w specyfikacji MQL4.

Przykład 1

#property strict
void OnStart()
  {
//--- przekonwertować liczbę całkowitą 77 w tekst
   long   value       = 77;   // liczba, która ma być przekształcona w tekst
   int    str_len     = 5;    // liczba, która określa długość tekstu. Wartość domyślna = 0
   ushort fill_symbol = '-';  // symbol wypełniacz. Wartość domyślna = spacja

   string result      = IntegerToString(value, str_len, fill_symbol); // result = ---77
   Print("1) result = ",result);

   Print("2) IntegerToString(77,10) = ",IntegerToString(77,10));
   Print("3) IntegerToString(77) = ",IntegerToString(77));
  }

Jeśli po przekształceniu liczby długość otrzymanego tekstu będzie większa niż długość określona przez drugi argument, to tekst z lewej strony zostanie uzupełniony symbolem wypełniaczem. W powyższym kodzie, liczba 77 (value = 77) ma być przekształcona w tekst o długości 5 symboli (str_len = 5). Ponieważ 77 ma tylko dwa symbole, z lewej strony zostaną dopisane 3 symbole wypełniacze - (fill_symbol = '-') (rys. 1 przykład 1).

Jeśli nic nie napisać na miejscu 3-go argumentu, funkcja wypełni tekst spacjami (rys. 1 przykład 2).

Jeśli po przekształceniu liczby długość otrzymanego tekstu będzie mniejsza niż długość określona przez drugi argument, to tekst nie obcina się. Jeśli nic nie napisać na miejscu drugiego argumentu, wartość którego domyślnie jest równa 0, to liczba 77 zostanie wyświetlona jak jest, ponieważ długość tekstu w 2 symboli jest większa niż 0 (rys. 1 przykład 3).

Rys. 1. Przykłady stosowania funkcji IntegerToString().