Chiebot-Mirror
/
protobuf
mirror of https://github.com/protocolbuffers/protobuf.git
8
0
Fork 0
Code Issues Projects Releases Wiki Activity

Add syntax highlighting for code blocks

Browse Source
pull/8832/head
Bu Sun Kim 3 years ago committed by GitHub
parent d662ec9c2e
commit c9baf39caa
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 23 additions and 23 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 46
      docs/field_presence.md

46
docs/field_presence.md
Unescape View File

@ -66,7 +66,7 @@ Singular fields (of all types) track presence explicitly in the generated API. T
Similar to singular fields, `oneof` fields explicitly track which one of the members, if any, contains a value. For example, consider this example `oneof`: Similar to singular fields, `oneof` fields explicitly track which one of the members, if any, contains a value. For example, consider this example `oneof`:
``` ```protobuf
oneof foo { oneof foo {
int32 a = 1; int32 a = 1;
float b = 2; float b = 2;
@ -144,7 +144,7 @@ This change may or may not be safe, depending on the application's semantics. Fo
Client A uses this definition of the message, which follows the _explicit presence_ serialization discipline for field `foo`: Client A uses this definition of the message, which follows the _explicit presence_ serialization discipline for field `foo`:
``` ```protobuf
syntax = "proto3"; syntax = "proto3";
message Msg { message Msg {
optional int32 foo = 1; optional int32 foo = 1;
@ -153,7 +153,7 @@ message Msg {
Client B uses a definition of the same message, except that it follows the _no presence_ discipline: Client B uses a definition of the same message, except that it follows the _no presence_ discipline:
``` ```protobuf
syntax = "proto3"; syntax = "proto3";
message Msg { message Msg {
int32 foo = 1; int32 foo = 1;
@ -162,7 +162,7 @@ message Msg {
Now, consider a scenario where client A observes `foo`'s presence as the clients repeatedly exchange the "same" message by deserializing and reserializing: Now, consider a scenario where client A observes `foo`'s presence as the clients repeatedly exchange the "same" message by deserializing and reserializing:
``` ```protobuf
// Client A: // Client A:
Msg m_a; Msg m_a;
m_a.set_foo(1); // non-default value m_a.set_foo(1); // non-default value
@ -208,7 +208,7 @@ These are the general steps to use the experimental field tracking support for p
This is an example of a proto3 message with fields which follow both _no presence_ and _explicit presence_ semantics: This is an example of a proto3 message with fields which follow both _no presence_ and _explicit presence_ semantics:
``` ```protobuf
syntax = "proto3"; syntax = "proto3";
package example; package example;
@ -231,7 +231,7 @@ The generated code for proto3 fields with _explicit presence_ (the `optional` la
This is the definition used in the "no presence" examples below: This is the definition used in the "no presence" examples below:
``` ```protobuf
syntax = "proto3"; syntax = "proto3";
package example; package example;
message Msg { message Msg {
@ -241,7 +241,7 @@ message Msg {
This is the definition used in the "explicit presence" examples below: This is the definition used in the "explicit presence" examples below:
``` ```protobuf
syntax = "proto3"; syntax = "proto3";
package example; package example;
message Msg { message Msg {
@ -255,7 +255,7 @@ In the examples, a function `GetProto` constructs and returns a message of type
No presence: No presence:
``` ```C++
Msg m = GetProto(); Msg m = GetProto();
if (m.foo() != 0) { if (m.foo() != 0) {
// "Clear" the field: // "Clear" the field:
@ -268,7 +268,7 @@ if (m.foo() != 0) {
Explicit presence: Explicit presence:
``` ```C++
Msg m = GetProto(); Msg m = GetProto();
if (m.has_foo()) { if (m.has_foo()) {
// Clear the field: // Clear the field:
@ -283,7 +283,7 @@ if (m.has_foo()) {
No presence: No presence:
``` ```C#
var m = GetProto(); var m = GetProto();
if (m.Foo != 0) { if (m.Foo != 0) {
// "Clear" the field: // "Clear" the field:
@ -296,7 +296,7 @@ if (m.Foo != 0) {
Explicit presence: Explicit presence:
``` ```C#
var m = GetProto(); var m = GetProto();
if (m.HasFoo) { if (m.HasFoo) {
// Clear the field: // Clear the field:
@ -311,7 +311,7 @@ if (m.HasFoo) {
No presence: No presence:
``` ```go
m := GetProto() m := GetProto()
if m.Foo != 0 { if m.Foo != 0 {
// "Clear" the field: // "Clear" the field:
@ -324,7 +324,7 @@ if m.Foo != 0 {
Explicit presence: Explicit presence:
``` ```go
m := GetProto() m := GetProto()
if m.Foo != nil { if m.Foo != nil {
// Clear the field: // Clear the field:
@ -341,7 +341,7 @@ These examples use a `Builder` to demonstrate clearing. Simply checking presence
No presence: No presence:
``` ```java
Msg.Builder m = GetProto().toBuilder(); Msg.Builder m = GetProto().toBuilder();
if (m.getFoo() != 0) { if (m.getFoo() != 0) {
// "Clear" the field: // "Clear" the field:
@ -354,7 +354,7 @@ if (m.getFoo() != 0) {
Explicit presence: Explicit presence:
``` ```java
Msg.Builder m = GetProto().toBuilder(); Msg.Builder m = GetProto().toBuilder();
if (m.hasFoo()) { if (m.hasFoo()) {
// Clear the field: // Clear the field:
@ -369,7 +369,7 @@ if (m.hasFoo()) {
No presence: No presence:
``` ```python
m = example.Msg() m = example.Msg()
if m.foo != 0: if m.foo != 0:
// "Clear" the field: // "Clear" the field:
@ -381,7 +381,7 @@ else:
Explicit presence: Explicit presence:
``` ```python
m = example.Msg() m = example.Msg()
if m.HasField('foo'): if m.HasField('foo'):
// Clear the field: // Clear the field:
@ -395,7 +395,7 @@ else:
No presence: No presence:
``` ```ruby
m = Msg.new m = Msg.new
if m.foo != 0 if m.foo != 0
// "Clear" the field: // "Clear" the field:
@ -408,7 +408,7 @@ end
Explicit presence: Explicit presence:
``` ```ruby
m = Msg.new m = Msg.new
if m.has_foo? if m.has_foo?
// Clear the field: // Clear the field:
@ -423,7 +423,7 @@ end
No presence: No presence:
``` ```js
var m = new Msg(); var m = new Msg();
if (m.getFoo() != 0) { if (m.getFoo() != 0) {
// "Clear" the field: // "Clear" the field:
@ -436,7 +436,7 @@ if (m.getFoo() != 0) {
Explicit presence: Explicit presence:
``` ```js
var m = new Msg(); var m = new Msg();
if (m.hasFoo()) { if (m.hasFoo()) {
// Clear the field: // Clear the field:
@ -451,7 +451,7 @@ if (m.hasFoo()) {
No presence: No presence:
``` ```Objective-C
Msg *m = [[Msg alloc] init]; Msg *m = [[Msg alloc] init];
if (m.foo != 0) { if (m.foo != 0) {
// "Clear" the field: // "Clear" the field:
@ -464,7 +464,7 @@ if (m.foo != 0) {
Explicit presence: Explicit presence:
``` ```Objective-C
Msg *m = [[Msg alloc] init]; Msg *m = [[Msg alloc] init];
if (m.hasFoo()) { if (m.hasFoo()) {
// Clear the field: // Clear the field:

Write Preview
Loading…
Cancel
Save