StrToI64

Documentation

API Reference

StrToI64

Description

Convert string to signed 64-bit integer

Parameters

Name	Direction	Description
`str`	in	String to convert
`value`	out	Where to store the result
`config`	in	Parse configuration (NULL for auto-detect base)

Success

Returns true and stores result in value

Failure

Returns false if conversion fails

Usage example (Cross-references)

Usage examples (Cross-references)

In Io.c:2291:

        // Use base 0 to let strtoul detect the base from prefix
        i64 val;
        if (!StrToI64(&temp, &val, NULL)) {
            LOG_ERROR("Failed to parse i8");
            StrDeinit(&temp);

In Io.c:2366:

        // Use base 0 to let strtoul detect the base from prefix
        i64 val;
        if (!StrToI64(&temp, &val, NULL)) {
            LOG_ERROR("Failed to parse i16");
            StrDeinit(&temp);

In Io.c:2441:

        // Use base 0 to let strtoul detect the base from prefix
        i64 val;
        if (!StrToI64(&temp, &val, NULL)) {
            LOG_ERROR("Failed to parse i32");
            StrDeinit(&temp);

In Io.c:2515:

    
        // Use base 0 to let strtoul detect the base from prefix
        if (!StrToI64(&temp, v, NULL)) {
            LOG_ERROR("Failed to parse i64");
            StrDeinit(&temp);

In Str.c:658:

    }
    
    bool StrToI64(const Str *str, i64 *value, const StrParseConfig *config) {
        ValidateStr(str);

In Str.Convert.c:286:

    // Test StrToI64 function
    bool test_str_to_i64(void) {
        WriteFmt("Testing StrToI64\n");
    
        // Test positive decimal conversion

In Str.Convert.c:291:

        Str  s       = StrInitFromZstr("12345");
        i64  value   = 0;
        bool success = StrToI64(&s, &value, NULL);
        bool result  = (success && value == 12345);

In Str.Convert.c:297:

        StrDeinit(&s);
        s       = StrInitFromZstr("-12345");
        success = StrToI64(&s, &value, NULL);
        result  = result && (success && value == -12345);

In Str.Convert.c:303:

        StrDeinit(&s);
        s       = StrInitFromZstr("0xABCD");
        success = StrToI64(&s, &value, NULL);
        result  = result && (success && value == 0xABCD);

In Str.Convert.c:309:

        StrDeinit(&s);
        s       = StrInitFromZstr("0b101010");
        success = StrToI64(&s, &value, NULL);
        result  = result && (success && value == 42);

In Str.Convert.c:315:

        StrDeinit(&s);
        s       = StrInitFromZstr("0");
        success = StrToI64(&s, &value, NULL);
        result  = result && (success && value == 0);

In Str.Convert.c:321:

        StrDeinit(&s);
        s       = StrInitFromZstr("not a number");
        success = StrToI64(&s, &value, NULL);
        result  = result && (!success);

In Str.Convert.c:440:

            StrFromI64(&s, i64_values[i], &config);
            i64  recovered_i64 = 0;
            bool success       = StrToI64(&s, &recovered_i64, NULL);
            result             = result && success && (recovered_i64 == i64_values[i]);

In Str.Convert.c:507:

        StrFromI64(&s, INT64_MIN + 1, &config);
        i64 recovered_min = 0;
        success           = StrToI64(&s, &recovered_min, NULL);
        result            = result && success && (recovered_min == INT64_MIN + 1);

Last updated on April 20, 2026

StrToF64 StrToU64