aboutsummaryrefslogtreecommitdiff
path: root/include/cru/base/io/Base.h
blob: d5e2abffee17b1f6e557fd8441ee18e04aa752c0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
#pragma once

#include "../Base.h"
#include "../Bitmask.h"

namespace cru::io {
class CRU_BASE_API FileNotExistException : public Exception {
 public:
  using Exception::Exception;
};

namespace details {
struct OpenFileFlagTag {};
}  // namespace details
using OpenFileFlag = Bitmask<details::OpenFileFlagTag>;

struct OpenFileFlags {
  /**
   * \brief for reading
   * If the file does not exist, FileNotExistException should be thrown.
   */
  static constexpr OpenFileFlag Read{0x1};

  /**
   * \brief for writing
   * If the file does not exist and Create is not specified,
   * FileNotExistException should be thrown.
   */
  static constexpr OpenFileFlag Write{0x2};

  /**
   * \brief when writing, seek to end first
   * Only effective for writing.
   */
  static constexpr OpenFileFlag Append{0x4};

  /**
   * \brief when writing, truncate the file to empty
   * Only effective for writing.
   * So the content is erased! Be careful!
   */
  static constexpr OpenFileFlag Truncate{0x8};

  /**
   * \brief when writing, if the file does not exist, create one
   * Only effective for writing. When file does not exist, FileNotExistException
   * will NOT be thrown and a new file will be created.
   */
  static constexpr OpenFileFlag Create{0x10};

  /**
   *  TODO: ???
   */
  static constexpr OpenFileFlag Exclusive{0x20};
};

/**
 * Append, Truncate, Create must be used with Write.
 * Append and Truncate must not be used together.
 */
bool CheckOpenFileFlag(OpenFileFlag flags);
}  // namespace cru::io