Joomla CMS  4.2.2
Documentation des API du CMS Joomla en version 4.2.2
Référence de l'interface UuidInterface
+ Graphe d'héritage de UuidInterface:

Fonctions membres publiques

 compareTo (UuidInterface $other)
 
 equals ($other)
 
 getBytes ()
 
 getNumberConverter ()
 
 getHex ()
 
 getFieldsHex ()
 
 getClockSeqHiAndReservedHex ()
 
 getClockSeqLowHex ()
 
 getClockSequenceHex ()
 
 getDateTime ()
 
 getInteger ()
 
 getLeastSignificantBitsHex ()
 
 getMostSignificantBitsHex ()
 
 getNodeHex ()
 
 getTimeHiAndVersionHex ()
 
 getTimeLowHex ()
 
 getTimeMidHex ()
 
 getTimestampHex ()
 
 getUrn ()
 
 getVariant ()
 
 getVersion ()
 
 toString ()
 

Description détaillée

UuidInterface defines common functionality for all universally unique identifiers (UUIDs)

Documentation des fonctions membres

◆ compareTo()

compareTo ( UuidInterface  $other)

Compares this UUID to the specified UUID.

The first of two UUIDs is greater than the second if the most significant field in which the UUIDs differ is greater for the first UUID.

  • Q. What's the value of being able to sort UUIDs?
  • A. Use them as keys in a B-Tree or similar mapping.
Paramètres
UuidInterface$otherUUID to which this UUID is compared
Renvoie
int -1, 0 or 1 as this UUID is less than, equal to, or greater than $uuid

Implémenté dans Uuid.

◆ equals()

equals (   $other)

Compares this object to the specified object.

The result is true if and only if the argument is not null, is a UUID object, has the same variant, and contains the same value, bit for bit, as this UUID.

Paramètres
object$other
Renvoie
bool True if $other is equal to this UUID

Implémenté dans Uuid.

◆ getBytes()

getBytes ( )

Returns the UUID as a 16-byte string (containing the six integer fields in big-endian byte order).

Renvoie
string

Implémenté dans Uuid.

◆ getClockSeqHiAndReservedHex()

getClockSeqHiAndReservedHex ( )

Returns the high field of the clock sequence multiplexed with the variant (bits 65-72 of the UUID).

Renvoie
string Hexadecimal value of clock_seq_hi_and_reserved

Implémenté dans Uuid.

◆ getClockSeqLowHex()

getClockSeqLowHex ( )

Returns the low field of the clock sequence (bits 73-80 of the UUID).

Renvoie
string Hexadecimal value of clock_seq_low

Implémenté dans Uuid.

◆ getClockSequenceHex()

getClockSequenceHex ( )

Returns the clock sequence value associated with this UUID.

Renvoie
string Hexadecimal value of clock sequence

Implémenté dans Uuid.

◆ getDateTime()

getDateTime ( )

Returns a PHP DateTime object representing the timestamp associated with this UUID.

The timestamp value is only meaningful in a time-based UUID, which has version type 1. If this UUID is not a time-based UUID then this method throws UnsupportedOperationException.

Renvoie
DateTime A PHP DateTime representation of the date
Exceptions
UnsupportedOperationExceptionIf this UUID is not a version 1 UUID
UnsatisfiedDependencyExceptionif called in a 32-bit system and Moontoast\Math\BigNumber is not present

Implémenté dans Uuid, et DegradedUuid.

◆ getFieldsHex()

getFieldsHex ( )

Returns an array of the fields of this UUID, with keys named according to the RFC 4122 names for the fields.

  • time_low: The low field of the timestamp, an unsigned 32-bit integer
  • time_mid: The middle field of the timestamp, an unsigned 16-bit integer
  • time_hi_and_version: The high field of the timestamp multiplexed with the version number, an unsigned 16-bit integer
  • clock_seq_hi_and_reserved: The high field of the clock sequence multiplexed with the variant, an unsigned 8-bit integer
  • clock_seq_low: The low field of the clock sequence, an unsigned 8-bit integer
  • node: The spatially unique node identifier, an unsigned 48-bit integer
Renvoie
array The UUID fields represented as hexadecimal values

Implémenté dans Uuid.

Référencé par TimestampFirstCombCodec\encode(), GuidStringCodec\encode(), StringCodec\encode(), OrderedTimeCodec\encodeBinary(), et GuidStringCodec\encodeBinary().

◆ getHex()

getHex ( )

Returns the hexadecimal value of the UUID.

Renvoie
string

Implémenté dans Uuid.

Référencé par StringCodec\encodeBinary().

◆ getInteger()

getInteger ( )

Returns the integer value of the UUID, converted to an appropriate number representation.

Renvoie
mixed Converted representation of the unsigned 128-bit integer value
Exceptions
UnsatisfiedDependencyExceptionif Moontoast\Math\BigNumber is not present

Implémenté dans Uuid.

◆ getLeastSignificantBitsHex()

getLeastSignificantBitsHex ( )

Returns the least significant 64 bits of this UUID's 128 bit value.

Renvoie
string Hexadecimal value of least significant bits

Implémenté dans Uuid.

Référencé par Uuid\compareTo().

◆ getMostSignificantBitsHex()

getMostSignificantBitsHex ( )

Returns the most significant 64 bits of this UUID's 128 bit value.

Renvoie
string Hexadecimal value of most significant bits

Implémenté dans Uuid.

Référencé par Uuid\compareTo().

◆ getNodeHex()

getNodeHex ( )

Returns the node value associated with this UUID

For UUID version 1, the node field consists of an IEEE 802 MAC address, usually the host address. For systems with multiple IEEE 802 addresses, any available one can be used. The lowest addressed octet (octet number 10) contains the global/local bit and the unicast/multicast bit, and is the first octet of the address transmitted on an 802.3 LAN.

For systems with no IEEE address, a randomly or pseudo-randomly generated value may be used; see RFC 4122, Section 4.5. The multicast bit must be set in such addresses, in order that they will never conflict with addresses obtained from network cards.

For UUID version 3 or 5, the node field is a 48-bit value constructed from a name as described in RFC 4122, Section 4.3.

For UUID version 4, the node field is a randomly or pseudo-randomly generated 48-bit value as described in RFC 4122, Section 4.4.

Renvoie
string Hexadecimal value of node http://tools.ietf.org/html/rfc4122#section-4.1.6

Implémenté dans Uuid.

◆ getNumberConverter()

getNumberConverter ( )

Returns the number converter to use for converting hex values to/from integers.

Renvoie
NumberConverterInterface

Implémenté dans Uuid.

◆ getTimeHiAndVersionHex()

getTimeHiAndVersionHex ( )

Returns the high field of the timestamp multiplexed with the version number (bits 49-64 of the UUID).

Renvoie
string Hexadecimal value of time_hi_and_version

Implémenté dans Uuid.

◆ getTimeLowHex()

getTimeLowHex ( )

Returns the low field of the timestamp (the first 32 bits of the UUID).

Renvoie
string Hexadecimal value of time_low

Implémenté dans Uuid.

◆ getTimeMidHex()

getTimeMidHex ( )

Returns the middle field of the timestamp (bits 33-48 of the UUID).

Renvoie
string Hexadecimal value of time_mid

Implémenté dans Uuid.

◆ getTimestampHex()

getTimestampHex ( )

Returns the timestamp value associated with this UUID.

The 60 bit timestamp value is constructed from the time_low, time_mid, and time_hi fields of this UUID. The resulting timestamp is measured in 100-nanosecond units since midnight, October 15, 1582 UTC.

The timestamp value is only meaningful in a time-based UUID, which has version type 1. If this UUID is not a time-based UUID then this method throws UnsupportedOperationException.

Renvoie
string Hexadecimal value of the timestamp
Exceptions
UnsupportedOperationExceptionIf this UUID is not a version 1 UUID http://tools.ietf.org/html/rfc4122#section-4.1.4

Implémenté dans Uuid.

◆ getUrn()

getUrn ( )

Returns the string representation of the UUID as a URN.

Renvoie
string http://en.wikipedia.org/wiki/Uniform_Resource_Name

Implémenté dans Uuid.

◆ getVariant()

getVariant ( )

Returns the variant number associated with this UUID.

The variant number describes the layout of the UUID. The variant number has the following meaning:

  • 0 - Reserved for NCS backward compatibility
  • 2 - The RFC 4122 variant (used by this class)
  • 6 - Reserved, Microsoft Corporation backward compatibility
  • 7 - Reserved for future definition
Renvoie
int http://tools.ietf.org/html/rfc4122#section-4.1.1

Implémenté dans Uuid.

◆ getVersion()

getVersion ( )

Returns the version number associated with this UUID.

The version number describes how this UUID was generated and has the following meaning:

  • 1 - Time-based UUID
  • 2 - DCE security UUID
  • 3 - Name-based UUID hashed with MD5
  • 4 - Randomly generated UUID
  • 5 - Name-based UUID hashed with SHA-1

Returns null if this UUID is not an RFC 4122 variant, since version is only meaningful for this variant.

Renvoie
int|null http://tools.ietf.org/html/rfc4122#section-4.1.3

Implémenté dans Uuid.

◆ toString()

toString ( )

Converts this UUID into a string representation.

Renvoie
string

Implémenté dans Uuid.


La documentation de cette interface a été générée à partir du fichier suivant :