readStringUntil()

bool fl::readStringUntil	(	sstream &	out,
		char	delimiter,
		char	skipChar,
		fl::optional< u32 >	timeoutMs )

Definition at line 140 of file cstdio.cpp.hpp.

                                                                                                          {
    // Follows Arduino Serial.readStringUntil() API - blocks until delimiter
    // found. Like Arduino's timedRead(), the timeout measures inactivity: it
    // restarts on every received byte, so a long line arriving steadily over
    // a slow link is not discarded midway (FastLED #4893).
    u32 startTime = fl::millis();
 
    // Read characters until we find delimiter or timeout
    while (true) {
        // Check timeout (only if timeout is set)
        if (timeoutMs.has_value()) {
            if (fl::millis() - startTime >= timeoutMs.value()) {
                // Timeout occurred
                return false;
            }
        }
 
        // Try to read next character
        int c = read();
 
        // Handle -1 (no data available) like Arduino's timedRead():
        // Keep trying until timeout (or forever if no timeout set)
        if (c == -1) {
            // Brief 1us yield to prevent busy loop without the 1ms
            // minimum sleep that fl::delay(1) imposes on FreeRTOS
            // (vTaskDelay(1) = 1 tick = 1ms). The 1ms delay was too
            // slow for USB CDC multi-packet assembly (64-byte packets).
            fl::delayMicroseconds(1);
            continue;
        }
 
        startTime = fl::millis();
 
        // Found delimiter - complete
        if (c == delimiter) {
            break;
        }
 
        // Skip specified character (e.g., '\r' for cross-platform line endings)
        if (c == skipChar) {
            continue;
        }
 
        // Valid character - add to output stream
        out << static_cast<char>(c);
    }
 
    // Successfully read until delimiter
    return true;
}

References delayMicroseconds(), FL_NO_EXCEPT, millis(), and read().

Referenced by readLine().

Here is the call graph for this function:

Here is the caller graph for this function: