Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
BSON_UTF8_ESCAPE_FOR_JSON(3)	     libbson	    BSON_UTF8_ESCAPE_FOR_JSON(3)

SYNOPSIS
	char *
	bson_utf8_escape_for_json (const char *utf8, ssize_t utf8_len);

PARAMETERS
     * utf8: A UTF-8 encoded string.

     * utf8_len: The length of utf8 in bytes or -1 if it is NULL terminated.

DESCRIPTION
     Allocates a new string matching utf8 except that special characters in JSON
     are escaped. The resulting string is also UTF-8 encoded.

     Both  "  and \ characters will be backslash-escaped. If a NUL byte is found
     before utf8_len bytes, it is converted to "\u0000". Other non-ASCII charac-
     ters in the input are preserved.

     The two-byte sequence "C0 80" is also interpreted as an internal  NUL,  for
     historical  reasons.   This  sequence  is	considered  invalid according to
     RFC3629.

RETURNS
     A newly allocated string that should be freed with bson_free() when utf8 is
     a valid UTF-8 string, or NULL if the (possibly invalid UTF-8) string  could
     not be escaped.

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 2026	    BSON_UTF8_ESCAPE_FOR_JSON(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bson_utf8_escape_for_json&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help