update document of utf8.offset in Lua 5.5

Author: sumneko

changelog.md

@@ -3,6 +3,10 @@
 ## Unreleased
 <!-- Add all new changes here. They will be moved under a version at release -->
 
+## 3.16.4
+* `FIX` (VSCode) Broken `view document`
+
+
 ## 3.16.3
 `2025-12-23`
 * `CHG` Upgraded to Lua 5.5, memory usage has been reduced by ~10%

locale/en-us/meta.lua

@@ -881,3 +881,5 @@ utf8.len                    =
 'Returns the number of UTF-8 characters in string `s` that start between positions `i` and `j` (both inclusive).'
 utf8.offset                 =
 'Returns the position (in bytes) where the encoding of the `n`-th character of `s` (counting from position `i`) starts.'
+utf8.offset[55]             =
+'Returns the position of the n-th character of s (counting from byte position i) as two integers: The index (in bytes) where its encoding starts and the index (in bytes) where it ends.'

meta/template/utf8.lua

@@ -67,12 +67,25 @@ function utf8.len(s, i, j) end
 function utf8.len(s, i, j, lax) end
 ---#end
 
+---#if VERSION <= 5.4 then
 ---#DES 'utf8.offset'
 ---@param s string
 ---@param n integer
 ---@param i? integer
 ---@return integer p
 ---@nodiscard
 function utf8.offset(s, n, i) end
+---#end
+
+---#if VERSION >= 5.5 then
+---#DES 'utf8.offset.55'
+---@param s string
+---@param n integer
+---@param i? integer
+---@return integer ps
+---@return integer pe
+---@nodiscard
+function utf8.offset(s, n, i) end
+---#end
 
 return utf8