X# Runtime and VO SDK Reference
X# Runtime and VO SDK Reference
XSharp.Core Namespace
Functions, Globals and Defines
List of Functions
_C2Hex Function
_DebOut32 Function
_GetCmdLine Function
_GetCmdShow Function
_GetInst Function
_GetPrevInst Function
_Like Function
_Quit Function
_SplitPath Function
_Val Function
AbsInt Function
AbsLong Function
AbsReal4 Function
AbsReal8 Function
AbsShort Function
AdjustFName Function
AdjustFNameA Function
AllTrim Function
AltD Function
AmPm Function
Ansi2Oem Function
Ansi2OemA Function
Ansi2OemBuff Function
Asc Function
AscW Function
At Function
At2 Function
At3 Function
AtC Function
AtC2 Function
ATCLine Function
ATCLine2 Function
ATLine Function
ATLine2 Function
B64EncFile Function
B64EncString Function
Bin2DW Function
Bin2I Function
Bin2L Function
Bin2Logic Function
Bin2Ptr Function
Bin2Real4 Function
Bin2Real8 Function
Bin2W Function
Buffer Function
C2Hex Function
CharEven Function
CharMix Function
CharOdd Function
CharPos Function
Chr Function
ChrW Function
ConDateTime Function
ConTime Function
CToDt Function
CToDtAnsi Function
CTOL Function
CurDir Function
CurDrive Function
DateTime Function
Days Function
DbRegisterClient Function
DbUnRegisterClient Function
DebOut32 Function
DecodeBase64 Function
DirChange Function
DirMake Function
DirRemove Function
DiskChange Function
DiskFree Function
DiskName Function
DiskSpace Function
DosError Function
DosErrString Function
DtToC Function
DtToS Function
DW2Bin Function
ElapTime Function
EncodeBase64 Function
ErrorBuild Function
ErrorLevel Function
ErrorStack Function
ErrString Function
ExecName Function
FAttr2String Function
FAttrib Function
FChSize Function
FClose Function
FCommit Function
FConvertToFileStream Function
FConvertToMemoryStream Function
FCopy Function
FCreate Function
FCreate2 Function
FDate Function
FEof Function
FErase Function
FError Function
FException Function
FFCount Function
FFirst Function
FFLock Function
FFLock64 Function
FFlush Function
FFUnLock Function
FFUnLock64 Function
FGetBuffer Function
FGetS Function
FGetS2 Function
FGetStream Function
File Function
FName Function
FNext Function
FOpen Function
FOpen2 Function
FPathName Function
FPutS Function
FPutS3 Function
FRead Function
FRead3 Function
FRead4 Function
FReadLine Function
FReadLine2 Function
FReadStr Function
FReadText Function
FReadText3 Function
FRename Function
FRewind Function
FSeek3 Function
FSize Function
FTell Function
FTell64 Function
FTime Function
FWrite Function
FWrite3 Function
FWrite4 Function
FWriteLine Function
FWriteLine3 Function
FWriteText3 Function
GetAMExt Function
GetAmPm Function
GetAnsi Function
GetChunkBase64 Function
GetCurPath Function
GetCursorProperty Function
GetDateFormat Function
GetDefault Function
GetDefaultDir Function
GetDosError Function
GetEnv Function
GetFAttr Function
GetFMask Function
GetMacroCompiler Function
GetMimType Function
GetNatDLL Function
GetPartialEnumName Function
GetPMExt Function
GetSQLProperty Function
GetTimeSep Function
GetTimeZoneDiff Function
GetYield Function
HardCR Function
Hex2C Function
HiByte Function
HiWord Function
I2Bin Function
Instr Function
IsAlNum Function
IsAlpha Function
IsAlphaNum Function
IsBDigit Function
IsDigit Function
IsLower Function
IsRunningOnWindows Function
IsSpace Function
IsUpper Function
IsXDigit Function
L2Bin Function
Left Function
Like Function
LoByte Function
LockTries Function
Logic2Bin Function
Lower Function
LowerA Function
LoWord Function
LTOC Function
LTrim Function
MakeDWord Function
MakeLong Function
MakeShort Function
MakeWord Function
MemLines Function
MemoLine Function
MemoRead Function
MemoReadBinary Function
MemoWrit Function
MemoWritBinary Function
MLCount1 Function
MLcToPos Function
MLine Function
MLine3 Function
MLPos2 Function
Mod Function
ModuleName Function
NetErr Function
NetName Function
NToCDoW Function
NToCMonth Function
Occurs Function
Occurs2 Function
Occurs3 Function
Oem2Ansi Function
Oem2AnsiA Function
Oem2AnsiBuff Function
OS Function
ProcFile Function
ProcLine Function
ProcName Function
Proper Function
ProperA Function
Ptr2Bin Function
QPEncString Function
RAt Function
RAt2 Function
RAt3 Function
RAtLine Function
RATLine2 Function
ReadOsVersionFromRegistry Function
Real42Bin Function
Real82Bin Function
RegisterFileSearch Function
Repl Function
Replicate Function
RGB Function
Right Function
RTrim Function
SClone Function
Seconds Function
Secs Function
SetAMExt Function
SetAmPm Function
SetAnsi Function
SetBeep Function
SetCentury Function
SetCollation Function
SetCompatible Function
SetCpu Function
SetDateCountry Function
SetDateFormat Function
SetDecimal Function
SetDecimalSep Function
SetDefault Function
SetDefaultDir Function
SetDeleted Function
SetDigit Function
SetDigitFixed Function
SetEnv Function
SetEpoch Function
SetErrorLog Function
SetErrorStackVOFormat Function
SetExact Function
SetExclusive Function
SetFieldStore Function
SetFixed Function
SetInternational Function
SetMacroCompiler Function
SetMacroDuplicatesResolver Function
SetMath Function
SetNatDLL Function
SetPath Function
SetPathArray Function
SetPMExt Function
SetSafety Function
SetScience Function
SetSoftSeek Function
SetSpace Function
SetThousandSep Function
SetTimeFormat Function
SetTimeSep Function
SetUnique Function
SetYield Function
SLen Function
SoundEx Function
Space Function
SToDt Function
String2FAttr Function
Stuff Function
SubStr2 Function
SubStr3 Function
SwapByte Function
SwapDWord Function
SwapInt Function
SwapInt64 Function
SwapLong Function
SwapQWord Function
SwapShort Function
SwapWord Function
Time Function
Time24 Function
Trim Function
TruePath Function
TString Function
TypeString Function
Upper Function
UpperA Function
UseBufferedFileStream Function
UUDecodeLine Function
UUEncFile Function
UUEncLine Function
W2Bin Function
WorkDir Function
Click or drag to resize

Left Function

Extract a substring beginning with the first character in a string.

Namespace:  XSharp.Core
Assembly:  XSharp.Core (in XSharp.Core.dll) Version: 2.7
Syntax
Copy
 FUNCTION Left(
	cString AS STRING,
	dwCount AS DWORD
) AS STRING
Request Example View Source

Parameters

cString
Type: String
The string from which to extract characters.
dwCount
Type: UInt32
The number of characters to extract.

Return Value

Type: String
The leftmost <dwCount> characters of <cString>.
If <dwCount> is negative or 0, Left() returns a NULL_STRING.
If <dwCount> is larger than the length of the string, Left() returns the entire string.
Remarks
Left() is the same as Substr(<cString>, 1, <wCount>). Left(), Right(), and Substr() are often used with both the At() and RAt() functions to locate the first and/or the last position of a substring before extracting it.
Examples
This example extracts the first three characters from the left of the target string:
X#
Copy
1? LEFT("ABCDEF", 3)                    // ABC
This example extracts a substring from the beginning of a string up to the first occurrence of a comma:
X#
Copy
1LOCAL cName := "James, William" AS STRING
2? LEFT(cName, AT(",", cName))        // James
See Also