ExtractWordPos

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

Declaration

Source position: strutils.pp line 204

  function ExtractWordPos(N: Integer; const S: string; 
                         const WordDelims: TSysCharSet; out Pos: Integer)
                          : string;

Description

ExtractWordPos extracts the N-th word from the string S and returns the position of this word in Pos. The set of characters in WordDelims are used to mark word boundaries. A word is defined as any non-empty sequence of characters which are not present in WordDelims : if a character is not in WordDelims , it is considered as part of a word. If an N -th word cannot be found, an empty string is returned and Pos is zero.

Unlike ExtractDelimited , an empty string is not a valid return value, i.e. is not a word. If an empty string is returned, the index N was out of range.

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

Errors

None.

See also

Name Description
ExtractSubStr Extract a word from a string, starting at a given position in the string.
ExtractWord Extract the N-th word out of a string.
IsWordPresent Check for the presence of a word in a string.
WordCount Count the number of words in a string.
WordPosition Search position of Nth word in a string.