po4a/iconv/po/iconv.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2012-03-22 04:25+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=CHARSET\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man3/iconv.3:16
  21 #, no-wrap
  22 msgid "ICONV"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/iconv.3:16
  27 #, no-wrap
  28 msgid "2008-09-08"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/iconv.3:16 build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/iconv.3:16 build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/iconv.3:17 build/C/man3/iconv_close.3:13 build/C/man3/iconv_open.3:17
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/iconv.3:19
  51 msgid "iconv - perform character set conversion"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/iconv.3:22 build/C/man3/iconv_close.3:18 build/C/man3/iconv_open.3:22
  62 #, no-wrap
  63 msgid "B<#include E<lt>iconv.hE<gt>>\n"
  64 msgstr ""
  65
  66 #. type: Plain text
  67 #: build/C/man3/iconv.3:26
  68 #, no-wrap
  69 msgid ""
  70 "B<size_t iconv(iconv_t >I<cd>B<,>\n"
  71 "B<             char **>I<inbuf>B<, size_t *>I<inbytesleft>B<,>\n"
  72 "B<             char **>I<outbuf>B<, size_t *>I<outbytesleft>B<);>\n"
  73 msgstr ""
  74
  75 #. type: SH
  76 #: build/C/man3/iconv.3:27 build/C/man3/iconv_close.3:21 build/C/man3/iconv_open.3:25
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man3/iconv.3:31
  83 msgid ""
  84 "The argument I<cd> must be a conversion descriptor created using the "
  85 "function B<iconv_open>(3)."
  86 msgstr ""
  87
  88 #. type: Plain text
  89 #: build/C/man3/iconv.3:39
  90 msgid ""
  91 "The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL.  In "
  92 "this case, the B<iconv>()  function converts the multibyte sequence starting "
  93 "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>.  At most "
  94 "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read.  At most "
  95 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written."
  96 msgstr ""
  97
  98 #. type: Plain text
  99 #: build/C/man3/iconv.3:53
 100 msgid ""
 101 "The B<iconv>()  function converts one multibyte character at a time, and for "
 102 "each character conversion it increments I<*inbuf> and decrements "
 103 "I<*inbytesleft> by the number of converted input bytes, it increments "
 104 "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output "
 105 "bytes, and it updates the conversion state contained in I<cd>.  If the "
 106 "character encoding of the input is stateful, the B<iconv>()  function can "
 107 "also convert a sequence of input bytes to an update to the conversion state "
 108 "without producing any output bytes; such input is called a I<shift "
 109 "sequence>.  The conversion can stop for four reasons:"
 110 msgstr ""
 111
 112 #. type: Plain text
 113 #: build/C/man3/iconv.3:60
 114 msgid ""
 115 "1. An invalid multibyte sequence is encountered in the input.  In this case "
 116 "it sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>.  I<*inbuf> is "
 117 "left pointing to the beginning of the invalid multibyte sequence."
 118 msgstr ""
 119
 120 #. type: Plain text
 121 #: build/C/man3/iconv.3:67
 122 msgid ""
 123 "2. The input byte sequence has been entirely converted, that is, "
 124 "I<*inbytesleft> has gone down to 0.  In this case B<iconv>()  returns the "
 125 "number of nonreversible conversions performed during this call."
 126 msgstr ""
 127
 128 #. type: Plain text
 129 #: build/C/man3/iconv.3:75
 130 msgid ""
 131 "3. An incomplete multibyte sequence is encountered in the input, and the "
 132 "input byte sequence terminates after it.  In this case it sets I<errno> to "
 133 "B<EINVAL> and returns I<(size_t)\\ -1>.  I<*inbuf> is left pointing to the "
 134 "beginning of the incomplete multibyte sequence."
 135 msgstr ""
 136
 137 #. type: Plain text
 138 #: build/C/man3/iconv.3:79
 139 msgid ""
 140 "4. The output buffer has no more room for the next converted character.  In "
 141 "this case it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>."
 142 msgstr ""
 143
 144 #. type: Plain text
 145 #: build/C/man3/iconv.3:93
 146 msgid ""
 147 "A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but "
 148 "I<outbuf> is not NULL and I<*outbuf> is not NULL.  In this case, the "
 149 "B<iconv>()  function attempts to set I<cd>'s conversion state to the initial "
 150 "state and store a corresponding shift sequence at I<*outbuf>.  At most "
 151 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.  If the "
 152 "output buffer has no more room for this reset sequence, it sets I<errno> to "
 153 "B<E2BIG> and returns I<(size_t)\\ -1>.  Otherwise it increments I<*outbuf> "
 154 "and decrements I<*outbytesleft> by the number of bytes written."
 155 msgstr ""
 156
 157 #. type: Plain text
 158 #: build/C/man3/iconv.3:99
 159 msgid ""
 160 "A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is "
 161 "NULL or I<*outbuf> is NULL.  In this case, the B<iconv>()  function sets "
 162 "I<cd>'s conversion state to the initial state."
 163 msgstr ""
 164
 165 #. type: SH
 166 #: build/C/man3/iconv.3:99 build/C/man3/iconv_close.3:27 build/C/man3/iconv_open.3:69
 167 #, no-wrap
 168 msgid "RETURN VALUE"
 169 msgstr ""
 170
 171 #. type: Plain text
 172 #: build/C/man3/iconv.3:106
 173 msgid ""
 174 "The B<iconv>()  function returns the number of characters converted in a "
 175 "nonreversible way during this call; reversible conversions are not counted.  "
 176 "In case of error, it sets I<errno> and returns I<(size_t)\\ -1>."
 177 msgstr ""
 178
 179 #. type: SH
 180 #: build/C/man3/iconv.3:106 build/C/man3/iconv_open.3:76
 181 #, no-wrap
 182 msgid "ERRORS"
 183 msgstr ""
 184
 185 #. type: Plain text
 186 #: build/C/man3/iconv.3:108
 187 msgid "The following errors can occur, among others:"
 188 msgstr ""
 189
 190 #. type: TP
 191 #: build/C/man3/iconv.3:108
 192 #, no-wrap
 193 msgid "B<E2BIG>"
 194 msgstr ""
 195
 196 #. type: Plain text
 197 #: build/C/man3/iconv.3:111
 198 msgid "There is not sufficient room at I<*outbuf>."
 199 msgstr ""
 200
 201 #. type: TP
 202 #: build/C/man3/iconv.3:111
 203 #, no-wrap
 204 msgid "B<EILSEQ>"
 205 msgstr ""
 206
 207 #. type: Plain text
 208 #: build/C/man3/iconv.3:114
 209 msgid "An invalid multibyte sequence has been encountered in the input."
 210 msgstr ""
 211
 212 #. type: TP
 213 #: build/C/man3/iconv.3:114 build/C/man3/iconv_open.3:78
 214 #, no-wrap
 215 msgid "B<EINVAL>"
 216 msgstr ""
 217
 218 #. type: Plain text
 219 #: build/C/man3/iconv.3:117
 220 msgid "An incomplete multibyte sequence has been encountered in the input."
 221 msgstr ""
 222
 223 #. type: SH
 224 #: build/C/man3/iconv.3:117 build/C/man3/iconv_close.3:34 build/C/man3/iconv_open.3:82
 225 #, no-wrap
 226 msgid "VERSIONS"
 227 msgstr ""
 228
 229 #. type: Plain text
 230 #: build/C/man3/iconv.3:119 build/C/man3/iconv_close.3:36 build/C/man3/iconv_open.3:84
 231 msgid "This function is available in glibc since version 2.1."
 232 msgstr ""
 233
 234 #. type: SH
 235 #: build/C/man3/iconv.3:119 build/C/man3/iconv_close.3:36 build/C/man3/iconv_open.3:84
 236 #, no-wrap
 237 msgid "CONFORMING TO"
 238 msgstr ""
 239
 240 #. type: Plain text
 241 #: build/C/man3/iconv.3:121
 242 msgid "POSIX.1-2001."
 243 msgstr ""
 244
 245 #. type: SH
 246 #: build/C/man3/iconv.3:121 build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86
 247 #, no-wrap
 248 msgid "SEE ALSO"
 249 msgstr ""
 250
 251 #. type: Plain text
 252 #: build/C/man3/iconv.3:124
 253 msgid "B<iconv_close>(3), B<iconv_open>(3)"
 254 msgstr ""
 255
 256 #. type: SH
 257 #: build/C/man3/iconv.3:124 build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:90
 258 #, no-wrap
 259 msgid "COLOPHON"
 260 msgstr ""
 261
 262 #. type: Plain text
 263 #: build/C/man3/iconv.3:131 build/C/man3/iconv_close.3:48 build/C/man3/iconv_open.3:97
 264 msgid ""
 265 "This page is part of release 3.37 of the Linux I<man-pages> project.  A "
 266 "description of the project, and information about reporting bugs, can be "
 267 "found at http://www.kernel.org/doc/man-pages/."
 268 msgstr ""
 269
 270 #. type: TH
 271 #: build/C/man3/iconv_close.3:12
 272 #, no-wrap
 273 msgid "ICONV_CLOSE"
 274 msgstr ""
 275
 276 #. type: TH
 277 #: build/C/man3/iconv_close.3:12 build/C/man3/iconv_open.3:16
 278 #, no-wrap
 279 msgid "2008-08-11"
 280 msgstr ""
 281
 282 #. type: Plain text
 283 #: build/C/man3/iconv_close.3:15
 284 msgid "iconv_close - deallocate descriptor for character set conversion"
 285 msgstr ""
 286
 287 #. type: Plain text
 288 #: build/C/man3/iconv_close.3:20
 289 #, no-wrap
 290 msgid "B<int iconv_close(iconv_t >I<cd>B<);>\n"
 291 msgstr ""
 292
 293 #. type: Plain text
 294 #: build/C/man3/iconv_close.3:27
 295 msgid ""
 296 "The B<iconv_close>()  function deallocates a conversion descriptor I<cd> "
 297 "previously allocated using B<iconv_open>(3)."
 298 msgstr ""
 299
 300 #. type: Plain text
 301 #: build/C/man3/iconv_close.3:34
 302 msgid ""
 303 "When successful, the B<iconv_close>()  function returns 0.  In case of "
 304 "error, it sets I<errno> and returns -1."
 305 msgstr ""
 306
 307 #. type: Plain text
 308 #: build/C/man3/iconv_close.3:38 build/C/man3/iconv_open.3:86
 309 msgid "UNIX98, POSIX.1-2001."
 310 msgstr ""
 311
 312 #. type: Plain text
 313 #: build/C/man3/iconv_close.3:41
 314 msgid "B<iconv>(3), B<iconv_open>(3)"
 315 msgstr ""
 316
 317 #. type: TH
 318 #: build/C/man3/iconv_open.3:16
 319 #, no-wrap
 320 msgid "ICONV_OPEN"
 321 msgstr ""
 322
 323 #. type: Plain text
 324 #: build/C/man3/iconv_open.3:19
 325 msgid "iconv_open - allocate descriptor for character set conversion"
 326 msgstr ""
 327
 328 #. type: Plain text
 329 #: build/C/man3/iconv_open.3:24
 330 #, no-wrap
 331 msgid ""
 332 "B<iconv_t iconv_open(const char *>I<tocode>B<, const char "
 333 "*>I<fromcode>B<);>\n"
 334 msgstr ""
 335
 336 #. type: Plain text
 337 #: build/C/man3/iconv_open.3:31
 338 msgid ""
 339 "The B<iconv_open>()  function allocates a conversion descriptor suitable for "
 340 "converting byte sequences from character encoding I<fromcode> to character "
 341 "encoding I<tocode>."
 342 msgstr ""
 343
 344 #. type: Plain text
 345 #: build/C/man3/iconv_open.3:39
 346 msgid ""
 347 "The values permitted for I<fromcode> and I<tocode> and the supported "
 348 "combinations are system-dependent.  For the GNU C library, the permitted "
 349 "values are listed by the B<iconv --list> command, and all combinations of "
 350 "the listed values are supported.  Furthermore the GNU C library and the GNU "
 351 "libiconv library support the following two suffixes:"
 352 msgstr ""
 353
 354 #. type: TP
 355 #: build/C/man3/iconv_open.3:39
 356 #, no-wrap
 357 msgid "//TRANSLIT"
 358 msgstr ""
 359
 360 #. type: Plain text
 361 #: build/C/man3/iconv_open.3:46
 362 msgid ""
 363 "When the string \"//TRANSLIT\" is appended to I<tocode>, transliteration is "
 364 "activated.  This means that when a character cannot be represented in the "
 365 "target character set, it can be approximated through one or several "
 366 "similarly looking characters."
 367 msgstr ""
 368
 369 #. type: TP
 370 #: build/C/man3/iconv_open.3:46
 371 #, no-wrap
 372 msgid "//IGNORE"
 373 msgstr ""
 374
 375 #. type: Plain text
 376 #: build/C/man3/iconv_open.3:50
 377 msgid ""
 378 "When the string \"//IGNORE\" is appended to I<tocode>, characters that "
 379 "cannot be represented in the target character set will be silently "
 380 "discarded."
 381 msgstr ""
 382
 383 #. type: Plain text
 384 #: build/C/man3/iconv_open.3:56
 385 msgid ""
 386 "The resulting conversion descriptor can be used with B<iconv>(3)  any number "
 387 "of times.  It remains valid until deallocated using B<iconv_close>(3)."
 388 msgstr ""
 389
 390 #. type: Plain text
 391 #: build/C/man3/iconv_open.3:69
 392 msgid ""
 393 "A conversion descriptor contains a conversion state.  After creation using "
 394 "B<iconv_open>(), the state is in the initial state.  Using B<iconv>(3)  "
 395 "modifies the descriptor's conversion state.  (This implies that a conversion "
 396 "descriptor can not be used in multiple threads simultaneously.)  To bring "
 397 "the state back to the initial state, use B<iconv>(3)  with NULL as I<inbuf> "
 398 "argument."
 399 msgstr ""
 400
 401 #. type: Plain text
 402 #: build/C/man3/iconv_open.3:76
 403 msgid ""
 404 "The B<iconv_open>()  function returns a freshly allocated conversion "
 405 "descriptor.  In case of error, it sets I<errno> and returns I<(iconv_t)\\ "
 406 "-1>."
 407 msgstr ""
 408
 409 #. type: Plain text
 410 #: build/C/man3/iconv_open.3:78
 411 msgid "The following error can occur, among others:"
 412 msgstr ""
 413
 414 #. type: Plain text
 415 #: build/C/man3/iconv_open.3:82
 416 msgid ""
 417 "The conversion from I<fromcode> to I<tocode> is not supported by the "
 418 "implementation."
 419 msgstr ""
 420
 421 #. type: Plain text
 422 #: build/C/man3/iconv_open.3:90
 423 msgid "B<iconv>(1), B<iconv>(3), B<iconv_close>(3)"
 424 msgstr ""