mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2025-03-07 17:28:15 +00:00
virBitmapToString|virBitmapNewString: Clarify semantics of the 'string'
Clarify which bit is considered most significant in the bitmap and resulting string. Also be explicit that it's a hex string. Signed-off-by: Peter Krempa <pkrempa@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
This commit is contained in:
parent
8efad320fa
commit
2eada815b5
@ -328,7 +328,9 @@ virBitmapGetBit(virBitmapPtr bitmap,
|
|||||||
* virBitmapToString:
|
* virBitmapToString:
|
||||||
* @bitmap: Pointer to bitmap
|
* @bitmap: Pointer to bitmap
|
||||||
*
|
*
|
||||||
* Convert @bitmap to printable string.
|
* Convert @bitmap to a number where the bit with highest position/index in
|
||||||
|
* @bitmap represents the most significant bit and return the number in form
|
||||||
|
* of a hexadecimal string.
|
||||||
*
|
*
|
||||||
* Returns pointer to the string or NULL on error.
|
* Returns pointer to the string or NULL on error.
|
||||||
*/
|
*/
|
||||||
@ -1117,10 +1119,14 @@ virBitmapCountBits(virBitmapPtr bitmap)
|
|||||||
* virBitmapNewString:
|
* virBitmapNewString:
|
||||||
* @string: the string to be converted to a bitmap
|
* @string: the string to be converted to a bitmap
|
||||||
*
|
*
|
||||||
* Allocate a bitmap from a string of hexadecimal data.
|
* Allocate a bitmap and populate it from @string representing a number in
|
||||||
|
* hexadecimal format. Note that the most significant bit of the number
|
||||||
|
* represented by @string will correspond to the highest index/position in the
|
||||||
|
* bitmap. The size of the returned bitmap corresponds to 4 * the length of
|
||||||
|
* @string.
|
||||||
*
|
*
|
||||||
* Returns a pointer to the allocated bitmap or NULL if
|
* Returns a pointer to the allocated bitmap or NULL and reports an error if
|
||||||
* memory cannot be allocated.
|
* @string can't be converted.
|
||||||
*/
|
*/
|
||||||
virBitmapPtr
|
virBitmapPtr
|
||||||
virBitmapNewString(const char *string)
|
virBitmapNewString(const char *string)
|
||||||
|
Loading…
x
Reference in New Issue
Block a user