From c75787c3272f39059f279dab1838f30f7024b2d7 Mon Sep 17 00:00:00 2001 From: Tony Liao Date: Wed, 31 Jul 2024 16:26:23 -0700 Subject: [PATCH] Documentation Update: Add comment to describe parse options. PiperOrigin-RevId: 658181403 --- src/google/protobuf/message_lite.h | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/src/google/protobuf/message_lite.h b/src/google/protobuf/message_lite.h index 94e18c1284..058b114768 100644 --- a/src/google/protobuf/message_lite.h +++ b/src/google/protobuf/message_lite.h @@ -804,10 +804,24 @@ class PROTOBUF_EXPORT MessageLite { public: enum ParseFlags { + // Merge vs. Parse: + // Merge: overwrites scalar fields but appends to repeated fields in the + // destination; other fields in the destination remain untouched. + // Parse: clears all fields in the destination before calling Merge. kMerge = 0, kParse = 1, + // Default behaviour vs. Partial: + // Default: a missing required field is deemed as parsing failure. + // Partial: parse or merge will not give an error if input is missing + // required fields. kMergePartial = 2, kParsePartial = 3, + // Default behaviour vs. Aliasing: + // Default: when merging, pointer is followed and expanded (deep-copy). + // Aliasing: when merging, the destination message is allowed to retain + // pointers to the original structure (shallow-copy). This mostly + // is intended for use with STRING_PIECE. + // NOTE: STRING_PIECE is not recommended for new usage. Prefer Cords. kMergeWithAliasing = 4, kParseWithAliasing = 5, kMergePartialWithAliasing = 6,