1 /* 2 * Copyright (c) 2017 The WebRTC project authors. All Rights Reserved. 3 * 4 * Use of this source code is governed by a BSD-style license 5 * that can be found in the LICENSE file in the root of the source 6 * tree. An additional intellectual property rights grant can be found 7 * in the file PATENTS. All contributing project authors may 8 * be found in the AUTHORS file in the root of the source tree. 9 */ 10 11 #ifndef API_RTC_EVENT_LOG_OUTPUT_H_ 12 #define API_RTC_EVENT_LOG_OUTPUT_H_ 13 14 #include <string> 15 16 #include "absl/strings/string_view.h" 17 18 namespace webrtc { 19 20 // NOTE: This class is still under development and may change without notice. 21 class RtcEventLogOutput { 22 public: 23 virtual ~RtcEventLogOutput() = default; 24 25 // An output normally starts out active, though that might not always be 26 // the case (e.g. failed to open a file for writing). 27 // Once an output has become inactive (e.g. maximum file size reached), it can 28 // never become active again. 29 virtual bool IsActive() const = 0; 30 31 // Write encoded events to an output. Returns true if the output was 32 // successfully written in its entirety. Otherwise, no guarantee is given 33 // about how much data was written, if any. The output sink becomes inactive 34 // after the first time `false` is returned. Write() may not be called on 35 // an inactive output sink. 36 virtual bool Write(absl::string_view output) = 0; 37 38 // Indicates that buffers should be written to disk if applicable. Flush()39 virtual void Flush() {} 40 }; 41 42 } // namespace webrtc 43 44 #endif // API_RTC_EVENT_LOG_OUTPUT_H_ 45