mmap
就业培训 下载中心 Wiki 联络 登录 注册 首页 Python 3.12.4 索引 模块 下一 上一 Python 标准库 网络和进程间通信 mmap — 内存映射文件支持 mmap — 内存映射文件支持 ¶ 可用性 ：非 Emscripten，非 WASI。 本模块不工作 (或不可用) 于 WebAssembly 平台 wasm32-emscripten and wasm32-wasi 。见 WebAssembly 平台 了解更多信息。 内存映射文件对象的行为像 bytearray 和像 文件对象 。可以在大多数地方使用 mmap 对象若 bytearray 被期望；例如，可以使用 re 模块搜索内存映射文件。还可以改变单个字节通过执行 obj[index] = 97 ，或通过赋值切片改变子序列： obj[i1:i2] = b'...' 。还可以从当前文件位置开始读写数据，及 seek() 透过文件到不同位置。 内存映射文件的创建通过 mmap 构造函数，这在 Unix 和 Windows 会有所不同。无论哪种情况，都必须为更新打开文件提供文件描述符。若希望映射现有 Python 文件对象，使用其 fileno() 方法以获取正确值对于 fileno 参数。否则，可以打开文件使用 os.open() 函数，直接返回文件描述符 (文件仍需关闭当完成时)。 注意 若想要为可写缓冲文件创建内存映射，应 flush() 文件首先。这是必要的，以确保本地修改缓冲实际可用于映射。 对于 Unix 和 Windows 版本的构造函数， access 可以被指定为可选关键词参数。 access 接受 4 值之一： ACCESS_READ , ACCESS_WRITE ，或 ACCESS_COPY 以分别指定只读、透写或写时拷贝内存，或 ACCESS_DEFAULT to defer to prot . access 可以用于 Unix 和 Windows。若 access is not specified, Windows mmap returns a write-through mapping. The initial memory values for all three access types are taken from the specified file. Assignment to an ACCESS_READ 内存映射引发 TypeError 异常。赋值 ACCESS_WRITE 内存映射影响内存和底层文件。赋值 ACCESS_COPY 内存映射影响内存但不会更新底层文件。 3.7 版改变： 添加 ACCESS_DEFAULT 常量。 要映射匿名内存，-1 应作为 fileno 同长度一起传递。 class mmap. mmap ( fileno , length , tagname=None , access=ACCESS_DEFAULT [ , offset ] ) ¶ (Windows 版本) 映射 length 字节从文件指定通过文件句柄 fileno ，并创建 mmap 对象。若 length > 文件的当前大小，将扩展文件以包含 length 字节。若 length is 0 ，映射的最大长度是文件的当前大小，除文件为空 Windows 引发异常外 （不可以在 Windows 创建空映射)。 tagname ，若指定且不是 None ，是给出映射标签名的字符串。Windows 允许同一文件拥有许多不同映射。若指定现有标签名，则打开该标签，否则将创建此名称的新标签。若此参数被省略或 None , the mapping is created without a name. Avoiding the use of the tagname parameter will assist in keeping your code portable between Unix and Windows. offset 可以指定为非负整数偏移。mmap 引用将相对文件开头偏移。 offset 默认为 0。 offset 必须是倍增的 ALLOCATIONGRANULARITY . 引发 审计事件 mmap.__new__ 采用自变量 fileno , length , access , offset . class mmap. mmap ( fileno , length , flags=MAP_SHARED , prot=PROT_WRITE|PROT_READ , access=ACCESS_DEFAULT [ , offset ] ) (Unix 版本) 映射 length 字节从文件指定通过文件描述符 fileno ，并返回 mmap 对象。若 length is 0 ，映射的最大长度将是文件的当前大小当 mmap 被调用。 flags 指定映射的性质。 MAP_PRIVATE 创建私有的写时拷贝映射，因此对 mmap 对象内容的更改将是此进程私有的，和 MAP_SHARED 创建与映射文件相同区域所有其它进程共享的映射。默认值为 MAP_SHARED . Some systems have additional possible flags with the full list specified in MAP_* constants . prot 若指定，给出期望内存保护；2 个最有用的值是 PROT_READ and PROT_WRITE ，以指定页面可以被读取或写入。 prot 默认为 PROT_READ | PROT_WRITE . access 可以指定以代替 flags and prot 作为可选关键词参数。它是错误的同时指定 flags , prot and access 。见描述对于 access 上文对如何使用此参数的有关信息。 offset 可以指定为非负整数偏移。mmap 引用将相对文件开头偏移。 offset 默认为 0。 offset 必须是倍增的 ALLOCATIONGRANULARITY 等于 PAGESIZE 在 Unix 系统。 要确保创建内存有效映射文件，指定通过描述符 fileno is internally automatically synchronized with the physical backing store on macOS. 此范例展示简单方式使用 mmap : import mmap # write a simple example file with open("hello.txt", "wb") as f: f.write(b"Hello Python!\n") with open("hello.txt", "r+b") as f: # memory-map the file, size 0 means whole file mm = mmap.mmap(f.fileno(), 0) # read content via standard file methods print(mm.readline()) # prints b"Hello Python!\n" # read content via slice notation print(mm[:5]) # prints b"Hello" # update content using slice notation; # note that new content must have same size mm[6:] = b" world!\n" # ... and read again using standard file methods mm.seek(0) print(mm.readline()) # prints b"Hello world!\n" # close the map mm.close() mmap 还可以用作上下文管理器在 with 语句： import mmap with mmap.mmap(-1, 13) as mm: mm.write(b"Hello world!") Added in version 3.2: 上下文管理器支持。 下一范例演示如何创建匿名映射，和在父级和子级进程之间交换数据： import mmap import os mm = mmap.mmap(-1, 13) mm.write(b"Hello world!") pid = os.fork() if pid == 0: # In a child process mm.seek(0) print(mm.readline()) mm.close() 引发 审计事件 mmap.__new__ 采用自变量 fileno , length , access , offset . 内存映射文件对象支持以下方法： close ( ) ¶ 关闭 mmap。后续调用对象的其它方法将导致引发 ValueError 异常。这不会关闭打开文件。 closed ¶ True 若文件被关闭。 Added in version 3.2. find ( sub [ , start [ , end ] ] ) ¶ 返回对象的最低索引当子序列 sub 被发现，这种 sub 包含在范围 [ start , end ]。可选自变量 start and end 按切片表示法解释。返回 -1 当故障时。 3.5 版改变： 可写 像字节对象 现接受。 flush ( [ offset [ , size ] ] ) ¶ Flushes changes made to the in-memory copy of a file back to disk. Without use of this call there is no guarantee that changes are written back before the object is destroyed. If offset and size are specified, only changes to the given range of bytes will be flushed to disk; otherwise, the whole extent of the mapping is flushed. offset 必须是倍增的 PAGESIZE or ALLOCATIONGRANULARITY . None 被返回以指示成功。引发异常当调用失败时。 3.8 版改变： Previously, a nonzero value was returned on success; zero was returned on error under Windows. A zero value was returned on success; an exception was raised on error under Unix. madvise ( option [ , start [ , length ] ] ) ¶ Send advice option to the kernel about the memory region beginning at start 并延伸 length 字节。 option 必须是某一 MADV_* 常量 available on the system. If start and length are omitted, the entire mapping is spanned. On some systems (including Linux), start 必须是倍增的 PAGESIZE . 可用性：系统采用 madvise() 系统调用。 Added in version 3.8. move ( dest , src , count ) ¶ 拷贝 count 字节开始于偏移 src 到目的地索引 dest 。若创建 mmap 采用 ACCESS_READ ，那么调用 move 将引发 TypeError 异常。 read ( [ n ] ) ¶ 返回 bytes 包含直到 n 字节从当前文件位置开始。若自变量被省略， None 或负数，返回从当前文件位置到映射结束的所有字节。文件位置将更新到返回字节之后。 3.3 版改变： 自变量可以省略或 None . read_byte ( ) ¶ 以整数形式返回当前文件位置的字节，并将文件位置推进 1。 readline ( ) ¶ 返回单行，从当前文件位置开始并直到下一换行符。文件位置将更新到返回字节之后。 resize ( newsize ) ¶ 重置映射和底层文件的大小，若有的话。若 mmap 的创建是采用 ACCESS_READ or ACCESS_COPY ，重置映射大小将引发 TypeError 异常。 在 Windows : Resizing the map will raise an OSError if there are other maps against the same named file. Resizing an anonymous map (ie against the pagefile) will silently create a new map with the original data copied over up to the length of the new size. 3.11 版改变： Correctly fails if attempting to resize when another map is held Allows resize against an anonymous map on Windows rfind ( sub [ , start [ , end ] ] ) ¶ 返回对象的最高索引当子序列 sub 被发现，这种 sub 包含在范围 [ start , end ]。可选自变量 start and end 按切片表示法解释。返回 -1 当故障时。 3.5 版改变： 可写 像字节对象 现接受。 seek ( pos [ , whence ] ) ¶ 设置文件的当前位置。 whence 自变量可选且默认为 os.SEEK_SET or 0 (绝对文件位置)；其它值 os.SEEK_CUR or 1 (寻址相对于当前位置) 和 os.SEEK_END or 2 (寻址相对于文件末尾)。 size ( ) ¶ 返回文件的长度，可以大于内存映射大小。 tell ( ) ¶ 返回文件指针的当前位置。 write ( bytes ) ¶ Write the bytes in bytes into memory at the current position of the file pointer and return the number of bytes written (never less than len(bytes) ，由于若写入失败， ValueError will be raised). The file position is updated to point after the bytes that were written. If the mmap was created with ACCESS_READ ，那么写入它会引发 TypeError 异常。 3.5 版改变： 可写 像字节对象 现接受。 3.6 版改变： 现在返回写入的字节数。 write_byte ( byte ) ¶ 写入整数 byte 进文件指针当前位置内存；文件位置推进 1 。若创建 mmap 采用 ACCESS_READ ，那么写入它会引发 TypeError 异常。 MADV_* 常量 ¶ mmap. MADV_NORMAL ¶ mmap. MADV_RANDOM ¶ mmap. MADV_SEQUENTIAL ¶ mmap. MADV_WILLNEED ¶ mmap. MADV_DONTNEED ¶ mmap. MADV_REMOVE ¶ mmap. MADV_DONTFORK ¶ mmap. MADV_DOFORK ¶ mmap. MADV_HWPOISON ¶ mmap. MADV_MERGEABLE ¶ mmap. MADV_UNMERGEABLE ¶ mmap. MADV_SOFT_OFFLINE ¶ mmap. MADV_HUGEPAGE ¶ mmap. MADV_NOHUGEPAGE ¶ mmap. MADV_DONTDUMP ¶ mmap. MADV_DODUMP ¶ mmap. MADV_FREE ¶ mmap. MADV_NOSYNC ¶ mmap. MADV_AUTOSYNC ¶ mmap. MADV_NOCORE ¶ mmap. MADV_CORE ¶ mmap. MADV_PROTECT ¶ mmap. MADV_FREE_REUSABLE ¶ mmap. MADV_FREE_REUSE ¶ 可以将这些选项传递给 mmap.madvise() 。并非每个选项都会呈现在每个系统中。 可用性：系统采用 madvise() 系统调用。 Added in version 3.8. MAP_* Constants ¶ mmap. MAP_SHARED ¶ mmap. MAP_PRIVATE ¶ mmap. MAP_DENYWRITE ¶ mmap. MAP_EXECUTABLE ¶ mmap. MAP_ANON ¶ mmap. MAP_ANONYMOUS ¶ mmap. MAP_POPULATE ¶ mmap. MAP_STACK ¶ mmap. MAP_ALIGNED_SUPER ¶ mmap. MAP_CONCEAL ¶ These are the various flags that can be passed to mmap.mmap() . MAP_ALIGNED_SUPER is only available at FreeBSD and MAP_CONCEAL is only available at OpenBSD. Note that some options might not be present on some systems. 3.10 版改变： 添加 MAP_POPULATE 常量。 Added in version 3.11: 添加 MAP_STACK 常量。 Added in version 3.12: 添加 MAP_ALIGNED_SUPER constant. Added MAP_CONCEAL 常量。 内容表 mmap — 内存映射文件支持 MADV_* 常量 MAP_* Constants 上一话题 signal — 为异步事件设置处理程序 下一话题 互联网数据处理 本页 报告 Bug 展示源 快速搜索 键入搜索术语或模块、类、函数名称。 首页 Python 3.12.4 索引 模块 下一 上一 Python 标准库 网络和进程间通信 mmap — 内存映射文件支持
可用性 ：非 Emscripten，非 WASI。
本模块不工作 (或不可用) 于 WebAssembly 平台 wasm32-emscripten and wasm32-wasi 。见 WebAssembly 平台 了解更多信息。
wasm32-emscripten
wasm32-wasi
内存映射文件对象的行为像 bytearray 和像 文件对象 。可以在大多数地方使用 mmap 对象若 bytearray 被期望；例如，可以使用 re 模块搜索内存映射文件。还可以改变单个字节通过执行 obj[index] = 97 ，或通过赋值切片改变子序列： obj[i1:i2] = b'...' 。还可以从当前文件位置开始读写数据，及 seek() 透过文件到不同位置。
bytearray
re
obj[index] = 97
obj[i1:i2] = b'...'
seek()
内存映射文件的创建通过 mmap 构造函数，这在 Unix 和 Windows 会有所不同。无论哪种情况，都必须为更新打开文件提供文件描述符。若希望映射现有 Python 文件对象，使用其 fileno() 方法以获取正确值对于 fileno 参数。否则，可以打开文件使用 os.open() 函数，直接返回文件描述符 (文件仍需关闭当完成时)。
fileno()
os.open()
注意
若想要为可写缓冲文件创建内存映射，应 flush() 文件首先。这是必要的，以确保本地修改缓冲实际可用于映射。
flush()
对于 Unix 和 Windows 版本的构造函数， access 可以被指定为可选关键词参数。 access 接受 4 值之一： ACCESS_READ , ACCESS_WRITE ，或 ACCESS_COPY 以分别指定只读、透写或写时拷贝内存，或 ACCESS_DEFAULT to defer to prot . access 可以用于 Unix 和 Windows。若 access is not specified, Windows mmap returns a write-through mapping. The initial memory values for all three access types are taken from the specified file. Assignment to an ACCESS_READ 内存映射引发 TypeError 异常。赋值 ACCESS_WRITE 内存映射影响内存和底层文件。赋值 ACCESS_COPY 内存映射影响内存但不会更新底层文件。
ACCESS_READ
ACCESS_WRITE
ACCESS_COPY
ACCESS_DEFAULT
TypeError
3.7 版改变： 添加 ACCESS_DEFAULT 常量。
要映射匿名内存，-1 应作为 fileno 同长度一起传递。
(Windows 版本) 映射 length 字节从文件指定通过文件句柄 fileno ，并创建 mmap 对象。若 length > 文件的当前大小，将扩展文件以包含 length 字节。若 length is 0 ，映射的最大长度是文件的当前大小，除文件为空 Windows 引发异常外 （不可以在 Windows 创建空映射)。
0
tagname ，若指定且不是 None ，是给出映射标签名的字符串。Windows 允许同一文件拥有许多不同映射。若指定现有标签名，则打开该标签，否则将创建此名称的新标签。若此参数被省略或 None , the mapping is created without a name. Avoiding the use of the tagname parameter will assist in keeping your code portable between Unix and Windows.
None
offset 可以指定为非负整数偏移。mmap 引用将相对文件开头偏移。 offset 默认为 0。 offset 必须是倍增的 ALLOCATIONGRANULARITY .
ALLOCATIONGRANULARITY
引发 审计事件 mmap.__new__ 采用自变量 fileno , length , access , offset .
mmap.__new__
fileno
length
access
offset
(Unix 版本) 映射 length 字节从文件指定通过文件描述符 fileno ，并返回 mmap 对象。若 length is 0 ，映射的最大长度将是文件的当前大小当 mmap 被调用。
flags 指定映射的性质。 MAP_PRIVATE 创建私有的写时拷贝映射，因此对 mmap 对象内容的更改将是此进程私有的，和 MAP_SHARED 创建与映射文件相同区域所有其它进程共享的映射。默认值为 MAP_SHARED . Some systems have additional possible flags with the full list specified in MAP_* constants .
MAP_PRIVATE
MAP_SHARED
prot 若指定，给出期望内存保护；2 个最有用的值是 PROT_READ and PROT_WRITE ，以指定页面可以被读取或写入。 prot 默认为 PROT_READ | PROT_WRITE .
PROT_READ
PROT_WRITE
PROT_READ | PROT_WRITE
access 可以指定以代替 flags and prot 作为可选关键词参数。它是错误的同时指定 flags , prot and access 。见描述对于 access 上文对如何使用此参数的有关信息。
offset 可以指定为非负整数偏移。mmap 引用将相对文件开头偏移。 offset 默认为 0。 offset 必须是倍增的 ALLOCATIONGRANULARITY 等于 PAGESIZE 在 Unix 系统。
PAGESIZE
要确保创建内存有效映射文件，指定通过描述符 fileno is internally automatically synchronized with the physical backing store on macOS.
此范例展示简单方式使用 mmap :
import mmap # write a simple example file with open("hello.txt", "wb") as f: f.write(b"Hello Python!\n") with open("hello.txt", "r+b") as f: # memory-map the file, size 0 means whole file mm = mmap.mmap(f.fileno(), 0) # read content via standard file methods print(mm.readline()) # prints b"Hello Python!\n" # read content via slice notation print(mm[:5]) # prints b"Hello" # update content using slice notation; # note that new content must have same size mm[6:] = b" world!\n" # ... and read again using standard file methods mm.seek(0) print(mm.readline()) # prints b"Hello world!\n" # close the map mm.close()
mmap 还可以用作上下文管理器在 with 语句：
with
import mmap with mmap.mmap(-1, 13) as mm: mm.write(b"Hello world!")
Added in version 3.2: 上下文管理器支持。
下一范例演示如何创建匿名映射，和在父级和子级进程之间交换数据：
import mmap import os mm = mmap.mmap(-1, 13) mm.write(b"Hello world!") pid = os.fork() if pid == 0: # In a child process mm.seek(0) print(mm.readline()) mm.close()
内存映射文件对象支持以下方法：
关闭 mmap。后续调用对象的其它方法将导致引发 ValueError 异常。这不会关闭打开文件。
True 若文件被关闭。
True
Added in version 3.2.
返回对象的最低索引当子序列 sub 被发现，这种 sub 包含在范围 [ start , end ]。可选自变量 start and end 按切片表示法解释。返回 -1 当故障时。
-1
3.5 版改变： 可写 像字节对象 现接受。
Flushes changes made to the in-memory copy of a file back to disk. Without use of this call there is no guarantee that changes are written back before the object is destroyed. If offset and size are specified, only changes to the given range of bytes will be flushed to disk; otherwise, the whole extent of the mapping is flushed. offset 必须是倍增的 PAGESIZE or ALLOCATIONGRANULARITY .
None 被返回以指示成功。引发异常当调用失败时。
3.8 版改变： Previously, a nonzero value was returned on success; zero was returned on error under Windows. A zero value was returned on success; an exception was raised on error under Unix.
Send advice option to the kernel about the memory region beginning at start 并延伸 length 字节。 option 必须是某一 MADV_* 常量 available on the system. If start and length are omitted, the entire mapping is spanned. On some systems (including Linux), start 必须是倍增的 PAGESIZE .
可用性：系统采用 madvise() 系统调用。
madvise()
Added in version 3.8.
拷贝 count 字节开始于偏移 src 到目的地索引 dest 。若创建 mmap 采用 ACCESS_READ ，那么调用 move 将引发 TypeError 异常。
返回 bytes 包含直到 n 字节从当前文件位置开始。若自变量被省略， None 或负数，返回从当前文件位置到映射结束的所有字节。文件位置将更新到返回字节之后。
bytes
3.3 版改变： 自变量可以省略或 None .
以整数形式返回当前文件位置的字节，并将文件位置推进 1。
返回单行，从当前文件位置开始并直到下一换行符。文件位置将更新到返回字节之后。
重置映射和底层文件的大小，若有的话。若 mmap 的创建是采用 ACCESS_READ or ACCESS_COPY ，重置映射大小将引发 TypeError 异常。
在 Windows : Resizing the map will raise an OSError if there are other maps against the same named file. Resizing an anonymous map (ie against the pagefile) will silently create a new map with the original data copied over up to the length of the new size.
OSError
3.11 版改变： Correctly fails if attempting to resize when another map is held Allows resize against an anonymous map on Windows
返回对象的最高索引当子序列 sub 被发现，这种 sub 包含在范围 [ start , end ]。可选自变量 start and end 按切片表示法解释。返回 -1 当故障时。
设置文件的当前位置。 whence 自变量可选且默认为 os.SEEK_SET or 0 (绝对文件位置)；其它值 os.SEEK_CUR or 1 (寻址相对于当前位置) 和 os.SEEK_END or 2 (寻址相对于文件末尾)。
os.SEEK_SET
os.SEEK_CUR
1
os.SEEK_END
2
返回文件的长度，可以大于内存映射大小。
返回文件指针的当前位置。
Write the bytes in bytes into memory at the current position of the file pointer and return the number of bytes written (never less than len(bytes) ，由于若写入失败， ValueError will be raised). The file position is updated to point after the bytes that were written. If the mmap was created with ACCESS_READ ，那么写入它会引发 TypeError 异常。
len(bytes)
ValueError
3.6 版改变： 现在返回写入的字节数。
写入整数 byte 进文件指针当前位置内存；文件位置推进 1 。若创建 mmap 采用 ACCESS_READ ，那么写入它会引发 TypeError 异常。
可以将这些选项传递给 mmap.madvise() 。并非每个选项都会呈现在每个系统中。
mmap.madvise()
These are the various flags that can be passed to mmap.mmap() . MAP_ALIGNED_SUPER is only available at FreeBSD and MAP_CONCEAL is only available at OpenBSD. Note that some options might not be present on some systems.
mmap.mmap()
MAP_ALIGNED_SUPER
MAP_CONCEAL
3.10 版改变： 添加 MAP_POPULATE 常量。
MAP_POPULATE
Added in version 3.11: 添加 MAP_STACK 常量。
MAP_STACK
Added in version 3.12: 添加 MAP_ALIGNED_SUPER constant. Added MAP_CONCEAL 常量。
signal — 为异步事件设置处理程序
signal
互联网数据处理
键入搜索术语或模块、类、函数名称。