1b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer#region Copyright notice and license 2b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// Protocol Buffers - Google's data interchange format 3b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// Copyright 2008 Google Inc. All rights reserved. 4b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// https://developers.google.com/protocol-buffers/ 5b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// 6b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// Redistribution and use in source and binary forms, with or without 7b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// modification, are permitted provided that the following conditions are 8b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// met: 9b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// 10b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// * Redistributions of source code must retain the above copyright 11b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// notice, this list of conditions and the following disclaimer. 12b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// * Redistributions in binary form must reproduce the above 13b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// copyright notice, this list of conditions and the following disclaimer 14b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// in the documentation and/or other materials provided with the 15b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// distribution. 16b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// * Neither the name of Google Inc. nor the names of its 17b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// contributors may be used to endorse or promote products derived from 18b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// this software without specific prior written permission. 19b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// 20b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 21b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 22b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 23b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 24b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 25b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 26b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 27b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 28b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 29b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 30b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 31b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer#endregion 32b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer 33b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammernamespace Google.Protobuf 34b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer{ 35b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 36b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// This class is used internally by the Protocol Buffer Library and generated 37b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// message implementations. It is public only for the sake of those generated 38b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// messages. Others should not use this class directly. 39b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <para> 40b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// This class contains constants and helper functions useful for dealing with 41b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// the Protocol Buffer wire format. 42b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </para> 43b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 44b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer public static class WireFormat 45b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer { 46b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 47b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// Wire types within protobuf encoding. 48b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 49b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer public enum WireType : uint 50b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer { 51b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 52b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// Variable-length integer. 53b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 54b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer Varint = 0, 55b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 56b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// A fixed-length 64-bit value. 57b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 58b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer Fixed64 = 1, 59b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 60b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// A length-delimited value, i.e. a length followed by that many bytes of data. 61b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 62b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer LengthDelimited = 2, 63b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 64b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// A "start group" value - not supported by this implementation. 65b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 66b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer StartGroup = 3, 67b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 68b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// An "end group" value - not supported by this implementation. 69b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 70b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer EndGroup = 4, 71b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 72b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// A fixed-length 32-bit value. 73b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 74b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer Fixed32 = 5 75b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer } 76b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer 77b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer private const int TagTypeBits = 3; 78b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer private const uint TagTypeMask = (1 << TagTypeBits) - 1; 79b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer 80b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 81b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// Given a tag value, determines the wire type (lower 3 bits). 82b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 83b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer public static WireType GetTagWireType(uint tag) 84b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer { 85b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer return (WireType) (tag & TagTypeMask); 86b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer } 87b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer 88b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 89b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// Given a tag value, determines the field number (the upper 29 bits). 90b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 91b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer public static int GetTagFieldNumber(uint tag) 92b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer { 93b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer return (int) tag >> TagTypeBits; 94b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer } 95b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer 96b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// <summary> 97b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// Makes a tag value given a field number and wire type. 98b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer /// </summary> 99b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer public static uint MakeTag(int fieldNumber, WireType wireType) 100b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer { 101b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer return (uint) (fieldNumber << TagTypeBits) | (uint) wireType; 102b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer } 103b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer } 104b0575e93e4c39dec69365b850088a1eb7f82c5b3Tamas Berghammer}