UUID(3) | FreeBSD Library Functions Manual | UUID(3) |
名称
uuid_compare, uuid_create, uuid_create_nil, uuid_equal, uuid_from_string, uuid_hash, uuid_is_nil, uuid_to_string — DCE 1.1 準拠 UUID 関数ライブラリ
Standard C Library (libc, -lc)書式
#include < uuid.h> int32_t
uuid_compare( const uuid_t *uuid1, const uuid_t *uuid2, uint32_t *status);
void
uuid_create( uuid_t *uuid, uint32_t *status);
void
uuid_create_nil( uuid_t *uuid, uint32_t *status);
int32_t
uuid_equal( const uuid_t *uuid1, const uuid_t *uuid2, uint32_t *status);
void
uuid_from_string( const char *str, uuid_t *uuid, uint32_t *status);
uint16_t
uuid_hash( const uuid_t *uuid, uint32_t *status);
int32_t
uuid_is_nil( const uuid_t *uuid, uint32_t *status);
void
uuid_to_string( const uuid_t *uuid, char **str, uint32_t *status);
void
uuid_enc_le( void *buf, const uuid_t *uuid);
void
uuid_dec_le( const void *buf, uuid_t *);
void
uuid_enc_be( void *buf, const uuid_t *uuid);
void
uuid_dec_be( const void *buf, uuid_t *);
解説
DCE 1.1 準拠 UUID 関数ファミリは、アプリケーションが一般にユニークな識別子または UUID を動作できるようにします。 uuid_create() と uuid_create_nil() 関数は、UUID を作成します。 uuid_compare(), uuid_equal() と uuid_is_nil() 関数は、UUID をテストするために使用できます。 2 進表現から文字列表現に変換するためには、またはその逆は、それぞれ uuid_to_string() または uuid_from_string() を使用します。 16 ビットのハッシュ値は、 uuid_hash() を呼び出すことによって取得することができます。uuid_to_string() 関数は、文字列を保持するために十分大きなバッファへのポインタである、 *str を設定します。このポインタは、それがもはや必要でないとき、割り付けられた記憶域を解放するために free(3) に渡されるべきです。
uuid_enc_le() と uuid_enc_be() 関数は、UUID のバイナリ表現を、それぞれリトルエンディアンとビッグエンディアンのバイト順のオクテットストリームにエンコードします。宛先バッファは、呼び出し側によってあらかじめ割り付けられていなければならなくて、16 オクテットのバイナリ UUID を保持することができるくらい大きくなければなりません。これらのルーチンは、DCE RPC API の一部ではありません。それらは、便利にするために提供されています。
uuid_dec_le() と uuid_dec_be() 関数は、オクテットストリームからの UUID を、それぞれリトルエンディアンとビッグエンディアンのバイト順序にデコードします。これらのルーチンは、DCE RPC API の一部ではありません。それらは、便利にするために提供されています。
戻り値
関数が成功したか失敗して終了したかは、 status 引数に返されます。指定できる値は、次の通りです:- uuid_s_ok
- 関数は、成功して終了しました。
- uuid_s_bad_version
- UUID には、知られているバージョンがありません。
- uuid_s_invalid_string_uuid
- UUID の文字列表現は有効ではありません。
- uuid_s_no_memory
- 関数が、UUID 表現を格納するためにメモリを割り付けることができません。
規格
UUID 関数は、DCE 1.1 RPC 仕様に適合しています。バグ
このマニュアルページは改良することができます。March 1, 2012 | FreeBSD |