Protocol Buffers Documentation
    • Protobuf
      • Overview
      • Protoc Installation
      • News
      • Programming Guides
        • Language Guide (editions)
        • Language Guide (proto 2)
        • Language Guide (proto 3)
        • Proto Limits
        • Style Guide
        • Enum Behavior
        • Encoding
        • ProtoJSON Format
        • Techniques
        • Add-ons
        • Extension Declarations
        • Field Presence
        • Symbol Visibility
        • Proto Serialization Is Not Canonical
        • Deserializing Debug Proto Representations
      • Protobuf Editions
        • Overview
        • Feature Settings for Editions
        • Implementing Editions Support
      • Design Decisions
        • No Nullable Setters/Getters Support
        • We Prefer Opaque APIs
        • Implicit Presence
        • Insertion Points and Generic Services Regretted and Deprecated
      • Proto Best Practices
        • Avoid Cargo Culting
        • Proto Best Practices
        • 1-1-1 Best Practice
      • Tutorials
        • C++
        • C#
        • Dart
        • Go
        • Java
        • Kotlin
        • Python
      • Reference Guides
        • C++
          • Generated Code Guide
          • String View APIs
          • Arena Allocation Guide
          • Abseil Support
          • C++ API
        • C#
          • Generated Code Guide
          • C# API
        • Dart
          • Generated Code
          • Dart API
        • Go
          • Generated Code Guide (Open)
          • Generated Code Guide (Opaque)
          • FAQ
          • Size Semantics
          • Go API
          • Opaque API Migration
          • Opaque API: Manual Migration
          • Opaque API FAQ
        • Java
          • Generated Code Guide
          • UTF-8 Validation in Java
          • Generated Proto Names
          • Java API
        • Kotlin
          • Kotlin
          • Generated Code Guide
        • Objective-C
          • Generated Code Guide
        • PHP
          • Generated Code Guide
          • PHP API
        • Python
          • Generated Code Guide
          • Python Comparison
          • Python API
        • Ruby
          • Generated Code Guide
        • Rust
          • Generated Code Guide
          • Redaction in Rust
          • Building Rust Protos
          • Design Decisions
        • Protobuf
          • 2023 Language Specification
          • Language Specification (Proto2 Syntax)
          • 2024 Language Specification
          • Language Specification (Proto3)
          • Text Format Language Specification
          • MIME Types
          • Well-Known Types
        • Other Languages
      • Support
        • Version Support
        • Debugging
        • Migration Guide
        • Cross-Version Runtime Guarantee
      • Downloads
      • History
      • Forum
      • Search Results
    View page source Edit this page Create child page Create documentation issue Create project issue
    • The Problem Domain
    • Where to Find the Example Code
    • Defining Your Protocol Format
    • Compiling Your Protobuf Schema
    • The Protobuf API
    • Writing a Message
    • Reading a Message
    • Extending a Protobuf Message
    1. Tutorials