Function validate_newPauliStrSumParams

quest/src/core/validation.cpp:3242–3263

 */

void validate_newPauliStrSumParams(qindex numTerms, const char* caller) {

    assertThat(numTerms > 0, report::NEW_PAULI_STR_SUM_NON_POSITIVE_NUM_STRINGS, {{"${NUM_TERMS}", numTerms}}, caller);

    // attempt to fetch RAM, and simply return if we fail; if we unknowingly
    // didn't have enough RAM, then alloc validation will trigger later
    size_t memPerNode = 0;
    try {
        memPerNode = mem_tryGetLocalRamCapacityInBytes();
    } catch(mem::COULD_NOT_QUERY_RAM e) {
        return;
    }

    // pedantically check whether the PauliStrSum fits in memory. This seems
    // ridiculous/pointless because the user is expected to have already prepared
    // data of an equivalent size (which is passed), but checking means we catch
    // when the user has passed an erroneous 'numTerms' which is way too large,
    // avoiding a seg fault

    bool fits = mem_canPauliStrSumFitInMemory(numTerms, memPerNode);
    assertThat(fits, report::NEW_PAULI_STR_SUM_CANNOT_FIT_INTO_CPU_MEM, {{"${NUM_TERMS}", numTerms}, {"${NUM_BYTES}", memPerNode}}, caller);
}

void validate_newPauliStrSumMatchingListLens(qindex numStrs, qindex numCoeffs, const char* caller) {