speedtest/utils.h

/*
 * Copyright 2016 Google Inc. All rights reserved.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef SPEEDTEST_UTILS_H
#define SPEEDTEST_UTILS_H

#include <string>

namespace speedtest {

// Return relative time in microseconds
// This isn't convertible to an absolute date and time
long SystemTimeMicros();

// Return a string representation of n
std::string to_string(long n);

// Round a double to a minimum number of significant digits
std::string round(double d, int digits);

// Return 1 - (shorter / larger)
double variance(double d1, double d2);

// Convert bytes and time in micros to speed in megabits
double ToMegabits(long bytes, long micros);

// Parse an int.
// If successful, write result to result and return true.
// If result is null or the int can't be parsed, return false.
bool ParseInt(const std::string &str, int *result);

// Trim from start in place
// Caller retains ownership
void LeftTrim(std::string *s);

// Trim from end in place
// Caller retains ownership
void RightTrim(std::string *s);

// Trim from both ends in place
// Caller retains ownership
void Trim(std::string *s);

}  // namespace speedtst

#endif  // SPEEDTEST_UTILS_H