Recursively converts a nested Object array into a hierarchical SECS structure, inferring SECS types based on the Java type of each leaf element.

You may use this method when your structure may contain integers, floats, doubles, longs, or strings. Each array level becomes a SecsFormat00.

Object[][] example = {
    {"abc", 123, 1.23},
    {"xyz", new Object[] { 456L, 7.89f }},
};
 
SecsFormat00 result = sf00FromNested(example);

Expected output:

[[<A 'abc'>, <I4 123>, <F8 1.23000>], [<A 'xyz'>, [<I8 456>, <F4 7.89000>]]]

/**
 * Recursively converts a nested {@code Object} (array or leaf) into a hierarchical SECS structure.
 * 
 * Arrays (including multidimensional ones) become nested {@link SecsFormat00}, and leaf elements are converted
 * to SECS types based on their Java type.
 *
 * @param data the nested Object to convert (can be an Object[], Object[][], etc.)
 * @return a {@link SecsFormat00} representation of the structure
 */
public static SecsFormat00 sf00FromNested(Object data) {
    SecsFormat00 list = new SecsFormat00();
 
    if (data instanceof Object[]) {
        for (Object element : (Object[]) data) {
            if (element instanceof Object[]) {
                list.add(sf00FromNested(element));
            } else if (element instanceof Integer) {
                list.add(new SecsFormat34((Integer) element));
            } else if (element instanceof Long) {
                list.add(new SecsFormat30((Long) element));
            } else if (element instanceof Float) {
                list.add(new SecsFormat44((Float) element));
            } else if (element instanceof Double) {
                list.add(new SecsFormat40((Double) element));
            } else {
                list.add(new SecsFormat20(String.valueOf(element)));
            }
        }
    } else {
        throw new IllegalArgumentException("Input must be an Object array at the top level");
    }
 
    return list;
}

Recursively converts a nested Object array into a SECS structure assuming all leaf elements are strings or nulls. This is better when you know the expected SecsFormat of your values because they can be defined explicitly.

String[][][] nestedStrings = {
    {
        {"A", "B"},
        {"C", "D"}
    },
    {
        {"E", "F"},
        {"G", "H"}
    }
};
 
SecsFormat00 result = sf00FromNestedStrings(nestedStrings);

Expected output:

[[[<A 'A'>, <A 'B'>], [<A 'C'>, <A 'D'>]], [[<A 'E'>, <A 'F'>], [<A 'G'>, <A 'H'>]]]

/**
 * Recursively converts a nested {@code Object} (array or leaf) into a SECS structure assuming all leaves are Strings.
 * 
 * Use this when all data is guaranteed to be Strings (or nulls), to avoid type checks.
 *
 * @param data a nested Object (e.g., {@code String[][]}, {@code String[][][]}, etc.)
 * @return a {@link SecsFormat00} structure with all leaves as {@link SecsFormat20}
 */
public static SecsFormat00 sf00FromNestedStrings(Object data) {
    SecsFormat00 list = new SecsFormat00();
 
    if (data instanceof Object[]) {
        for (Object element : (Object[]) data) {
            if (element instanceof Object[]) {
                list.add(sf00FromNestedStrings(element));
            } else {
                list.add(new SecsFormat20(String.valueOf(element)));
            }
        }
    } else {
        throw new IllegalArgumentException("Input must be an Object array at the top level");
    }
 
    return list;
}