Returns the location to the nth word in str.

Contents

Interface Function Documentation Page Comments

Interface

#include <codecogs/strings/nth_word.h>

using namespace Strings;

	int	nth_word (const char *str, int n, int offset=-1) Returns the location to the nth word in str.
	Integer	cc_stringsNth_word (String str, Integer n, Integer offset) This function is available as a Microsoft Excel add-in.

Function Documentation

Returns the location of start to the (n+1)th word within a string. A word is defined by a continuous sequence of characters consisting of a-z and A-Z

Example:

#include <codecogs/strings/nth_word.h>
int main()
{
  const char str[] = "The quick brown fox jumps over the lazy dog";
  printf("\nThe start of the 5th word is at location: %d", Strings::nth_word(str, 4));
  printf("\nThe 2nd last word is at location: %d", Strings::nth_word(str,-2));
  printf("\nThe location of next word after the 12th letter is: %d", Strings::nth_word(str, 1, 12)); 
  return 0;
}

Output:

The 4th word is at location: 20
The 2nd last word is at location: 35
The location of next word after the 12th letter is: 16

Parameters:

str	the character string containing a collection of words. [const]
n	the word number you wish to find. The current word (or location) is n=0, so to find the start of the next word use n=1, etc. A negative value of n will word backwards to find previous words relative to offset. If offset is undefined, then a negative value of n will start from the end of the string.
offset	the location within the string to start from. By default this is the first character within the string when n>0 and the last character within the string when n<0.