Add char_length and character_length functions (#748)

Add docs for the new size(STRING) aliases

---------

Co-authored-by: Jens Pryce-Åklundh <[email protected]>

Author: gem-neo4j

modules/ROOT/pages/deprecations-additions-removals-compatibility.adoc

@@ -88,6 +88,30 @@ a|
 label:functionality[]
 label:new[]
 
+[source, cypher, role=noheader]
+----
+RETURN char_length(expr)
+----
+
+| Introduction of a xref::functions/scalar.adoc#functions-char_length[char_length()] function.
+This function returns the number of Unicode characters in a `STRING`. It is an alias of the xref::functions/scalar.adoc#functions-size[`size()`] function.
+
+a|
+label:functionality[]
+label:new[]
+
+[source, cypher, role=noheader]
+----
+RETURN character_length(expr)
+----
+
+| Introduction of a xref::functions/scalar.adoc#functions-character_length[character_length()] function.
+This function returns the number of Unicode characters in a `STRING`. It is an alias of the xref::functions/scalar.adoc#functions-size[`size()`] function.
+
+a|
+label:functionality[]
+label:new[]
+
 New privilege:
 [source, cypher, role=noheader]
 ----

modules/ROOT/pages/functions/index.adoc

@@ -91,6 +91,15 @@ These functions return a single value.
 |===
 | Function | Signature | Description
 
+1.1+| xref::functions/scalar.adoc#functions-char_length[`char_length()`]
+| `char_length(input :: STRING) :: INTEGER`
+| Returns the number of Unicode characters in a `STRING`.
+label:new[Introduced in 5.13]
+
+1.1+| xref::functions/scalar.adoc#functions-character_length[`character_length()`]
+| `character_length(input :: STRING) :: INTEGER`
+| Returns the number of Unicode characters in a `STRING`.
+label:new[Introduced in 5.13]
 1.1+| xref::functions/scalar.adoc#functions-coalesce[`coalesce()`]
 | `coalesce(input :: ANY) :: ANY`
 | Returns the first non-null value in a list of expressions.

modules/ROOT/pages/functions/scalar.adoc

@@ -34,6 +34,136 @@ CREATE
 ////
 
 
+[[functions-char_length]]
+== char_length()
+
+_This feature was introduced in Neo4j 5.13._
+
+The function `char_length()` returns the number of Unicode characters in a `STRING`.
+This function is an alias of the xref::functions/scalar.adoc#functions-size[`size()`] function.
+
+*Syntax:*
+
+[source, syntax, role="noheader"]
+----
+char_length(string)
+----
+
+*Returns:*
+
+|===
+
+| `INTEGER`
+
+|===
+
+*Arguments:*
+
+[options="header"]
+|===
+| Name | Description
+
+| `string`
+| An expression that returns a `STRING`.
+
+|===
+
+*Considerations:*
+|===
+
+| `char_length(null)` returns `null`.
+
+|===
+
+
+.+char_length()+
+======
+
+.Query
+[source, cypher, indent=0]
+----
+RETURN char_length('Alice')
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+
+| +char_length('Alice')+
+| +5+
+1+d|Rows: 1
+
+|===
+
+The number of Unicode characters in the string is returned.
+
+======
+
+[[functions-character_length]]
+== character_length()
+
+_This feature was introduced in Neo4j 5.13._
+
+The function `character_length()` returns the number of Unicode characters in a `STRING`.
+This function is an alias of the xref::functions/scalar.adoc#functions-size[`size()`] function.
+
+*Syntax:*
+
+[source, syntax, role="noheader"]
+----
+character_length(string)
+----
+
+*Returns:*
+
+|===
+
+| `INTEGER`
+
+|===
+
+*Arguments:*
+
+[options="header"]
+|===
+| Name | Description
+
+| `string`
+| An expression that returns a `STRING`.
+
+|===
+
+*Considerations:*
+|===
+
+| `character_length(null)` returns `null`.
+
+|===
+
+
+.+character_length()+
+======
+
+.Query
+[source, cypher, indent=0]
+----
+RETURN character_length('Alice')
+----
+
+.Result
+[role="queryresult",options="header,footer",cols="1*<m"]
+|===
+
+| +character_length('Alice')+
+| +5+
+1+d|Rows: 1
+
+|===
+
+The number of Unicode characters in the string is returned.
+
+======
+
 [[functions-coalesce]]
 == coalesce()