feat: convert any value to a boolean

Safe-DS · May 2, 2024 · 9dc28db · 9dc28db
1 parent 6f7100d
commit 9dc28db
Show file tree

Hide file tree

Showing 11 changed files with 73 additions and 35 deletions.
diff --git a/docs/api/safeds/lang/Any.md b/docs/api/safeds/lang/Any.md
@@ -12,6 +12,13 @@ The common superclass of all classes.
     ```sds linenums="6"
     class Any {
 
+        /**
+         * Return whether the object is truthy.
+         */
+        @Pure
+        @PythonMacro("bool($this)")
+        fun toBoolean() -> boolean: Boolean
+
         /**
          * Return a string representation of the object.
          *
@@ -26,6 +33,24 @@ The common superclass of all classes.
     }
     ```
 
+## `#!sds fun` toBoolean {#safeds.lang.Any.toBoolean data-toc-label='toBoolean'}
+
+Return whether the object is truthy.
+
+**Results:**
+
+| Name | Type | Description |
+|------|------|-------------|
+| `boolean` | [`Boolean`][safeds.lang.Boolean] | - |
+
+??? quote "Stub code in `coreClasses.sdsstub`"
+
+    ```sds linenums="11"
+    @Pure
+    @PythonMacro("bool($this)")
+    fun toBoolean() -> boolean: Boolean
+    ```
+
 ## `#!sds fun` toString {#safeds.lang.Any.toString data-toc-label='toString'}
 
 Return a string representation of the object.
@@ -46,7 +71,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="16"
+    ```sds linenums="23"
     @Pure
     @PythonMacro("str($this)")
     fun toString() -> string: String

diff --git a/docs/api/safeds/lang/Boolean.md b/docs/api/safeds/lang/Boolean.md
@@ -22,6 +22,6 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="39"
+    ```sds linenums="46"
     class Boolean
     ```
diff --git a/docs/api/safeds/lang/Float.md b/docs/api/safeds/lang/Float.md
@@ -19,7 +19,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="77"
+    ```sds linenums="84"
     class Float sub Number {
 
         /**
@@ -56,7 +56,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="87"
+    ```sds linenums="94"
     @Pure
     @PythonMacro("int($this)")
     fun toInt() -> int: Int

diff --git a/docs/api/safeds/lang/Int.md b/docs/api/safeds/lang/Int.md
@@ -19,7 +19,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="54"
+    ```sds linenums="61"
     class Int sub Number {
 
         /**
@@ -56,7 +56,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="64"
+    ```sds linenums="71"
     @Pure
     @PythonMacro("float($this)")
     fun toFloat() -> float: Float

diff --git a/docs/api/safeds/lang/List.md b/docs/api/safeds/lang/List.md
@@ -23,7 +23,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="100"
+    ```sds linenums="107"
     class List<out E> {
 
         /**
@@ -103,7 +103,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="115"
+    ```sds linenums="122"
     @Pure
     @PythonMacro("$separator.join($this)")
     fun join(separator: String = ", ") -> string: String
@@ -129,7 +129,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="142"
+    ```sds linenums="149"
     @Pure
     @PythonMacro("len($this)")
     fun size() -> size: Int
@@ -162,7 +162,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="130"
+    ```sds linenums="137"
     @Pure
     @PythonMacro("$this[$start:$end]")
     fun slice(start: Int = 0, end: Int = this.size()) -> slice: List<E>

diff --git a/docs/api/safeds/lang/Map.md b/docs/api/safeds/lang/Map.md
@@ -28,7 +28,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="159"
+    ```sds linenums="166"
     class Map<K, out V> {
 
         /**
@@ -109,7 +109,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="191"
+    ```sds linenums="198"
     @Pure
     @PythonMacro("list($this.keys())")
     fun keys() -> keys: List<K>
@@ -140,7 +140,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="174"
+    ```sds linenums="181"
     @Pure
     @PythonMacro("len($this)")
     fun size() -> size: Int
@@ -171,7 +171,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="208"
+    ```sds linenums="215"
     @Pure
     @PythonMacro("list($this.values())")
     fun values() -> values: List<V>

diff --git a/docs/api/safeds/lang/Nothing.md b/docs/api/safeds/lang/Nothing.md
@@ -9,6 +9,6 @@ The common subclass of all classes.
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="24"
+    ```sds linenums="31"
     class Nothing
     ```
diff --git a/docs/api/safeds/lang/Number.md b/docs/api/safeds/lang/Number.md
@@ -14,6 +14,6 @@ A number.
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="44"
+    ```sds linenums="51"
     class Number
     ```
diff --git a/docs/api/safeds/lang/String.md b/docs/api/safeds/lang/String.md
@@ -17,7 +17,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="221"
+    ```sds linenums="228"
     class String {
 
         /**
@@ -296,7 +296,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="243"
+    ```sds linenums="250"
     @Pure
     @PythonMacro("$substring in $this")
     fun contains(substring: String) -> contains: Boolean
@@ -328,7 +328,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="255"
+    ```sds linenums="262"
     @Pure
     @PythonMacro("$this.endswith($suffix)")
     fun endsWith(suffix: String) -> endsWith: Boolean
@@ -360,7 +360,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="294"
+    ```sds linenums="301"
     @Pure
     @PythonMacro("$this.find($substring)")
     fun indexOf(substring: String) -> index: Int
@@ -392,7 +392,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="306"
+    ```sds linenums="313"
     @Pure
     @PythonMacro("$this.rfind($substring)")
     fun lastIndexOf(substring: String) -> index: Int
@@ -418,7 +418,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="231"
+    ```sds linenums="238"
     @Pure
     @PythonMacro("len($this)")
     fun length() -> length: Int
@@ -450,7 +450,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="330"
+    ```sds linenums="337"
     @Pure
     @PythonMacro("$this * $n")
     fun repeat(n: Int) -> repeatedString: String
@@ -483,7 +483,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="318"
+    ```sds linenums="325"
     @Pure
     @PythonMacro("$this.replace($old, $new)")
     fun replace(old: String, new: String) -> replacedString: String
@@ -515,7 +515,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="342"
+    ```sds linenums="349"
     @Pure
     @PythonMacro("$this.split($separator)")
     fun split(separator: String) -> parts: List<String>
@@ -547,7 +547,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="267"
+    ```sds linenums="274"
     @Pure
     @PythonMacro("$this.startswith($prefix)")
     fun startsWith(prefix: String) -> startsWith: Boolean
@@ -580,7 +580,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="282"
+    ```sds linenums="289"
     @Pure
     @PythonMacro("$this[$start:$end]")
     fun substring(start: Int = 0, end: Int = this.length()) -> substring: String
@@ -614,7 +614,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="398"
+    ```sds linenums="405"
     @Pure
     @PythonMacro("$this.casefold()")
     fun toCasefolded() -> casefolded: String
@@ -640,7 +640,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="448"
+    ```sds linenums="455"
     @Pure
     @PythonMacro("float($this)")
     fun toFloat() -> float: Float
@@ -677,7 +677,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="467"
+    ```sds linenums="474"
     @Pure
     @PythonMacro("int($this, $base)")
     fun toInt(base: Int = 10) -> int: Int
@@ -710,7 +710,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="417"
+    ```sds linenums="424"
     @Pure
     @PythonMacro("$this.lower()")
     fun toLowercase() -> lowercase: String
@@ -743,7 +743,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="436"
+    ```sds linenums="443"
     @Pure
     @PythonMacro("$this.upper()")
     fun toUppercase() -> uppercase: String
@@ -769,7 +769,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="354"
+    ```sds linenums="361"
     @Pure
     @PythonMacro("$this.strip()")
     fun trim() -> trimmed: String
@@ -795,7 +795,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="378"
+    ```sds linenums="385"
     @Pure
     @PythonMacro("$this.rstrip()")
     fun trimEnd() -> trimmed: String
@@ -821,7 +821,7 @@ pipeline example {
 
 ??? quote "Stub code in `coreClasses.sdsstub`"
 
-    ```sds linenums="366"
+    ```sds linenums="373"
     @Pure
     @PythonMacro("$this.lstrip()")
     fun trimStart() -> trimmed: String

diff --git a/packages/safe-ds-lang/src/resources/builtins/safeds/lang/coreClasses.sdsstub b/packages/safe-ds-lang/src/resources/builtins/safeds/lang/coreClasses.sdsstub
@@ -5,6 +5,13 @@ package safeds.lang
  */
 class Any {
 
+    /**
+     * Return whether the object is truthy.
+     */
+    @Pure
+    @PythonMacro("bool($this)")
+    fun toBoolean() -> boolean: Boolean
+
     /**
      * Return a string representation of the object.
      *

diff --git a/packages/safe-ds-lang/tests/resources/generation/python/macros/any/input.sdsdev b/packages/safe-ds-lang/tests/resources/generation/python/macros/any/input.sdsdev
@@ -0,0 +1,6 @@
+package tests.generation.python.macros.strings
+
+pipeline myPipeline {
+    val toBoolean = "Hello, world!".toBoolean();
+    val toString = "Hello, world!".toString();
+}