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

  
 
  

home | help
BSON_VALIDATE_...RROR_AND_OFFSET(3)  libbson BSON_VALIDATE_...RROR_AND_OFFSET(3)

SYNOPSIS
	bool
	bson_validate_with_error_and_offset (const bson_t *bson,
					     bson_validate_flags_t flags,
					     size_t *offset,
					     bson_error_t *error)

PARAMETERS
     * bson: A bson_t.

     * flags: A bitwise-or of all desired bson_validate_flags_t.

     * offset: Optional location where the error offset will be written.

     * error: Optional bson_error_t.

DESCRIPTION
     Validates	a  BSON  document by walking through the document and inspecting
     the keys and values for valid content.

     You can modify how the validation occurs through the use of the flags para-
     meter, see bson_validate_flags_t for details.

RETURNS
     If bson passes the requested validations, returns true.  Otherwise, returns
     false and writes each non-NULL output parameter: offset with the byte  off-
     set of the detected error and error with the details.

     The  bson_error_t	domain	is set to BSON_ERROR_INVALID. Its code is set to
     one of the bson_validate_flags_t flags indicating which validation  failed;
     for  example,  if	a  key	contains  invalid UTF-8, then the code is set to
     BSON_VALIDATE_UTF8, but if the basic structure of the BSON document is cor-
     rupt, the code is set to BSON_VALIDATE_NONE. The error  message  is  filled
     out, and gives more detail if possible.

     SEE ALSO:
	bson_validate(), bson_validate_with_error().

	bson_visitor_t can be used for custom validation, Example Custom Validation.

AUTHOR
     MongoDB, Inc

COPYRIGHT
     2009-present, MongoDB, Inc.

1.30.8				  Aug 27, 202BSON_VALIDATE_...RROR_AND_OFFSET(3)

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

home | help