buffer: add compare and equals methods

compare() works like String.localeCompare such that:

    Buffer.compare(a, b) === a.compare(b);

equals() does a native check to see if two buffers are equal.

Signed-off-by: Trevor Norris <trev.norris@gmail.com>

1 files changed, 25 insertions, 0 deletions

diff --git a/lib/buffer.js b/lib/buffer.js
index 6891b776f..65f488635 100644
--- a/lib/buffer.js
+++ b/lib/buffer.js
@@ -130,6 +130,15 @@ Buffer.isBuffer = function isBuffer(b) {
 };
 
 
+Buffer.compare = function compare(a, b) {
+  if (!(a instanceof Buffer) ||
+      !(b instanceof Buffer))
+    throw new TypeError('Arguments must be Buffers');
+
+  return internal.compare(b, a);
+};
+
+
 Buffer.isEncoding = function(encoding) {
   switch ((encoding + '').toLowerCase()) {
     case 'hex':
@@ -256,6 +265,14 @@ Buffer.prototype.toString = function(encoding, start, end) {
 };
 
 
+Buffer.prototype.equals = function equals(b) {
+  if (!(b instanceof Buffer))
+    throw new TypeError('Argument must be a Buffer');
+
+  return internal.compare(this, b) === 0;
+};
+
+
 // Inspect
 Buffer.prototype.inspect = function inspect() {
   var str = '';
@@ -269,6 +286,14 @@ Buffer.prototype.inspect = function inspect() {
 };
 
 
+Buffer.prototype.compare = function compare(b) {
+  if (!(b instanceof Buffer))
+    throw new TypeError('Argument must be a Buffer');
+
+  return internal.compare(this, b);
+};
+
+
 // XXX remove in v0.13
 Buffer.prototype.get = util.deprecate(function get(offset) {
   offset = ~~offset;