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.
11 lines
361 B
Plaintext
11 lines
361 B
Plaintext
Replaces each byte in +self+ with the bitwise OR of that byte and the
|
|
corresponding byte in +other+; returns +self+:
|
|
|
|
s = "\xF0"
|
|
s.bitwise_or!("\x0C") # => "\xFC"
|
|
s # => "\xFC"
|
|
|
|
+other+ is converted to a string using +to_str+.
|
|
Raises +ArgumentError+ if the two strings have different byte sizes.
|
|
The encoding of +self+ is not changed.
|