PreferUTF8 property (NotesJSONNavigator – LotusScript)

Default value is False, When set to True, the PreferUTF8 property make string values of element retrieved from a JSONNavigator (for example, using GetElementByName) to be automatically converted to a UTF-8 byte array.

Defined in

NotesJSONNavigator

Data type

Boolean

Syntax

To get: flaf =NotesJSONNavigator.PreferUTF8

To set: NotesJSONNavigator.PreferUTF8 = True

Legal values

  • False (it is default value)
  • True, when set element value of String type convert to UTF-8 byte array.

Example

Following example will return an element with type = 6 (Jsonelem_type_utf8_bytearray) 
and el.value will be array of character codes for string "value" : [118,97,108,117,101]

Dim session As New NotesSession
Dim nav As NotesJSONNavigator
Dim el As NotesJSONElement

Set nav = session.Createjsonnavigator("")
nav.Preferutf8 = True
Call nav.Appendelement("value" & Chr$(0) & "embedded_zero" , "key")
Set el = nav.Getelementbyname("key")