python-docs-zh-tw/c-api/conversion.po at library/string · python/python-docs-zh-tw · GitHub

Repository navigation

History

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

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

# SOME DESCRIPTIVE TITLE.

# This file is distributed under the same license as the Python package.

# Translators:

# Ching-Lung Chuang, 2015

# Leon H., 2017

msgid ""

msgstr ""

"Project-Id-Version: Python 3.12\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2023-07-29 00:03+0000\n"

"PO-Revision-Date: 2017-09-22 18:26+0000\n"

"Last-Translator: Leon H.\n"

"Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"

"tw)\n"

"Language: zh_TW\n"

"MIME-Version: 1.0\n"

"Content-Type: text/plain; charset=UTF-8\n"

"Content-Transfer-Encoding: 8bit\n"

"Plural-Forms: nplurals=1; plural=0;\n"

#: ../../c-api/conversion.rst:6

msgid "String conversion and formatting"

msgstr "字串轉換與格式化"

#: ../../c-api/conversion.rst:8

msgid "Functions for number conversion and formatted string output."

msgstr "數字轉換函式和被格式化的字串輸出。"

#: ../../c-api/conversion.rst:13

msgid ""

"Output not more than *size* bytes to *str* according to the format string "

"*format* and the extra arguments. See the Unix man page :manpage:"

"`snprintf(3)`."

msgstr ""

#: ../../c-api/conversion.rst:19

msgid ""

"Output not more than *size* bytes to *str* according to the format string "

"*format* and the variable argument list *va*. Unix man page :manpage:"

"`vsnprintf(3)`."

msgstr ""

#: ../../c-api/conversion.rst:23

msgid ""

":c:func:`PyOS_snprintf` and :c:func:`PyOS_vsnprintf` wrap the Standard C "

"library functions :c:func:`snprintf` and :c:func:`vsnprintf`. Their purpose "

"is to guarantee consistent behavior in corner cases, which the Standard C "

"functions do not."

msgstr ""

#: ../../c-api/conversion.rst:28

msgid ""

"The wrappers ensure that ``str[size-1]`` is always ``'\\0'`` upon return. "

"They never write more than *size* bytes (including the trailing ``'\\0'``) "

"into str. Both functions require that ``str != NULL``, ``size > 0``, "

"``format != NULL`` and ``size < INT_MAX``. Note that this means there is no "

"equivalent to the C99 ``n = snprintf(NULL, 0, ...)`` which would determine "

"the necessary buffer size."

msgstr ""

#: ../../c-api/conversion.rst:34

msgid ""

"The return value (*rv*) for these functions should be interpreted as follows:"

msgstr "當回傳值 (*rv*) 給這些函式應該被編譯如下："

#: ../../c-api/conversion.rst:36

msgid ""

"When ``0 <= rv < size``, the output conversion was successful and *rv* "

"characters were written to *str* (excluding the trailing ``'\\0'`` byte at "

"``str[rv]``)."

msgstr ""

#: ../../c-api/conversion.rst:40

msgid ""

"When ``rv >= size``, the output conversion was truncated and a buffer with "

"``rv + 1`` bytes would have been needed to succeed. ``str[size-1]`` is "

"``'\\0'`` in this case."

msgstr ""

#: ../../c-api/conversion.rst:44

msgid ""

"When ``rv < 0``, \"something bad happened.\" ``str[size-1]`` is ``'\\0'`` in "

"this case too, but the rest of *str* is undefined. The exact cause of the "

"error depends on the underlying platform."

msgstr ""

#: ../../c-api/conversion.rst:49

msgid ""

"The following functions provide locale-independent string to number "

"conversions."

msgstr ""

#: ../../c-api/conversion.rst:53

msgid ""

"Convert a string ``s`` to a :c:expr:`double`, raising a Python exception on "

"failure. The set of accepted strings corresponds to the set of strings "

"accepted by Python's :func:`float` constructor, except that ``s`` must not "

"have leading or trailing whitespace. The conversion is independent of the "

"current locale."

msgstr ""

#: ../../c-api/conversion.rst:59

msgid ""

"If ``endptr`` is ``NULL``, convert the whole string. Raise :exc:"

"`ValueError` and return ``-1.0`` if the string is not a valid representation "

"of a floating-point number."

msgstr ""

#: ../../c-api/conversion.rst:63

msgid ""

"If endptr is not ``NULL``, convert as much of the string as possible and set "

"``*endptr`` to point to the first unconverted character. If no initial "

"segment of the string is the valid representation of a floating-point "

"number, set ``*endptr`` to point to the beginning of the string, raise "

"ValueError, and return ``-1.0``."

msgstr ""

#: ../../c-api/conversion.rst:70

msgid ""

"If ``s`` represents a value that is too large to store in a float (for "

"example, ``\"1e500\"`` is such a string on many platforms) then if "

"``overflow_exception`` is ``NULL`` return ``Py_HUGE_VAL`` (with an "

"appropriate sign) and don't set any exception. Otherwise, "

"``overflow_exception`` must point to a Python exception object; raise that "

"exception and return ``-1.0``. In both cases, set ``*endptr`` to point to "

"the first character after the converted value."

msgstr ""

#: ../../c-api/conversion.rst:78

msgid ""

"If any other error occurs during the conversion (for example an out-of-"

"memory error), set the appropriate Python exception and return ``-1.0``."

msgstr ""

#: ../../c-api/conversion.rst:87

msgid ""

"Convert a :c:expr:`double` *val* to a string using supplied *format_code*, "

"*precision*, and *flags*."

msgstr ""

#: ../../c-api/conversion.rst:90

msgid ""

"*format_code* must be one of ``'e'``, ``'E'``, ``'f'``, ``'F'``, ``'g'``, "

"``'G'`` or ``'r'``. For ``'r'``, the supplied *precision* must be 0 and is "

"ignored. The ``'r'`` format code specifies the standard :func:`repr` format."

msgstr ""

#: ../../c-api/conversion.rst:95

msgid ""

"*flags* can be zero or more of the values ``Py_DTSF_SIGN``, "

"``Py_DTSF_ADD_DOT_0``, or ``Py_DTSF_ALT``, or-ed together:"

msgstr ""

#: ../../c-api/conversion.rst:98

msgid ""

"``Py_DTSF_SIGN`` means to always precede the returned string with a sign "

"character, even if *val* is non-negative."

msgstr ""

#: ../../c-api/conversion.rst:101

msgid ""

"``Py_DTSF_ADD_DOT_0`` means to ensure that the returned string will not look "

"like an integer."

msgstr ""

#: ../../c-api/conversion.rst:104

msgid ""

"``Py_DTSF_ALT`` means to apply \"alternate\" formatting rules. See the "

"documentation for the :c:func:`PyOS_snprintf` ``'#'`` specifier for details."

msgstr ""

#: ../../c-api/conversion.rst:108

msgid ""

"If *ptype* is non-``NULL``, then the value it points to will be set to one "

"of ``Py_DTST_FINITE``, ``Py_DTST_INFINITE``, or ``Py_DTST_NAN``, signifying "

"that *val* is a finite number, an infinite number, or not a number, "

"respectively."

msgstr ""

#: ../../c-api/conversion.rst:112

msgid ""

"The return value is a pointer to *buffer* with the converted string or "

"``NULL`` if the conversion failed. The caller is responsible for freeing the "

"returned string by calling :c:func:`PyMem_Free`."

msgstr ""

#: ../../c-api/conversion.rst:121

msgid ""

"Case insensitive comparison of strings. The function works almost "

"identically to :c:func:`!strcmp` except that it ignores the case."

msgstr ""

#: ../../c-api/conversion.rst:127

msgid ""

"Case insensitive comparison of strings. The function works almost "

"identically to :c:func:`!strncmp` except that it ignores the case."

msgstr ""

python-docs-zh-tw/c-api/conversion.po at library/string · python/python-docs-zh-tw · GitHub

Repository navigation

Expand file tree

Breadcrumbs

conversion.po

Latest commit

History

Breadcrumbs

conversion.po

File metadata and controls