1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
.\"
.\" Copyright (c) 2025 Robert Clausecker <fuz@FreeBSD.org>
.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.Dd November 9, 2025
.Dt STDC_BIT_WIDTH 3
.Os
.Sh NAME
.Nm stdc_bit_width
.Nd find the first trailing one in an intege
.Sh SYNOPSIS
.Lb libc
.In stdbit.h
.Ft unsigned int
.Fn stdc_bit_width_uc "unsigned char value"
.Ft unsigned int
.Fn stdc_bit_width_us "unsigned short value"
.Ft unsigned int
.Fn stdc_bit_width_ui "unsigned int value"
.Ft unsigned int
.Fn stdc_bit_width_ul "unsigned long value"
.Ft unsigned int
.Fn stdc_bit_width_ull "unsigned long long value"
.Ft unsigned int
.Fn stdc_bit_width "value"
.Sh DESCRIPTION
The
.Nm stdc_bit_width_ Ns Em type Ns ()
family of functions returns the number of bits needed to represent
.Fa value ,
where
.Fa value
is of type
.Va unsigned char ,
.Va unsigned short ,
.Va unsigned int ,
.Va unsigned long ,
or
.Va unsigned long long
for
.Em type
being
.Sy uc ,
.Sy us ,
.Sy ui ,
.Sy ul ,
or
.Sy ull
respectively.
The
.Fn stdc_bit_width "value"
type-generic macro picks the appropriate
.Nm stdc_bit_width_ Ns Em type Ns ()
function based on the type of
.Fa value .
.Pp
Functions
.Fn stdc_bit_width_ui ,
.Fn stdc_bit_width_ul ,
and
.Fn stdc_bit_width_ull
are identical to
.Bx 4.3
functions
.Xr fls 3 ,
.Xr flsl 3 ,
and
.Xr flsll 3
respectively, except for operating on unsigned instead of signed values.
.Sh RETURN VALUES
Returns the least number of bits needed to represent
.Fa value .
If
.Fa value
is zero, the return value is zero.
Otherwise it is
.EQ
1 + \(lf log sub 2 italic value \(rf .
.EN
.Sh SEE ALSO
.Xr bit_fls 3 ,
.Xr fls 3 ,
.Xr flsl 3 ,
.Xr flsll 3 ,
.Xr stdbit 3 ,
.Xr stdc_count_leading_zeros 3 ,
.Xr stdc_first_leading_one 3
.Sh STANDARDS
The
.Nm stdc_bit_width_ Ns Em type Ns ()
family of functions and the
.Fn stdc_bit_width
type-generic macro conform to
.St -isoC-2023 .
.Sh HISTORY
The
.Nm stdc_bit_width_ Ns Em type Ns ()
family of functions and the
.Fn stdc_bit_width
type-generic macro were added in
.Fx 15.1.
.Sh AUTHOR
.An Robert Clausecker Aq Mt fuz@FreeBSD.org
|
