fml::paths Namespace Reference

Functions
std::string	JoinPaths (std::initializer_list< std::string > components)
std::string	SanitizeURIEscapedCharacters (const std::string &str)
std::pair< bool, std::string >	GetExecutableDirectoryPath ()
std::pair< bool, std::string >	GetExecutablePath ()
fml::UniqueFD	GetCachesDirectory ()
std::string	AbsolutePath (const std::string &path)
std::string	GetDirectoryName (const std::string &path)
std::string	FromURI (const std::string &uri)
void	InitializeAndroidCachesPath (std::string caches_path)

Variables
static std::string	gCachesPath

Function Documentation

AbsolutePath()

std::string fml::paths::AbsolutePath

(

const std::string &

path

)

Definition at line 29 of file paths_posix.cc.

                                              {
  if (!path.empty()) {
    if (path[0] == '/') {
      // Path is already absolute.
      return path;
    }
    return GetCurrentDirectory() + "/" + path;
  } else {
    // Path is empty.
    return GetCurrentDirectory();
  }
}

References GetCurrentDirectory.

Referenced by flutter::RunTester(), and TEST().

FromURI()

std::string fml::paths::FromURI

(

const std::string &

uri

)

Definition at line 53 of file paths_posix.cc.

                                        {
  if (uri.substr(0, kFileURLPrefixLength) != kFileURLPrefix) {
    return uri;
  }
 
  std::string file_path = uri.substr(kFileURLPrefixLength);
  return SanitizeURIEscapedCharacters(file_path);
}

References SanitizeURIEscapedCharacters().

GetCachesDirectory()

fml::UniqueFD fml::paths::GetCachesDirectory

(

)

Definition at line 22 of file paths_android.cc.

                                 {
  // If the caches path is not initialized, the FD will be invalid and caching
  // will be disabled throughout the system.
  return OpenDirectory(gCachesPath.c_str(), false, fml::FilePermission::kRead);
}

References gCachesPath, fml::kRead, and fml::OpenDirectory().

Referenced by impeller::interop::ContextVK::Create(), flutter::CreateImpellerContext(), and impeller::PlaygroundImplVK::PlaygroundImplVK().

GetDirectoryName()

std::string fml::paths::GetDirectoryName

(

const std::string &

path

)

Definition at line 42 of file paths_posix.cc.

                                                  {
  size_t separator = path.rfind('/');
  if (separator == 0u) {
    return "/";
  }
  if (separator == std::string::npos) {
    return std::string();
  }
  return path.substr(0, separator);
}

Referenced by GetExecutableDirectoryPath().

GetExecutableDirectoryPath()

std::pair< bool, std::string > fml::paths::GetExecutableDirectoryPath

(

)

Definition at line 55 of file paths.cc.

                                                      {
  auto path = GetExecutablePath();
  if (!path.first) {
    return {false, ""};
  }
  return {true, fml::paths::GetDirectoryName(path.second)};
}

References GetDirectoryName(), and GetExecutablePath().

Referenced by impeller::FindSwiftShaderICDAtKnownPaths(), and fml::icu::ICUContext::SetupMapping().

GetExecutablePath()

std::pair< bool, std::string > fml::paths::GetExecutablePath

(

)

Definition at line 12 of file paths_android.cc.

                                             {
  return {false, ""};
}

Referenced by GetExecutableDirectoryPath(), flutter::FlutterWindowsEngine::GetExecutableName(), and fml::InstallCrashHandler().

InitializeAndroidCachesPath()

void fml::paths::InitializeAndroidCachesPath

(

std::string

caches_path

)

Definition at line 18 of file paths_android.cc.

                                                        {
  gCachesPath = std::move(caches_path);
}

References gCachesPath.

JoinPaths()

std::string fml::paths::JoinPaths

(

std::initializer_list< std::string >

components

)

Definition at line 14 of file paths.cc.

                                                               {
  std::stringstream stream;
  size_t i = 0;
  const size_t size = components.size();
  for (const auto& component : components) {
    i++;
    stream << component;
    if (i != size) {
#if FML_OS_WIN
      stream << "\\";
#else   // FML_OS_WIN
      stream << "/";
#endif  // FML_OS_WIN
    }
  }
  return stream.str();
}

References i.

Referenced by impeller::FindSwiftShaderICDAtKnownPaths(), FlutterEngineInitialize(), flutter::testing::GetDefaultKernelFilePath(), impeller::testing::WorkingDirectory::GetFilenamePath(), impeller::compiler::testing::GetIntermediatesPath(), flutter::testing::ImageMatchesFixture(), flutter::testing::LoadELFSplitSymbolFromFixturesIfNeccessary(), flutter::testing::LoadELFSymbolFromFixturesIfNeccessary(), flutter::DartCallbackCache::SetCachePath(), flutter::testing::DartFixture::SetSnapshotsAndAssets(), flutter::SettingsFromCommandLine(), flutter::testing::EmbedderTestContext::SetupAOTDataIfNecessary(), fml::icu::ICUContext::SetupMapping(), TEST(), TEST(), TEST(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), flutter::testing::TEST_F(), and flutter::testing::TEST_F().

SanitizeURIEscapedCharacters()

std::string fml::paths::SanitizeURIEscapedCharacters

(

const std::string &

str

)

Definition at line 32 of file paths.cc.

                                                             {
  std::string result;
  result.reserve(str.size());
  for (std::string::size_type i = 0; i < str.size(); ++i) {
    if (str[i] == '%') {
      if (i > str.size() - 3 || !isxdigit(str[i + 1]) ||
          !isxdigit(str[i + 2])) {
        return "";
      }
      const std::string hex = str.substr(i + 1, 2);
      const unsigned char c = strtoul(hex.c_str(), nullptr, 16);
      if (!c) {
        return "";
      }
      result += c;
      i += 2;
    } else {
      result += str[i];
    }
  }
  return result;
}

References i.

Referenced by FromURI(), and TEST().

Variable Documentation

gCachesPath

std::string fml::paths::gCachesPath

static

Definition at line 16 of file paths_android.cc.

Referenced by GetCachesDirectory(), and InitializeAndroidCachesPath().