Unit 'StrUtils' Package
[Overview][Resource strings][Constants][Types][Procedures and functions][Index] [#rtl]

ExtractSubstr

Extract a word from a string, starting at a given position in the string.

Declaration

Source position: strutils.pp line 224

function ExtractSubstr(

  const S: string;

  var Pos: Integer;

  const Delims: TSysCharSet

):string;

Arguments

S

  

String to search in.

Pos

  

Initial position to start extracting. On exit returns the position of the next word.

Delims

  

Characters to use as word delimiters.

Function result

The extracted word.

Description

ExtractSubStr returns all characters from S starting at position Pos till the first character in Delims, or till the end of S is reached. The delimiter character is not included in the result. Pos is then updated to point to the next first non-delimiter character in S. If Pos is larger than the Length of S, an empty string is returned.

The predefined constant StdWordDelims can be used for the Delims argument.

Errors

None.

See also

ExtractDelimited

  

Extract the N-th delimited part from a string.

ExtractWord

  

Extract the N-th word out of a string.

ExtractWordPos

  

Extract a word from a string, and return the position where it was located in the string.


Documentation generated on: Dec 24 2024