rfc:pack_unpack_64bit_formats

64 bit format codes for pack() and unpack()

Introduction

pack() and unpack() do not currently support format codes for converting data to and from 64 bit integers.

The purpose of this RFC is:

  • Adding Perl-compatible format codes for native-endian integer conversion.
  • Introducing Perl-incompatible format codes for endian specific integer conversion.

Proposal

Pack and unpack are functions inspired by Perl which uses the format codes “q” and “Q” to represent native-endian signed and unsigned 64 bit integers.

q - signed long long (always 64 bit, machine byte order)
Q - unsigned long long (always 64 bit, machine byte order)

Perl does not have format codes that can be used to specify endianness however for consistency with PHPs current 32 bit format codes it would be a good idea to introduce codes for these as well.

The letters “J” and “P” have been selected because they already exist in Perl but their function does translate to PHP.

J is for Perl internal integer values and P is for a pointer to a structure. Both of these are things that make no sense in PHP.

J - unsigned long long (always 64 bit, big endian byte order)
P - unsigned long long (always 64 bit, little endian byte order)

They are ordered such that J < P in the same way that N < V to make it intuitive for developers to remember what the codes mean.

No codes have been planned for endian specific signed values as PHP does not currently have these for 32 bit systems. The “i” and “I” codes exist, but these are documented as platform-dependant sized integers.

On 32 bit builds (with the current patch) these format codes are unavailable and will result in the same warning as usual for invalid format codes.

Backward Incompatible Changes

None.

Proposed PHP Version(s)

PHP 5.6

RFC Impact

To SAPIs

All SAPIs are affected equally, gaining access to the new format codes.

To Existing Extensions

No impact

To Opcache

No impact - the only change is to the format string which can be cached the same as before.

New Constants

None

Open Issues

Nothing brought up during discussion phase

Unaffected PHP Functionality

The change is constrained to (un)pack, there is not a lot of scope for this to affect any existing functionality, and tests indicate that nothing is measurably broken/

Vote

50%+1 majority as no core language changes are being made.

Voting begins: 2014-09-26

Voting ends: 2014-10-03

64 bit format codes for pack() and unpack()
Real name Yes No
aharvey (aharvey)  
ajf (ajf)  
auroraeosrose (auroraeosrose)  
daverandom (daverandom)  
derick (derick)  
dmitry (dmitry)  
fmk (fmk)  
jedibc (jedibc)  
kalle (kalle)  
klaussilveira (klaussilveira)  
krakjoe (krakjoe)  
leigh (leigh)  
lstrojny (lstrojny)  
ralphschindler (ralphschindler)  
rasmus (rasmus)  
Final result: 15 0
This poll has been closed.

Patches and Tests

PR 812 on Github

I consider this patch final unless issues with the implementation are raised.

Implementation

References

rfc/pack_unpack_64bit_formats.txt · Last modified: 2017/09/22 13:28 by 127.0.0.1