ligo/gitlab-pages/docs/language-basics/strings.md
Sander 8f60accc24 - Improve darkmode support
- Reenable code block tabs
- Reeneble code blocks highlighting
2020-03-04 13:19:00 +00:00

142 lines
2.3 KiB
Markdown

---
id: strings
title: Strings
---
import Syntax from '@theme/Syntax';
Strings are defined using the built-in `string` type like this:
<Syntax syntax="pascaligo">
```
const a : string = "Hello Alice"
```
</Syntax>
<Syntax syntax="cameligo">
```
let a : string = "Hello Alice"
```
</Syntax>
<Syntax syntax="reasonligo">
```reasonligo
let a : string = "Hello Alice";
```
</Syntax>
## Concatenating Strings
<Syntax syntax="pascaligo">
Strings can be concatenated using the `^` operator.
```pascaligo group=a
const name : string = "Alice"
const greeting : string = "Hello"
const full_greeting : string = greeting ^ " " ^ name
```
</Syntax>
<Syntax syntax="cameligo">
Strings can be concatenated using the `^` operator.
```cameligo group=a
let name : string = "Alice"
let greeting : string = "Hello"
let full_greeting : string = greeting ^ " " ^ name
```
</Syntax>
<Syntax syntax="reasonligo">
Strings can be concatenated using the `++` operator.
```reasonligo group=a
let name : string = "Alice";
let greeting : string = "Hello";
let full_greeting : string = greeting ++ " " ++ name;
```
</Syntax>
## Slicing Strings
Strings can be sliced using a built-in function:
<Syntax syntax="pascaligo">
```pascaligo group=b
const name : string = "Alice"
const slice : string = String.slice (0n, 1n, name)
```
> Note that `string_slide` is *deprecated*.
</Syntax>
<Syntax syntax="cameligo">
```cameligo group=b
let name : string = "Alice"
let slice : string = String.slice 0n 1n name
```
</Syntax>
<Syntax syntax="reasonligo">
```reasonligo group=b
let name : string = "Alice";
let slice : string = String.slice (0n, 1n, name);
```
</Syntax>
> ⚠️ Notice that the offset and length of the slice are natural
> numbers.
## Length of Strings
The length of a string can be found using a built-in function:
<Syntax syntax="pascaligo">
```pascaligo group=c
const name : string = "Alice"
const length : nat = String.length (name) // length = 5
```
> Note that `size` is *deprecated*.
</Syntax>
<Syntax syntax="cameligo">
```cameligo group=c
let name : string = "Alice"
let length : nat = String.size name // length = 5
```
</Syntax>
<Syntax syntax="reasonligo">
```reasonligo group=c
let name : string = "Alice";
let length : nat = String.size (name); // length == 5
```
</Syntax>