mirror of
https://github.com/ruby/ruby.git
synced 2026-10-28 16:36:20 +08:00
HASUMI Hitoshi
2461caebba
This patch adds the following methods to String class: * String#bit_get(offset, lsb_first: true) -> 1 | 0 | nil * String#bit_set?(offset, lsb_first: true) -> true | false | nil * String#bit_set(offset, lsb_first: true) -> self * String#bit_clear(offset, lsb_first: true) -> self * String#bit_flip(offset, lsb_first: true) -> self * String#bit_count -> Integer * String#bitwise_not -> String * String#bitwise_not! -> self * String#bitwise_and(other) -> String * String#bitwise_and!(other) -> self * String#bitwise_or(other) -> String * String#bitwise_or!(other) -> self * String#bitwise_xor(other) -> String * String#bitwise_xor!(other) -> self Other than implementation, tests, specs, and docs are added. Link: [Feature #22118] ## Note In `string.c`, I wrote some big macro that create method functions and helper functions: * STR_DEFINE_BINARY_BITWISE_METHOD * STR_DEFINE_UNARY_BITWISE_KERNEL * STR_DEFINE_BINARY_BITWISE_KERNEL While using macros like this reduces maintainability, I believe it's acceptable because there are no plans to extend the `bitwise_*` methods beyond this proposal, and the logic is stable. On the other hand, other methods such as `bit_get` and `bit_count` are planned to have argument extensions in the future.
8 lines
276 B
Plaintext
8 lines
276 B
Plaintext
Returns a new string whose bytes are the bitwise OR of +self+ and +other+:
|
|
|
|
"\xF0".bitwise_or("\x0C") # => "\xFC"
|
|
|
|
+other+ is converted to a string using +to_str+.
|
|
Raises +ArgumentError+ if the two strings have different byte sizes.
|
|
The returned string has BINARY encoding.
|