@@ -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]
0 commit comments