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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
|
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.17.1: http://docutils.sourceforge.net/" />
<title>File Path Function Arguments — pygame v2.1.2 documentation</title>
<link rel="stylesheet" type="text/css" href="_static/pygments.css" />
<link rel="stylesheet" type="text/css" href="_static/pygame.css" />
<script data-url_root="./" id="documentation_options" src="_static/documentation_options.js"></script>
<script src="_static/jquery.js"></script>
<script src="_static/underscore.js"></script>
<script src="_static/doctools.js"></script>
<link rel="shortcut icon" href="_static/pygame.ico"/>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="prev" title="API exported by pygame.version" href="c_api/version.html" />
</head><body>
<div class="document">
<div class="header">
<table>
<tr>
<td class="logo">
<a href="https://www.pygame.org/">
<img src="_static/pygame_tiny.png"/>
</a>
<h5>pygame documentation</h5>
</td>
<td class="pagelinks">
<div class="top">
<a href="https://www.pygame.org/">Pygame Home</a> ||
<a href="index.html">Help Contents</a> ||
<a href="genindex.html">Reference Index</a>
<form action="search.html" method="get" style="display:inline;float:right;">
<input name="q" value="" type="text">
<input value="search" type="submit">
</form>
</div>
<hr style="color:black;border-bottom:none;border-style: dotted;border-bottom-style:none;">
<p class="bottom"><b>Most useful stuff</b>:
<a href="ref/color.html">Color</a> |
<a href="ref/display.html">display</a> |
<a href="ref/draw.html">draw</a> |
<a href="ref/event.html">event</a> |
<a href="ref/font.html">font</a> |
<a href="ref/image.html">image</a> |
<a href="ref/key.html">key</a> |
<a href="ref/locals.html">locals</a> |
<a href="ref/mixer.html">mixer</a> |
<a href="ref/mouse.html">mouse</a> |
<a href="ref/rect.html">Rect</a> |
<a href="ref/surface.html">Surface</a> |
<a href="ref/time.html">time</a> |
<a href="ref/music.html">music</a> |
<a href="ref/pygame.html">pygame</a>
</p>
<p class="bottom"><b>Advanced stuff</b>:
<a href="ref/cursors.html">cursors</a> |
<a href="ref/joystick.html">joystick</a> |
<a href="ref/mask.html">mask</a> |
<a href="ref/sprite.html">sprite</a> |
<a href="ref/transform.html">transform</a> |
<a href="ref/bufferproxy.html">BufferProxy</a> |
<a href="ref/freetype.html">freetype</a> |
<a href="ref/gfxdraw.html">gfxdraw</a> |
<a href="ref/midi.html">midi</a> |
<a href="ref/pixelarray.html">PixelArray</a> |
<a href="ref/pixelcopy.html">pixelcopy</a> |
<a href="ref/sndarray.html">sndarray</a> |
<a href="ref/surfarray.html">surfarray</a> |
<a href="ref/math.html">math</a>
</p>
<p class="bottom"><b>Other</b>:
<a href="ref/camera.html">camera</a> |
<a href="ref/sdl2_controller.html#module-pygame._sdl2.controller">controller</a> |
<a href="ref/examples.html">examples</a> |
<a href="ref/fastevent.html">fastevent</a> |
<a href="ref/scrap.html">scrap</a> |
<a href="ref/tests.html">tests</a> |
<a href="ref/touch.html">touch</a> |
<a href="ref/pygame.html#module-pygame.version">version</a>
</p>
</td>
</tr>
</table>
</div>
<div class="documentwrapper">
<div class="body" role="main">
<section id="file-path-function-arguments">
<p>A pygame function or method which takes a file path argument will accept
either a Unicode or a byte (8-bit or ASCII character) string.
Unicode strings are translated to Python's default filesystem encoding,
as returned by sys.getfilesystemencoding(). A Unicode code point
above U+FFFF (<code class="docutils literal notranslate"><span class="pre">\uFFFF</span></code>) can be coded directly with a 32-bit escape sequences
(<code class="docutils literal notranslate"><span class="pre">\Uxxxxxxxx</span></code>), even for Python interpreters built with an UCS-2
(16-bit character) Unicode type. Byte strings are passed
to the operating system unchanged.</p>
<p>Null characters (<code class="docutils literal notranslate"><span class="pre">\x00</span></code>) are not permitted in the path, raising an exception.
An exception is also raised if an Unicode file path cannot be encoded.
How UTF-16 surrogate codes are handled is Python-interpreter-dependent.
Use UTF-32 code points and 32-bit escape sequences instead.
The exception types are function-dependent.</p>
</section>
<br /><br />
<hr />
<a href="https://github.com/pygame/pygame/edit/main/docs/reST/filepaths.rst" rel="nofollow">Edit on GitHub</a>
<div class="clearer"></div>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related" role="navigation" aria-label="related navigation">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="c_api/version.html" title="API exported by pygame.version"
accesskey="P">previous</a> |</li>
<li class="nav-item nav-item-0"><a href="index.html">pygame v2.1.2 documentation</a> »</li>
<li class="nav-item nav-item-this"><a href="">File Path Function Arguments</a></li>
<script type="text/javascript" src="https://www.pygame.org/comment/jquery.plugin.docscomments.js"></script>
</ul>
</div>
<div class="footer" role="contentinfo">
© Copyright 2000-2021, pygame developers.
</div>
</body>
</html>
|
