---
title: "strLeft"
canonical: "https://help.vicon.com/space/ShogunPost121/1253737036/strLeft"
format: markdown
---
# Description

Extracts the first (left-most) "count" characters from "string". If "count" is greater than the length of string, the entire string is returned.

## Functional area

String

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `strLeft "string" count` |

### Arguments

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `string` | string | yes | String to extract sub-string from. |
| `count` | integer | yes | The number of characters to extract from string, counting from the left. |

### Flags

None

## Return value

string

Returns the sub-string from "string". 

> Macro (scroll-pagebreak)

## Examples

```plaintext
// Extract some substrings
string $str = "This is some text";
string $subStr;
 
// Extract the first 7 characters
$subStr = `strLeft $str 7`;
print $subStr; 
// Should be "This is"
 
// Extract the first 17 characters
$subStr = `strLeft $str 17`;
print $subStr; 
// Should be same as $str
```

# Additional information

## Related commands

- [strCompare](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736489)
- [strFind](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737935)
- [strLength](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253738093)
- [strMid](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737094)
- [strReplace](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736842)
- [strReverseFind](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253737016)
- [strRight](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736764)
- [strTok](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739563)
- [strTokArray](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253739862)