feat: add Strings.toBinary()

Author: sebthom

CHANGELOG.md

@@ -8,19 +8,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- `Strings.toBinary()`
+
 
 ## [7.0.7] - 2025-10-18
 
 ### Fixed
 - Improve compatibility with Haxe 5
-- Wrong AnyAsString type path in String8Generator
-- StringBuilder.OutputWrapper.flush does not null buffer as expected
-- Rename Char.TRHEE to THREE
-- Swapped line/column stored in CharIterator's prev buffer
-- Pattern does not auto-apply UTF-8 'u' flag to underlying EReg
-- Strings.splitLines(null) does not return null
-- internal RingBuffer.get() can return wrong or uninitialized items due to bad indexing
-- StringBuilder length not updated when adding null values
+- Wrong `AnyAsString` type path in `String8Generator`
+- `StringBuilder.OutputWrapper.flush` does not null buffer as expected
+- Rename `Char.TRHEE` to `THREE`
+- Swapped line/column stored in `CharIterator`'s prev buffer
+- Pattern does not auto-apply UTF-8 'u' flag to underlying `EReg`
+- `Strings.splitLines(null)` does not return `null`
+- internal `RingBuffer.get()` can return wrong or uninitialized items due to bad indexing
+- `StringBuilder` length not updated when adding null values
 - UTF8 handling in some Strings functions is broken
 
 

src/hx/strings/Strings.hx

@@ -3578,6 +3578,65 @@ class Strings {
    }
 
 
+   /**
+    * Static extension for <code>Int</code>.
+    *
+    * <pre><code>
+    * >>> Strings.toBinary(1)            == "1"
+    * >>> Strings.toBinary(2)            == "10"
+    * >>> Strings.toBinary(10)           == "1010"
+    * >>> Strings.toBinary(10, 8)        == "00001010"
+    * >>> Strings.toBinary(255)          == "11111111"
+    * >>> Strings.toBinary(-1)           == "11111111111111111111111111111111"
+    * >>> Strings.toBinary(-10, 8)       == "11110110"
+    * </code></pre>
+    *
+    * @param minDigits the resulting string is left padded with <code>0</code> until it length equals <code>minDigits</code>
+    * @return the binary representation of <b>num</b>
+    */
+   public static function toBinary(num:Int, ?minDigits:Int):String {
+       var result:String;
+
+       #if cs
+       result = cs.system.Convert.ToString(num, 2);
+       #elseif java
+       result = java.lang.Integer.toBinaryString(num);
+       #elseif js
+       result = untyped (num >>> 0).toString(2);
+       #elseif php
+       // Force 32-bit two's complement for negatives, then decbin
+       result = (php.Syntax.code("decbin({0} & 0xFFFFFFFF)", num) : String);
+       #elseif python
+       // Keep 32-bit two's complement for negatives (match other targets)
+       result = python.Syntax.code("format({0} & 0xFFFFFFFF, 'b')", num);
+       #else
+       if (num == 0) {
+          result = "0";
+       } else {
+          var bits = new Array<String>();
+          var v = num;
+          // Logical shift to shrink even negative ints to 0 in 32 steps
+          while (v != 0) {
+             bits.push(((v & 1) != 0) ? "1" : "0");
+             v >>>= 1;
+          }
+          bits.reverse();
+          result = bits.join("");
+       }
+       #end
+
+       if (minDigits != null) {
+           // For negatives we want the rightmost minDigits bits (trim leading ones from 32-bit form)
+           if (num < 0 && result.length > minDigits) {
+               result = result.substr(result.length - minDigits);
+           }
+           // Then pad with zeros on the left if still shorter
+           result = StringTools.lpad(result, "0", minDigits);
+       }
+       return result;
+   }
+
+
    /**
     * Static extension for <code>Int</code>.
     *

tools/_test-prepare.cmd

@@ -30,8 +30,6 @@ for %%i in (haxe-doctest) do (
    )
 )
 
-goto :eof
-
 REM install additional libs
 :iterate