[Overview][Constants][Types][Classes][Procedures and functions][Variables][Index] Reference for unit 'System' (#rtl)

Length

Returns length of a string or array.

Declaration

Source position: system.fpd line 80

function Length(

  S: AStringType

):SizeInt;

function Length(

  A: DynArrayType

):SizeInt;

Description

Length returns the length of the string or array S, which is limited to 255 for shortstrings. If the string S is empty, 0 is returned.

Note: The length of the string S is stored in S[0] for shortstrings only. The Length function should always be used on ansistrings and widestrings.

For dynamical or statical arrays, the function returns the number of elements in the array.

Length also supports arguments of type PCharand PWideChar, in which case it is identical to the StrLen and WStrLen functions, respectively. In this case, the function actually calculates the length of the null-terminated string, and its execution time is proportional to the string length because the terminating null character is searched through a linear scan.

Errors

None.

See also

Pos

  

Search for substring in a string.

SetLength

  

Set length of a string.

Example

Program Example36;

{ Program to demonstrate the Length function. }

type
  somebytes = array [6..10] of byte;
  somewords = array [3..10] of word;
    
    
Var 
  S : String;
  I : Integer;
  bytes : somebytes;
  words : somewords;
  
begin
  S:='';
  for i:=1 to 10 do
    begin
    S:=S+'*';
    Writeln (Length(S):2,' : ',s);
    end;
  Writeln('Bytes : ',length(bytes));
  Writeln('Words : ',length(words));
end.

Documentation generated on: Sep 28 2017