5 BN_set_bit, BN_clear_bit, BN_is_bit_set, BN_mask_bits, BN_lshift,
6 BN_lshift1, BN_rshift, BN_rshift1 - bit operations on BIGNUMs
10 #include <openssl/bn.h>
12 int BN_set_bit(BIGNUM *a, int n);
13 int BN_clear_bit(BIGNUM *a, int n);
15 int BN_is_bit_set(const BIGNUM *a, int n);
17 int BN_mask_bits(BIGNUM *a, int n);
19 int BN_lshift(BIGNUM *r, const BIGNUM *a, int n);
20 int BN_lshift1(BIGNUM *r, BIGNUM *a);
22 int BN_rshift(BIGNUM *r, BIGNUM *a, int n);
23 int BN_rshift1(BIGNUM *r, BIGNUM *a);
27 BN_set_bit() sets bit B<n> in B<a> to 1 (C<a|=(1E<lt>E<lt>n)>). The
28 number is expanded if necessary.
30 BN_clear_bit() sets bit B<n> in B<a> to 0 (C<a&=~(1E<lt>E<lt>n)>). An
31 error occurs if B<a> is shorter than B<n> bits.
33 BN_is_bit_set() tests if bit B<n> in B<a> is set.
35 BN_mask_bits() truncates B<a> to an B<n> bit number
36 (C<a&=~((~0)E<gt>E<gt>n)>). An error occurs if B<a> already is
37 shorter than B<n> bits.
39 BN_lshift() shifts B<a> left by B<n> bits and places the result in
40 B<r> (C<r=a*2^n>). Note that B<n> must be non-negative. BN_lshift1() shifts
41 B<a> left by one and places the result in B<r> (C<r=2*a>).
43 BN_rshift() shifts B<a> right by B<n> bits and places the result in
44 B<r> (C<r=a/2^n>). Note that B<n> must be non-negative. BN_rshift1() shifts
45 B<a> right by one and places the result in B<r> (C<r=a/2>).
47 For the shift functions, B<r> and B<a> may be the same variable.
51 BN_is_bit_set() returns 1 if the bit is set, 0 otherwise.
53 All other functions return 1 for success, 0 on error. The error codes
54 can be obtained by L<ERR_get_error(3)>.
58 L<bn(3)>, L<BN_num_bytes(3)>, L<BN_add(3)>
62 Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved.
64 Licensed under the OpenSSL license (the "License"). You may not use
65 this file except in compliance with the License. You can obtain a copy
66 in the file LICENSE in the source distribution or at
67 L<https://www.openssl.org/source/license.html>.