From 554595a7a5213e17a0d180f53fe6cd6e40adf0c2 Mon Sep 17 00:00:00 2001
From: darkdrag00nv2 <122124396+darkdrag00nv2@users.noreply.github.com>
Date: Mon, 24 Jul 2023 23:46:33 +0530
Subject: [PATCH] Document `Character.utf8` field (#163)

* Document Character.utf8

* Move documentation to the end

---------

Co-authored-by: Alex <12097569+nialexsan@users.noreply.github.com>
---
 docs/cadence/language/values-and-types.mdx | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/cadence/language/values-and-types.mdx b/docs/cadence/language/values-and-types.mdx
index 470e8e5ae1..1de2dbfd30 100644
--- a/docs/cadence/language/values-and-types.mdx
+++ b/docs/cadence/language/values-and-types.mdx
@@ -950,6 +950,21 @@ let c = str[0] // is the Character "a"
     let uwu: String = String.fromCharacters(rawUwU) // "UwU"
     ```
 
+-
+    ```cadence
+    let utf8: [UInt8]
+    ```
+
+    The byte array of the UTF-8 encoding
+
+    ```cadence
+    let a: Character = "a"
+    let a_bytes = a.utf8 // `a_bytes` is `[97]`
+
+    let bouquet: Character = "\u{1F490}"
+    let bouquet_bytes = bouquet.utf8 // `bouquet_bytes` is `[240, 159, 146, 144]`
+    ```
+
 ## Arrays
 
 Arrays are mutable, ordered collections of values.