Examples: Utility Functions

This page shows practical examples for using utility functions in HypnoScript. The examples are commented and can be used directly or adapted.

Dynamic Type Conversion and Validation

Focus {
    entrance {
        induce input = "42";
        induce n = ToNumber(input);
        if (IsNumber(n)) {
            observe "Entered number: " + n;
        } else {
            observe "Invalid input!";
        }
    }
} Relax;

Random Selection and Shuffling

Focus {
    entrance {
        induce names = ["Anna", "Ben", "Carla", "Dieter"];
        induce winner = Sample(names, 1);
        observe "Winner: " + winner;
        induce shuffled = Shuffle(names);
        observe "Random order: " + shuffled;
    }
} Relax;

Time Measurement and Sleep

Focus {
    entrance {
        induce start = Timestamp();
        Sleep(500); // 0.5 seconds wait
        induce end = Timestamp();
        observe "Duration: " + (end - start) + " seconds";
    }
} Relax;

Array Transformations

Focus {
    entrance {
        induce numbers = [1,2,3,4,5,2,3,4];
        induce unique = Unique(numbers);
        observe "Without duplicates: " + unique;
        induce sorted = Sort(unique);
        observe "Sorted: " + sorted;
        induce paired = Zip(unique, ["a","b","c","d","e"]);
        observe "Paired: " + paired;
    }
} Relax;

Error Handling with Try

Focus {
    suggestion safeDivide(a, b) {
        awaken Try(a / b, "Error: Division by zero");
    }
    entrance {
        observe safeDivide(10, 2); // 5
        observe safeDivide(10, 0); // "Error: Division by zero"
    }
} Relax;

JSON Parsing and Generation

Focus {
    entrance {
        induce jsonString = '{"name": "Max", "age": 30}';
        induce obj = ParseJSON(jsonString);
        observe "Name: " + obj.name;
        observe "Age: " + obj.age;

        induce arr = [1,2,3];
        induce jsonArr = StringifyJSON(arr);
        observe "JSON array: " + jsonArr;
    }
} Relax;

Range and Repeat

Focus {
    entrance {
        induce r = Range(1, 5);
        observe "Range: " + r; // [1,2,3,4,5]
        induce rep = Repeat("A", 3);
        observe "Repeat: " + rep; // ["A","A","A"]
    }
} Relax;

Combined Utility Workflows

Focus {
    entrance {
        // Validate and process input
        induce input = "15";
        induce n = ToNumber(input);
        if (IsNumber(n) && n > 10) {
            observe "Input is a number > 10: " + n;
        } else {
            observe "Invalid or too small number!";
        }

        // Random selection from range
        induce numbers = Range(1, 100);
        induce randomSample = Sample(numbers, 5);
        observe "5 random numbers: " + randomSample;

        // Combine array transformations
        induce arr = [1,2,2,3,4,4,5];
        induce clean = Sort(Unique(arr));
        observe "Sorted & unique: " + clean;
    }
} Relax;

---

See also:

• Utility Functions Reference
• System Functions Examples