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: 2013-09-28 04:06+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:18
  21 #, no-wrap
  22 msgid "ICONV"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man3/iconv.3:18
  27 #, no-wrap
  28 msgid "2012-05-10"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
  33 #, no-wrap
  34 msgid "GNU"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man3/iconv.3:18 build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man3/iconv.3:19 build/C/man3/iconv_close.3:15 build/C/man3/iconv_open.3:19
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man3/iconv.3:21
  51 msgid "iconv - perform character set conversion"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man3/iconv.3:21 build/C/man3/iconv_close.3:17 build/C/man3/iconv_open.3:21
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man3/iconv.3:24 build/C/man3/iconv_close.3:20 build/C/man3/iconv_open.3:24
  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:28
  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:29 build/C/man3/iconv_close.3:23 build/C/man3/iconv_open.3:27
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man3/iconv.3:54
  83 msgid ""
  84 "The B<iconv>()  function converts a sequence of characters in one character "
  85 "encoding to a sequence of characters in another character encoding.  The "
  86 "I<cd> argument is a conversion descriptor, previously created by a call to "
  87 "B<iconv_open>(3); the conversion descriptor defines the character encodings "
  88 "that B<iconv>()  uses for the conversion.  The I<inbuf> argument is the "
  89 "address of a variable that points to the first character of the input "
  90 "sequence; I<inbytesleft> indicates the number of bytes in that buffer.  The "
  91 "I<outbuf> argument is the address of a variable that points to the first "
  92 "byte available in the output buffer; I<outbytesleft> indicates the number of "
  93 "bytes available in the output buffer."
  94 msgstr ""
  95
  96 #. type: Plain text
  97 #: build/C/man3/iconv.3:62
  98 msgid ""
  99 "The main case is when I<inbuf> is not NULL and I<*inbuf> is not NULL.  In "
 100 "this case, the B<iconv>()  function converts the multibyte sequence starting "
 101 "at I<*inbuf> to a multibyte sequence starting at I<*outbuf>.  At most "
 102 "I<*inbytesleft> bytes, starting at I<*inbuf>, will be read.  At most "
 103 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written."
 104 msgstr ""
 105
 106 #. type: Plain text
 107 #: build/C/man3/iconv.3:76
 108 msgid ""
 109 "The B<iconv>()  function converts one multibyte character at a time, and for "
 110 "each character conversion it increments I<*inbuf> and decrements "
 111 "I<*inbytesleft> by the number of converted input bytes, it increments "
 112 "I<*outbuf> and decrements I<*outbytesleft> by the number of converted output "
 113 "bytes, and it updates the conversion state contained in I<cd>.  If the "
 114 "character encoding of the input is stateful, the B<iconv>()  function can "
 115 "also convert a sequence of input bytes to an update to the conversion state "
 116 "without producing any output bytes; such input is called a I<shift "
 117 "sequence>.  The conversion can stop for four reasons:"
 118 msgstr ""
 119
 120 #. type: IP
 121 #: build/C/man3/iconv.3:76
 122 #, no-wrap
 123 msgid "1."
 124 msgstr ""
 125
 126 #. type: Plain text
 127 #: build/C/man3/iconv.3:83
 128 msgid ""
 129 "An invalid multibyte sequence is encountered in the input.  In this case it "
 130 "sets I<errno> to B<EILSEQ> and returns I<(size_t)\\ -1>.  I<*inbuf> is left "
 131 "pointing to the beginning of the invalid multibyte sequence."
 132 msgstr ""
 133
 134 #. type: IP
 135 #: build/C/man3/iconv.3:83
 136 #, no-wrap
 137 msgid "2."
 138 msgstr ""
 139
 140 #. type: Plain text
 141 #: build/C/man3/iconv.3:90
 142 msgid ""
 143 "The input byte sequence has been entirely converted, that is, "
 144 "I<*inbytesleft> has gone down to 0.  In this case B<iconv>()  returns the "
 145 "number of nonreversible conversions performed during this call."
 146 msgstr ""
 147
 148 #. type: IP
 149 #: build/C/man3/iconv.3:90
 150 #, no-wrap
 151 msgid "3."
 152 msgstr ""
 153
 154 #. type: Plain text
 155 #: build/C/man3/iconv.3:98
 156 msgid ""
 157 "An incomplete multibyte sequence is encountered in the input, and the input "
 158 "byte sequence terminates after it.  In this case it sets I<errno> to "
 159 "B<EINVAL> and returns I<(size_t)\\ -1>.  I<*inbuf> is left pointing to the "
 160 "beginning of the incomplete multibyte sequence."
 161 msgstr ""
 162
 163 #. type: IP
 164 #: build/C/man3/iconv.3:98
 165 #, no-wrap
 166 msgid "4."
 167 msgstr ""
 168
 169 #. type: Plain text
 170 #: build/C/man3/iconv.3:102
 171 msgid ""
 172 "The output buffer has no more room for the next converted character.  In "
 173 "this case it sets I<errno> to B<E2BIG> and returns I<(size_t)\\ -1>."
 174 msgstr ""
 175
 176 #. type: Plain text
 177 #: build/C/man3/iconv.3:116
 178 msgid ""
 179 "A different case is when I<inbuf> is NULL or I<*inbuf> is NULL, but "
 180 "I<outbuf> is not NULL and I<*outbuf> is not NULL.  In this case, the "
 181 "B<iconv>()  function attempts to set I<cd>'s conversion state to the initial "
 182 "state and store a corresponding shift sequence at I<*outbuf>.  At most "
 183 "I<*outbytesleft> bytes, starting at I<*outbuf>, will be written.  If the "
 184 "output buffer has no more room for this reset sequence, it sets I<errno> to "
 185 "B<E2BIG> and returns I<(size_t)\\ -1>.  Otherwise it increments I<*outbuf> "
 186 "and decrements I<*outbytesleft> by the number of bytes written."
 187 msgstr ""
 188
 189 #. type: Plain text
 190 #: build/C/man3/iconv.3:122
 191 msgid ""
 192 "A third case is when I<inbuf> is NULL or I<*inbuf> is NULL, and I<outbuf> is "
 193 "NULL or I<*outbuf> is NULL.  In this case, the B<iconv>()  function sets "
 194 "I<cd>'s conversion state to the initial state."
 195 msgstr ""
 196
 197 #. type: SH
 198 #: build/C/man3/iconv.3:122 build/C/man3/iconv_close.3:30 build/C/man3/iconv_open.3:86
 199 #, no-wrap
 200 msgid "RETURN VALUE"
 201 msgstr ""
 202
 203 #. type: Plain text
 204 #: build/C/man3/iconv.3:129
 205 msgid ""
 206 "The B<iconv>()  function returns the number of characters converted in a "
 207 "nonreversible way during this call; reversible conversions are not counted.  "
 208 "In case of error, it sets I<errno> and returns I<(size_t)\\ -1>."
 209 msgstr ""
 210
 211 #. type: SH
 212 #: build/C/man3/iconv.3:129 build/C/man3/iconv_open.3:95
 213 #, no-wrap
 214 msgid "ERRORS"
 215 msgstr ""
 216
 217 #. type: Plain text
 218 #: build/C/man3/iconv.3:131
 219 msgid "The following errors can occur, among others:"
 220 msgstr ""
 221
 222 #. type: TP
 223 #: build/C/man3/iconv.3:131
 224 #, no-wrap
 225 msgid "B<E2BIG>"
 226 msgstr ""
 227
 228 #. type: Plain text
 229 #: build/C/man3/iconv.3:134
 230 msgid "There is not sufficient room at I<*outbuf>."
 231 msgstr ""
 232
 233 #. type: TP
 234 #: build/C/man3/iconv.3:134
 235 #, no-wrap
 236 msgid "B<EILSEQ>"
 237 msgstr ""
 238
 239 #. type: Plain text
 240 #: build/C/man3/iconv.3:137
 241 msgid "An invalid multibyte sequence has been encountered in the input."
 242 msgstr ""
 243
 244 #. type: TP
 245 #: build/C/man3/iconv.3:137 build/C/man3/iconv_open.3:97
 246 #, no-wrap
 247 msgid "B<EINVAL>"
 248 msgstr ""
 249
 250 #. type: Plain text
 251 #: build/C/man3/iconv.3:140
 252 msgid "An incomplete multibyte sequence has been encountered in the input."
 253 msgstr ""
 254
 255 #. type: SH
 256 #: build/C/man3/iconv.3:140 build/C/man3/iconv_close.3:37 build/C/man3/iconv_open.3:105
 257 #, no-wrap
 258 msgid "VERSIONS"
 259 msgstr ""
 260
 261 #. type: Plain text
 262 #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
 263 msgid "This function is available in glibc since version 2.1."
 264 msgstr ""
 265
 266 #. type: SH
 267 #: build/C/man3/iconv.3:142 build/C/man3/iconv_close.3:39 build/C/man3/iconv_open.3:107
 268 #, no-wrap
 269 msgid "CONFORMING TO"
 270 msgstr ""
 271
 272 #. type: Plain text
 273 #: build/C/man3/iconv.3:144
 274 msgid "POSIX.1-2001."
 275 msgstr ""
 276
 277 #. type: SH
 278 #: build/C/man3/iconv.3:144
 279 #, no-wrap
 280 msgid "NOTES"
 281 msgstr ""
 282
 283 #. type: Plain text
 284 #: build/C/man3/iconv.3:156
 285 msgid ""
 286 "Although I<inbuf> and I<outbuf> are typed as I<char\\ **>, this does not "
 287 "mean that the objects they point can be interpreted as C strings or as "
 288 "arrays of characters: the interpretation of character byte sequences is "
 289 "handled internally by the conversion functions.  In some encodings, a zero "
 290 "byte may be a valid part of a multibyte character."
 291 msgstr ""
 292
 293 #. type: Plain text
 294 #: build/C/man3/iconv.3:163
 295 msgid ""
 296 "The caller of B<iconv>()  must ensure that the pointers passed to the "
 297 "function are suitable for accessing characters in the appropriate character "
 298 "set.  This includes ensuring correct alignment on platforms that have tight "
 299 "restrictions on alignment."
 300 msgstr ""
 301
 302 #. type: SH
 303 #: build/C/man3/iconv.3:163 build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
 304 #, no-wrap
 305 msgid "SEE ALSO"
 306 msgstr ""
 307
 308 #. type: Plain text
 309 #: build/C/man3/iconv.3:166
 310 msgid "B<iconv_close>(3), B<iconv_open>(3)"
 311 msgstr ""
 312
 313 #. type: SH
 314 #: build/C/man3/iconv.3:166 build/C/man3/iconv_close.3:44 build/C/man3/iconv_open.3:113
 315 #, no-wrap
 316 msgid "COLOPHON"
 317 msgstr ""
 318
 319 #. type: Plain text
 320 #: build/C/man3/iconv.3:173 build/C/man3/iconv_close.3:51 build/C/man3/iconv_open.3:120
 321 msgid ""
 322 "This page is part of release 3.54 of the Linux I<man-pages> project.  A "
 323 "description of the project, and information about reporting bugs, can be "
 324 "found at \\%http://www.kernel.org/doc/man-pages/."
 325 msgstr ""
 326
 327 #. type: TH
 328 #: build/C/man3/iconv_close.3:14
 329 #, no-wrap
 330 msgid "ICONV_CLOSE"
 331 msgstr ""
 332
 333 #. type: TH
 334 #: build/C/man3/iconv_close.3:14 build/C/man3/iconv_open.3:18
 335 #, no-wrap
 336 msgid "2008-08-11"
 337 msgstr ""
 338
 339 #. type: Plain text
 340 #: build/C/man3/iconv_close.3:17
 341 msgid "iconv_close - deallocate descriptor for character set conversion"
 342 msgstr ""
 343
 344 #. type: Plain text
 345 #: build/C/man3/iconv_close.3:22
 346 #, no-wrap
 347 msgid "B<int iconv_close(iconv_t >I<cd>B<);>\n"
 348 msgstr ""
 349
 350 #. type: Plain text
 351 #: build/C/man3/iconv_close.3:30
 352 msgid ""
 353 "The B<iconv_close>()  function deallocates a conversion descriptor I<cd> "
 354 "previously allocated using B<iconv_open>(3)."
 355 msgstr ""
 356
 357 #. type: Plain text
 358 #: build/C/man3/iconv_close.3:37
 359 msgid ""
 360 "When successful, the B<iconv_close>()  function returns 0.  In case of "
 361 "error, it sets I<errno> and returns -1."
 362 msgstr ""
 363
 364 #. type: Plain text
 365 #: build/C/man3/iconv_close.3:41 build/C/man3/iconv_open.3:109
 366 msgid "UNIX98, POSIX.1-2001."
 367 msgstr ""
 368
 369 #. type: Plain text
 370 #: build/C/man3/iconv_close.3:44
 371 msgid "B<iconv>(3), B<iconv_open>(3)"
 372 msgstr ""
 373
 374 #. type: TH
 375 #: build/C/man3/iconv_open.3:18
 376 #, no-wrap
 377 msgid "ICONV_OPEN"
 378 msgstr ""
 379
 380 #. type: Plain text
 381 #: build/C/man3/iconv_open.3:21
 382 msgid "iconv_open - allocate descriptor for character set conversion"
 383 msgstr ""
 384
 385 #. type: Plain text
 386 #: build/C/man3/iconv_open.3:26
 387 #, no-wrap
 388 msgid ""
 389 "B<iconv_t iconv_open(const char *>I<tocode>B<, const char "
 390 "*>I<fromcode>B<);>\n"
 391 msgstr ""
 392
 393 #. type: Plain text
 394 #: build/C/man3/iconv_open.3:36
 395 msgid ""
 396 "The B<iconv_open>()  function allocates a conversion descriptor suitable for "
 397 "converting byte sequences from character encoding I<fromcode> to character "
 398 "encoding I<tocode>."
 399 msgstr ""
 400
 401 #. type: Plain text
 402 #: build/C/man3/iconv_open.3:50
 403 msgid ""
 404 "The values permitted for I<fromcode> and I<tocode> and the supported "
 405 "combinations are system-dependent.  For the GNU C library, the permitted "
 406 "values are listed by the I<iconv --list> command, and all combinations of "
 407 "the listed values are supported.  Furthermore the GNU C library and the GNU "
 408 "libiconv library support the following two suffixes:"
 409 msgstr ""
 410
 411 #. type: TP
 412 #: build/C/man3/iconv_open.3:50
 413 #, no-wrap
 414 msgid "//TRANSLIT"
 415 msgstr ""
 416
 417 #. type: Plain text
 418 #: build/C/man3/iconv_open.3:59
 419 msgid ""
 420 "When the string \"//TRANSLIT\" is appended to I<tocode>, transliteration is "
 421 "activated.  This means that when a character cannot be represented in the "
 422 "target character set, it can be approximated through one or several "
 423 "similarly looking characters."
 424 msgstr ""
 425
 426 #. type: TP
 427 #: build/C/man3/iconv_open.3:59
 428 #, no-wrap
 429 msgid "//IGNORE"
 430 msgstr ""
 431
 432 #. type: Plain text
 433 #: build/C/man3/iconv_open.3:65
 434 msgid ""
 435 "When the string \"//IGNORE\" is appended to I<tocode>, characters that "
 436 "cannot be represented in the target character set will be silently "
 437 "discarded."
 438 msgstr ""
 439
 440 #. type: Plain text
 441 #: build/C/man3/iconv_open.3:71
 442 msgid ""
 443 "The resulting conversion descriptor can be used with B<iconv>(3)  any number "
 444 "of times.  It remains valid until deallocated using B<iconv_close>(3)."
 445 msgstr ""
 446
 447 #. type: Plain text
 448 #: build/C/man3/iconv_open.3:86
 449 msgid ""
 450 "A conversion descriptor contains a conversion state.  After creation using "
 451 "B<iconv_open>(), the state is in the initial state.  Using B<iconv>(3)  "
 452 "modifies the descriptor's conversion state.  (This implies that a conversion "
 453 "descriptor can not be used in multiple threads simultaneously.)  To bring "
 454 "the state back to the initial state, use B<iconv>(3)  with NULL as I<inbuf> "
 455 "argument."
 456 msgstr ""
 457
 458 #. type: Plain text
 459 #: build/C/man3/iconv_open.3:95
 460 msgid ""
 461 "The B<iconv_open>()  function returns a freshly allocated conversion "
 462 "descriptor.  In case of error, it sets I<errno> and returns I<(iconv_t)\\ "
 463 "-1>."
 464 msgstr ""
 465
 466 #. type: Plain text
 467 #: build/C/man3/iconv_open.3:97
 468 msgid "The following error can occur, among others:"
 469 msgstr ""
 470
 471 #. type: Plain text
 472 #: build/C/man3/iconv_open.3:105
 473 msgid ""
 474 "The conversion from I<fromcode> to I<tocode> is not supported by the "
 475 "implementation."
 476 msgstr ""
 477
 478 #. type: Plain text
 479 #: build/C/man3/iconv_open.3:113
 480 msgid "B<iconv>(1), B<iconv>(3), B<iconv_close>(3)"
 481 msgstr ""