Harbour All Functions – R

RangeRem

RangeRepl

RAt

Rate

RD / RMDIR / DirRemove

ReadKey

ReadVar()

RecCount

RecNo
RecSize

RemAll

RemLeft
RemRight
ReplAll
Replicate

ReplLeft

ReplRight

RestToken
Right

RLock

Round

Row

RToD

RTrim

String Functions

AddASCII

AfterAtNum

AllTrim
Asc

ASCIISum

ASCPos
At

AtAdjust

AtNum
AtRepl
AtToken

BeforAtNum

Chr

CharAdd
CharAnd
CharEven
CharHist
CharList
CharMirr
CharMix
CharNoList
CharNot
CharOdd
CharOne
CharOnly
CharOr
CharPix
CharRela
CharRelRep
CharRem
CharRepl
CharRLL
CharRLR
CharSHL
CharSHR
CharSList
CharSort
CharSub
CharSwap
CharWin
CharXOR

CountLeft
CountRight
Descend
Empty
hb_At
hb_RAt
hb_ValToStr
IsAlpha
IsDigit
IsLower
IsUpper

JustLeft
JustRight

Left
Len
Lower
LTrim

NumAt
NumToken
PadLeft
PadRight

PadC
PadL
PadR

POSALPHA
POSCHAR
POSDEL
POSDIFF
POSEQUAL
POSINS
POSLOWER
POSRANGE
POSREPL
POSUPPER

RangeRem
RangeRepl

RAt

RemAll

RemLeft
RemRight
ReplAll

Replicate

ReplLeft

ReplRight

RestToken

Right
RTrim

SaveToken

SetAtLike
Space
Str

StrDiff

StrFormat

StrSwap

StrTran
StrZero
SubStr

TabExpand
TabPack

Token

TokenAt
TokenEnd
TokenExit
TokenInit
TokenLower
TokenNext
TokenNum
TokenSep
TokenUpper

Transform
Trim
Upper
Val

ValPos
WordOne
WordOnly
WordRem
WordRepl
WordSwap

WordToChar


Right()

RIGHT()

Extract the rightmost substring of a character expression

Syntax

      RIGHT( <cString>, <nLen> ) --> cReturn

Arguments

<cString> Character expression to be parsed

<nLen> Number of bytes to return beginning at the rightmost position

Returns

<cReturn> Substring of evaluation

Description

This functions returns the rightmost <nLen> characters of <cString>. It is equivalent to the following expressions:

SUBSTR( <cString>, – <nLen> )

SUBSTR( <cString>, LEN( <cString> ) – <nLen> + 1, <nLen> )

Examples

      ? RIGHT( "HELLO HARBOUR", 5 )     // RBOUR

Compliance

Clipper

Platforms

All

Files

Library is rtl

Seealso

SUBSTR(), LEFT(), AT(), RAT()

Left()

LEFT()

Extract the leftmost substring of a character expression

Syntax

      LEFT( <cString>, <nLen> ) --> cReturn

Arguments

<cString> Main character to be parsed

<nLen> Number of bytes to return beginning at the leftmost position

Returns

<cReturn> Substring of evaluation

Description

This functions returns the leftmost <nLen> characters of <cString>. It is equivalent to the following expression:

SUBSTR( <cString>, 1, <nLen> )

Examples

      ? LEFT( "HELLO HARBOUR", 5 )    // HELLO

Compliance

Clipper

Platforms

All

Files

Library is rtl

Seealso

SUBSTR(), RIGHT(), AT(), RAT()

hb_RAt()

hb_RAt()

Searches for last occurrence a substring of a string.

Syntax

      hb_RAt( <cSearch>,  <cString>,  [<nStart>],  [<nEnd>]  ) --> nPos

Arguments

<cSearch> Substring to search for

<cString> Main string

<nStart> First position to search in cString, by default 1.

<nEnd> End position to search, by default cString length

Returns

hb_RAt() return the location of beginning position of last occurrence a substring of a string.

Description

This function searches for last occurrence a <cSearch> in <cString>. If the function is unable to find any occurrence of <cSearch> in <cString>, the return value is 0. 3rd and 4th parameters define inclusive range for 2nd parameter on which operation is performed. If 3rd and 4th parameters is not specified, then hb_RAt() is equal to RAt().

Examples

      LOCAL cString
      LOCAL cSearch
      LOCAL i,  y,  r,  nLen

      ? 'hb_RAt( "cde",  "abcdefgfedcba" ) = ',  ;
         hb_RAt( "cde",  "abcdefgfedcba" ) // -> 3

      cString := "acdefcdeedcb"
      cSearch := "cde"
      nLen := Len( cString )
      FOR y := 1 TO nLen
         FOR i := 1 TO nLen
            r := hb_RAt( cSearch,  cString,  y,  i )
            IF r != 0
            ? 'hb_RAt( "' + cSearch + '",  "' + cString + '",  ' + hb_ntos( y ) + ',  ' + hb_ntos( i ) + ' ) = ' + ;
               hb_ntos( r )
            ENDIF
         NEXT
      NEXT

Compliance

Clipper

Platforms

All(64K)

Files

Library is core

Seealso

hb_At(), SubStr(), Right(), RAt()

hb_At()

hb_At()

Locates the position of a substring in a main string.

Syntax

      hb_At( <cSearch>,  <cString>,  [<nStart>],  [<nEnd>] ) --> nPos

Arguments

<cSearch> Substring to search for

<cString> Main string

<nStart> First position to search in cString, by default 1

<nEnd> End position to search, by default cString length

Returns

hb_At() return the starting position of the first occurrence of the substring in the main string

Description

This function searches the string <cString> for the characters in the first string <cSearch>. If the substring is not contained within the second expression, the function will return 0. The third and fourth parameters lets you indicate a starting and end offset to search in.

Examples

      ? 'hb_At( "cde",  "abcdefgfedcba" ) = ' + ;
         Str( hb_At( "cde",  "abcdefgfedcba" ) )       // 3
      ? 'hb_At( "cde",  "abcdefgfedcba" ) = ' + ;
         Str( hb_At( "cde",  "abcdefgfedcba",  4 ) )    // 0

Compliance

This function is sensitive to HB_CLP_STRICT settings during build.

<nStart> and <nEnd> are Harbour extensions and do not exist if HB_CLP_STRICT is defined. In that case, the whole string is searched.

Platforms

All

Files

Library is core

Seealso

hb_RAt()

At()

 

AT()

Locates the position of a substring in a main string.

Syntax

      AT( <cSearch>, <cString>, [<nStart>], [<nEnd>] ) --> nPos

Arguments

<cSearch> Substring to search for

<cString> Main string

<nStart> First position to search in cString, by default 1

<nEnd> End position to search, by default cString length

Returns

AT() return the starting position of the first occurrence of the substring in the main string

Description

This function searches the string <cString> for the characters in the first string <cSearch>. If the substring is not contained within the second expression, the function will return 0. The third and fourth parameters lets you indicate a starting and end offset to search in.

Examples

      ? 'At( "cde", "abcdefgfedcba" ) = ' +;
         At( "cde", "abcsefgfedcba" )

Compliance

This function is sensitive to HB_CLP_STRICT settings during the compilation of src/rtl/at.c

<nStart> and <nEnd> are Harbour extensions and do not exist if HB_CLP_STRICT is defined. In that case, the whole string is searched.

Platforms

All

Files

Library is rtl

Seealso

RAT()