Skip to content

Commit b02bb77

Browse files
authored
chore: release v3.2.1 (#1074)
1 parent ac40bc3 commit b02bb77

File tree

5 files changed

+195
-189
lines changed

5 files changed

+195
-189
lines changed

content/docs/en/resources/clarity/reference/functions.mdx

Lines changed: 40 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -586,14 +586,14 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
586586
(ok name)))
587587
```
588588

589-
### element-at [#element-at]
589+
### element-at? [#element-at?]
590590

591-
`element-at` retrieves an element at a specific index.
591+
`element-at?` retrieves an element at a specific index.
592592

593593
**Signature**
594594

595595
```clarity
596-
(element-at sequence index)
596+
(element-at? sequence index)
597597
```
598598

599599
**Parameters**
@@ -604,23 +604,23 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
604604
| `index` | `uint` | Zero-based index |
605605

606606
```clarity
607-
(element-at "Hello" u1) ;; Returns (some "e")
608-
(element-at (list 10 20 30) u2) ;; Returns (some 30)
609-
(element-at (list 1 2) u5) ;; Returns none
607+
(element-at? "Hello" u1) ;; Returns (some "e")
608+
(element-at? (list 10 20 30) u2) ;; Returns (some 30)
609+
(element-at? (list 1 2) u5) ;; Returns none
610610
611611
;; Get from list safely
612612
(define-read-only (get-member-at (index uint))
613-
(element-at (var-get members) index))
613+
(element-at? (var-get members) index))
614614
```
615615

616-
### index-of [#index-of]
616+
### index-of? [#index-of]
617617

618-
`index-of` finds the first occurrence of an element in a sequence.
618+
`index-of?` finds the first occurrence of an element in a sequence.
619619

620620
**Signature**
621621

622622
```clarity
623-
(index-of sequence element)
623+
(index-of? sequence element)
624624
```
625625

626626
**Parameters**
@@ -631,23 +631,23 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
631631
| `element` | any | Element to find |
632632

633633
```clarity
634-
(index-of "Hello" "l") ;; Returns (some u2)
635-
(index-of (list 1 2 3 2) 2) ;; Returns (some u1)
636-
(index-of (list 1 2 3) 5) ;; Returns none
634+
(index-of? "Hello" "l") ;; Returns (some u2)
635+
(index-of? (list 1 2 3 2) 2) ;; Returns (some u1)
636+
(index-of? (list 1 2 3) 5) ;; Returns none
637637
638638
;; Check membership
639639
(define-read-only (is-member (user principal))
640-
(is-some (index-of (var-get members) user)))
640+
(is-some (index-of? (var-get members) user)))
641641
```
642642

643-
### slice [#slice]
643+
### slice? [#slice]
644644

645-
`slice` extracts a subsequence from a sequence.
645+
`slice?` extracts a subsequence from a sequence.
646646

647647
**Signature**
648648

649649
```clarity
650-
(slice sequence left-position right-position)
650+
(slice? sequence left-position right-position)
651651
```
652652

653653
**Parameters**
@@ -659,22 +659,22 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
659659
| `right-position` | `uint` | Ending index (exclusive) |
660660

661661
```clarity
662-
(slice "Hello World" u0 u5) ;; Returns (some "Hello")
663-
(slice (list 1 2 3 4 5) u1 u4) ;; Returns (some (2 3 4))
662+
(slice? "Hello World" u0 u5) ;; Returns (some "Hello")
663+
(slice? (list 1 2 3 4 5) u1 u4) ;; Returns (some (2 3 4))
664664
665665
;; Extract substring
666666
(define-read-only (get-prefix (text (string-ascii 100)) (length uint))
667-
(slice text u0 length))
667+
(slice? text u0 length))
668668
```
669669

670-
### replace-at [#replace-at]
670+
### replace-at? [#replace-at]
671671

672-
`replace-at` replaces an element at a specific index.
672+
`replace-at?` replaces an element at a specific index.
673673

674674
**Signature**
675675

676676
```clarity
677-
(replace-at sequence index new-element)
677+
(replace-at? sequence index new-element)
678678
```
679679

680680
**Parameters**
@@ -686,12 +686,12 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
686686
| `new-element` | any | New element |
687687

688688
```clarity
689-
(replace-at "Hello" u1 "a") ;; Returns (some "Hallo")
690-
(replace-at (list 1 2 3) u1 5) ;; Returns (some (1 5 3))
689+
(replace-at? "Hello" u1 "a") ;; Returns (some "Hallo")
690+
(replace-at? (list 1 2 3) u1 5) ;; Returns (some (1 5 3))
691691
692692
;; Update list element
693693
(define-public (update-member (index uint) (new-member principal))
694-
(match (replace-at (var-get members) index new-member)
694+
(match (replace-at? (var-get members) index new-member)
695695
new-list (begin
696696
(var-set members new-list)
697697
(ok true))
@@ -749,14 +749,14 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
749749
(concat u"Label #" (int-to-utf8 num)))
750750
```
751751

752-
### string-to-int [#string-to-int]
752+
### string-to-int? [#string-to-int]
753753

754-
`string-to-int` converts a string to an optional integer.
754+
`string-to-int?` converts a string to an optional integer.
755755

756756
**Signature**
757757

758758
```clarity
759-
(string-to-int string)
759+
(string-to-int? string)
760760
```
761761

762762
**Parameters**
@@ -766,25 +766,25 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
766766
| `string` | `string-ascii` or `string-utf8` | String to convert |
767767

768768
```clarity
769-
(string-to-int "123") ;; Returns (some 123)
770-
(string-to-int "-456") ;; Returns (some -456)
771-
(string-to-int "abc") ;; Returns none
769+
(string-to-int? "123") ;; Returns (some 123)
770+
(string-to-int? "-456") ;; Returns (some -456)
771+
(string-to-int? "abc") ;; Returns none
772772
773773
;; Parse user input
774774
(define-public (set-value (input (string-ascii 10)))
775-
(match (string-to-int input)
775+
(match (string-to-int? input)
776776
value (ok (var-set stored-value value))
777777
(err u1)))
778778
```
779779

780-
### string-to-uint [#string-to-uint]
780+
### string-to-uint? [#string-to-uint]
781781

782-
`string-to-uint` converts a string to an optional unsigned integer.
782+
`string-to-uint?` converts a string to an optional unsigned integer.
783783

784784
**Signature**
785785

786786
```clarity
787-
(string-to-uint string)
787+
(string-to-uint? string)
788788
```
789789

790790
**Parameters**
@@ -794,13 +794,13 @@ Clarity provides a comprehensive set of built-in functions for smart contract de
794794
| `string` | `string-ascii` or `string-utf8` | String to convert |
795795

796796
```clarity
797-
(string-to-uint "123") ;; Returns (some u123)
798-
(string-to-uint "0") ;; Returns (some u0)
799-
(string-to-uint "-123") ;; Returns none
797+
(string-to-uint? "123") ;; Returns (some u123)
798+
(string-to-uint? "0") ;; Returns (some u0)
799+
(string-to-uint? "-123") ;; Returns none
800800
801801
;; Parse amount
802802
(define-read-only (parse-amount (input (string-ascii 20)))
803-
(string-to-uint input))
803+
(string-to-uint? input))
804804
```
805805

806806
### buff-to-int-be [#buff-to-int-be]

content/docs/en/tools/clarinet/index.mdx

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -24,16 +24,19 @@ To explore Clarinet features with AI, copy and paste [llms.txt](/tools/clarinet/
2424
## Installation
2525

2626
<TerminalPicker storage="macOs">
27-
```terminal !! macOS
27+
```terminal !! Homebrew
2828
$ brew install clarinet
2929
```
3030

31-
```terminal !! Windows
31+
```terminal !! Winget
3232
$ winget install clarinet
3333
```
3434

35-
```terminal !! Cargo
35+
```terminal !! Source
3636
$ sudo apt install build-essential pkg-config libssl-dev
37+
$ git clone https://github.com/hirosystems/clarinet
38+
$ cd clarinet
39+
$ cargo clarinet-install
3740
```
3841

3942
```terminal !! Binary

0 commit comments

Comments
 (0)