C++

参考

<ostream>

basic_ostream

public member function
<ostream> <iostream>

std::basic_ostream::tellp

pos_type tellp();
获取输出序列中的位置
返回输出流中当前字符的位置。

在内部，如果成员 fail 返回 true，则函数返回 -1。
否则，它返回 rdbuf()->pubseekoff(0,cur,out)。
在内部，函数通过构造一个不进行评估的 sentry 对象来访问输出序列。然后，如果成员 fail 返回 true，则函数返回 -1。
否则，它返回 rdbuf()->pubseekoff(0,cur,out)。
最后，它在返回之前销毁 sentry 对象。

请注意，即使在调用之前设置了 eofbit 标志，该函数也能正常工作。

参数

无

返回值

流中的当前位置。
如果与流关联的 *流缓冲区* 不支持该操作，或者操作失败，则函数返回 -1。
成员类型 pos_type 由 *字符特征* 确定：通常，它是一个 fpos 类型（如 streampos），可以与整数类型进行转换。

错误通过修改 *内部状态标志* 来通知
flagerror
eofbit-
failbit如果 sentry 的构造失败，则可能设置此标志。
badbit流错误（例如，当此函数捕获由内部操作抛出的异常时）。
设置此标志时，流的完整性可能受到影响。
一个操作可能设置多个标志。

如果操作设置了已通过成员 exceptions 注册的 *内部状态标志*，则函数将抛出成员类型为 failure 的异常。

示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
// position in output stream
#include <fstream>      // std::ofstream

int main () {

  std::ofstream outfile;
  outfile.open ("test.txt");

  outfile.write ("This is an apple",16);
  long pos = outfile.tellp();
  outfile.seekp (pos-7);
  outfile.write (" sam",4);

  outfile.close();

  return 0;
}

在此示例中，tellp 用于获取写操作后流中的位置。然后，指针向前移动 7 个字符以在该位置修改文件，因此文件的最终内容为
This is a sample


数据竞争

修改流对象。
并发访问同一个流对象可能导致数据争用。

异常安全

基本保证：如果抛出异常，对象处于有效状态。
如果结果 *错误状态标志* 不是 goodbit 并且成员 exceptions 被设置为针对该状态抛出，则抛出成员类型为 failure 的异常。
内部操作抛出的任何异常都会被函数捕获和处理，并设置 badbit。如果 badbit 在上次调用 exceptions 时被设置，则函数将重新抛出捕获的异常。

另见

basic_ostream::seekp
设置输出序列中的位置 （公开成员函数）
basic_istream::tellg
获取输入序列中的位置 (公共成员函数)