src/ledger/lib/files/detached_path.h

// Copyright 2019 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef SRC_LEDGER_LIB_FILES_DETACHED_PATH_H_
#define SRC_LEDGER_LIB_FILES_DETACHED_PATH_H_

#include <fcntl.h>

#include <string>

#include "third_party/abseil-cpp/absl/strings/string_view.h"

namespace ledger {

// Abstraction for a path rooted at a file descriptor.
//
// This class doesn't take ownership of the file descriptor and it is expected
// that the file descriptor will outlive this class and any sub path created
// from it.
class DetachedPath {
 public:
  // If |path| is absolute, DetachedPath is equivalent to it. If |path| is
  // relative, it is resolved with |root_fd| as reference. See |openat(2)|.
  explicit DetachedPath(int root_fd = AT_FDCWD, std::string path = ".");
  // If |path| is absolute, DetachedPath is equivalent to it. If |path| is
  // relative, it is resolved relative to the current working directory.
  explicit DetachedPath(std::string path);
  ~DetachedPath();
  DetachedPath(const DetachedPath& other);
  DetachedPath(DetachedPath&& other) noexcept;
  DetachedPath& operator=(const DetachedPath& other);
  DetachedPath& operator=(DetachedPath&& /*unused*/) noexcept;

  // The file descriptor to the base directory of this path.
  int root_fd() const { return root_fd_; };
  // The relative path to |root_fd|.
  const std::string& path() const { return path_; };

  // A |DetachedPath| representing the |path| appended to the current path.
  DetachedPath SubPath(absl::string_view path) const;
  // A |DetachedPath| representing all the |path| in |components| appended to
  // the current path.
  DetachedPath SubPath(std::initializer_list<absl::string_view> components) const;

 private:
  int root_fd_;
  std::string path_;
};

}  // namespace ledger

#endif  // SRC_LEDGER_LIB_FILES_DETACHED_PATH_H_