xHarbour Reference Documentation > Function Reference

AfterAtNum()

Extracts the remainder of a string after the last occurrence of a search string.

Syntax

AfterAtNum( <cSearch>   , ;
            <cString>   , ;
           [<nCount>]   , ;
           [<nSkipChars>] ) --> cResult

Arguments

<cSearch>

This is the character string to search for in <cString>.

<cString>

This is the character string to find <cSearch> in.

<nCount>

A numeric value indicating the number of occurrences of finding <cSearch> in <cString> before the function returns. It defaults to the last occurrence.

<nSkipChars>

This numeric parameter defaults to 0 so that the function begins searching with the first character of <cString>. Passing a value > 0 instructs the function to ignore the first <nSkipChars> characters in the search.

Return

The function returns the remainder of <cString> after the <nCount>th occurrence of <cSearch> in the string.

Description

AfterAtNum() begins searching <cSearch> in <cString> at the first plus <nSkipChars> characters. It terminates searching after <nCount> occurrences or after the last occurrence of <cSearch> and returns the remainder of <cString>. The function recognizes the CSetAtMuPa() and SetAlike() settings.

Info

See also:	AtNum(), AtRepl(), BeforAtNum(), NumAt(), CSetAtMuPa(), SetAtLike()
Category:	CT:String manipulation , Character functions
Source:	ct\atnum.c
LIB:	xhb.lib
DLL:	xhbdll.dll