Generic Operator

&<<(_:_:)

Returns the result of shifting a value’s binary representation the specified number of digits to the left, masking the shift amount to the type’s bit width. ある値のバイナリ表現を指定された桁数だけ左にシフトする結果を返します、シフト量をマスクしてその型のもつビット幅にしています。

Declaration 宣言 

static func &<< <Other>(lhs: UInt8, rhs: Other) -> UInt8 where Other : BinaryInteger

Parameters パラメータ

lhs

The value to shift. シフトする値。

rhs

The number of bits to shift lhs to the left. If rhs is outside the range 0..<lhs.bitWidth, it is masked to produce a value within that range. このビット数をlhsから左へとシフトします。rhsが範囲0..<lhs.bitWidthの外側ならば、それはマスクされてその範囲内の値を生み出します。

Discussion 解説

Use the masking left shift operator (&<<) when you need to perform a shift and are sure that the shift amount is in the range 0..<lhs.bitWidth. Before shifting, the masking left shift operator masks the shift to this range. The shift is performed using this masked value. マスク左シフト演算子（&<<）を、あなたがあるシフトを実行する、そしてシフト量が範囲0..<lhs.bitWidthの中であるのを確実にする必要がある場合に使ってください。シフトする前に、マスク左シフト演算子は、シフトをマスクしてこの範囲にします。シフトは、このマスクされた値を使って実行されます。

The following example defines x as an instance of UInt8, an 8-bit, unsigned integer type. If you use 2 as the right-hand-side value in an operation on x, the shift amount requires no masking. 以下の例は、xをUInt8のインスタンス、ある８ビットの、符号なし整数型として定義します。あなたが2を右手側の値としてxに関する演算において使うならば、シフト量はマスクを必要としません。 


let x: UInt8 = 30                 // 0b00011110
let y = x &<< 2
// y == 120                       // 0b01111000

However, if you use 8 as the shift amount, the method first masks the shift amount to zero, and then performs the shift, resulting in no change to the original value. しかしながら、あなたが8をシフト量として使うならば、メソッドは最初にそのシフト量をマスクしてゼロにして、それからシフトを実行して、元の値に対して変更しないという結果になります。 


let z = x &<< 8
// z == 30                        // 0b00011110

If the bit width of the shifted integer type is a power of two, masking is performed using a bitmask; otherwise, masking is performed using a modulo operation. シフトされる整数型のビット幅が２の冪ならば、マスクはビットマスクを使って実行されます；そうでなければ、マスクはモジュロ演算を使って実行されます。