popt-man.ps

linux 命令行处理popt模块说明文档

3.327 E(g)-.37 E F0 .827(is the option')3.327 F 3.327(sa)-.55 G -.18(rg)
-3.327 G 3.327(ument. If).18 F(the)3.327 E .855(option does not tak)108
228 R 3.355(ea)-.1 G 3.355(na)-3.355 G -.18(rg)-3.355 G(ument,).18 E F1
(ar)3.355 E(g)-.37 E F0(is)3.355 E F2(NULL)3.354 E F0 5.854(.T)C .854
(he \214nal parameter)-5.854 F(,)-.4 E F1(data)3.354 E F0 .854(is tak)
3.354 F .854(en from the)-.1 F F1(descrip)3.354 E F0 .662
(\214eld of the option table entry which de\214ned the callback. As)108
240 R F1(descrip)3.162 E F0 .662(is a pointer)3.162 F 3.162(,t)-.4 G
.662(his allo)-3.162 F .663(ws callback)-.25 F(functions to be passed a\
n arbitrary set of data \(though a typecast will ha)108 252 Q .3 -.15
(ve t)-.2 H 2.5(ob).15 G 2.5(eu)-2.5 G(sed\).)-2.5 E .553
(The option table entry which de\214nes a callback has an)108 276 R F1
(ar)3.053 E(gInfo)-.37 E F0(of)3.053 E F2(POPT_ARG_CALLB)3.053 E -.55
(AC)-.3 G(K).55 E F0 3.053(,a)C(n)-3.053 E F1(ar)3.053 E(g)-.37 E F0
1.427(which points to the callback function, and a)108 288 R F1(descrip)
3.927 E F0 1.427(\214eld which speci\214es an arbitrary pointer to be)
3.927 F(passed to the callback.)108 300 Q F2(2. CREA)87 316.8 Q
(TING A CONTEXT)-.95 E F0 1.088(popt can interlea)108 328.8 R 1.388 -.15
(ve t)-.2 H 1.088(he parsing of multiple command-line sets. It allo).15
F 1.088(ws this by k)-.25 F 1.087(eeping all the state)-.1 F .137
(information for a particular set of command-line ar)108 340.8 R .138
(guments in a)-.18 F F2(poptContext)2.638 E F0 .138
(data structure, an opaque)2.638 F
(type that should not be modi\214ed outside the popt library)108 352.8 Q
(.)-.65 E(Ne)108 376.8 Q 2.5(wp)-.25 G(opt conte)-2.5 E
(xts are created by)-.15 E F2(poptGetContext\(\))2.5 E F0(:)A F2
(poptContext poptGetContext\(const char *)108 400.8 Q F1(name)2.86 E F2
2.5(,i).18 G(nt)-2.5 E F1(ar)2.83 E(gc)-.37 E F2(,).31 E(const char **)
175.5 412.8 Q F1(ar)2.83 E(gv)-.37 E F2(,).32 E
(const struct poptOption *)175.5 424.8 Q F1(options)2.73 E F2(,).27 E
(int)175.5 436.8 Q F1<8d61>4.41 E(gs)-.1 E F2(\);).27 E F0 .171
(The \214rst parameter)108 460.8 R(,)-.4 E F1(name)2.671 E F0 2.671(,i)
.18 G 2.671(su)-2.671 G .17(sed only for alias handling \(discussed lat\
er\). It should be the name of the)-2.671 F .888
(application whose options are being parsed, or should be)108 472.8 R F2
(NULL)3.388 E F0 .888(if no option aliasing is desired. The)3.388 F(ne)
108 484.8 Q .327(xt tw)-.15 F 2.827(oa)-.1 G -.18(rg)-2.827 G .327
(uments specify the command-line ar).18 F .327
(guments to parse. These are generally passed to)-.18 F F2(popt-)2.826 E
(GetContext\(\))108 496.8 Q F0 -.15(ex)3.769 G 1.269(actly as the).15 F
3.769(yw)-.15 G 1.27(ere passed to the program')-3.769 F(s)-.55 E F2
(main\(\))3.77 E F0 1.27(function. The)3.77 F F1(options)3.77 E F0
(parameter)4.04 E 1.285
(points to the table of command-line options, which w)108 508.8 R 1.285
(as described in the pre)-.1 F 1.285(vious section. The \214nal)-.25 F
(parameter)108 520.8 Q(,)-.4 E F1<8d61>2.5 E(gs)-.1 E F0 2.5(,c).27 G
(an tak)-2.5 E 2.5(eo)-.1 G(ne of three v)-2.5 E(alues:)-.25 E F2 -.92
(Va)108 532.8 S 164.54(lue Description).92 F(POPT_CONTEXT_NO_EXEC)108
544.8 Q F0(Ignore e)57.22 E -.15(xe)-.15 G 2.5(ce).15 G(xpansions)-2.65
E F2(POPT_CONTEXT_KEEP_FIRST)108 556.8 Q F0(Do not ignore ar)43.32 E
(gv[0])-.18 E F2(POPT_CONTEXT_POSIXMEHARDER)108 568.8 Q F0
(Options cannot follo)15 E 2.5(wa)-.25 G -.18(rg)-2.5 G(uments).18 E(A)
108 592.8 Q F2(poptContext)2.665 E F0 -.1(ke)2.665 G .165
(eps track of which options ha).1 F .466 -.15(ve a)-.2 H .166
(lready been parsed and which remain, among other).15 F .152(things. If\
 a program wishes to restart option processing of a set of ar)108 604.8
R .152(guments, it can reset the)-.18 F F2(poptCon-)2.651 E(text)108
616.8 Q F0(by passing the conte)2.5 E(xt as the sole ar)-.15 E
(gument to)-.18 E F2(poptResetContext\(\))2.5 E F0(.)A .176(When ar)108
640.8 R .176(gument processing is complete, the process should free the)
-.18 F F2(poptContext)2.676 E F0 .176(as it contains dynam-)2.676 F
1.248(ically allocated components. The)108 652.8 R F2(poptFr)3.748 E
(eeContext\(\))-.18 E F0 1.248(function tak)3.748 F 1.248(es a)-.1 F F2
(poptContext)3.748 E F0 1.248(as its sole ar)3.748 F(gu-)-.18 E
(ment and frees the resources the conte)108 664.8 Q(xt is using.)-.15 E
(Here are the prototypes of both)108 688.8 Q F2(poptResetContext\(\))2.5
E F0(and)2.5 E F2(poptFr)2.5 E(eeContext\(\))-.18 E F0(:)A F2
(#include <popt.h>)108 712.8 Q -.1(vo)108 724.8 S(id poptFr).1 E
(eeContext\(poptContext)-.18 E F1(con)2.7 E F2(\);).24 E -.1(vo)108
736.8 S(id poptResetContext\(poptContext).1 E F1(con)2.7 E F2(\);).24 E
F0 192.723(4J)72 817.889 S(une 30, 1998)-192.723 E 0 Cg EP
%%Page: 5 5
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 128.978(POPT\(3\) Linux)72 48 R(Programmer')2.5
E 2.5(sM)-.55 G 128.977(anual POPT\(3\))-2.5 F/F1 10/Times-Bold@0 SF
(3. P)87 84 Q(ARSING THE COMMAND LINE)-.74 E F0 .936
(After an application has created a)108 96 R F1(poptContext)3.436 E F0
3.436(,i)C 3.436(tm)-3.436 G .936(ay be)-3.436 F .937(gin parsing ar)
-.15 F(guments.)-.18 E F1(poptGetNextOpt\(\))3.437 E F0
(performs the actual ar)108 108 Q(gument parsing.)-.18 E F1
(#include <popt.h>)108 132 Q(int poptGetNextOpt\(poptContext)108 144 Q
/F2 10/Times-Italic@0 SF(con)2.7 E F1(\);).24 E F0 -.8(Ta)108 168 S
1.001(king the conte).8 F 1.001(xt as its sole ar)-.15 F 1
(gument, this function parses the ne)-.18 F 1(xt command-line ar)-.15 F
1(gument found.)-.18 F 1.192(After \214nding the ne)108 180 R 1.192
(xt ar)-.15 F 1.192(gument in the option table, the function \214lls in\
 the object pointed to by the)-.18 F .53(option table entry')108 192 R
(s)-.55 E F2(ar)3.36 E(g)-.37 E F0 .529(pointer if it is not)3.03 F F1
(NULL)3.029 E F0 3.029(.I)C 3.029(ft)-3.029 G .529(he v)-3.029 F .529
(al entry for the option is non-0, the function)-.25 F
(then returns that v)108 204 Q(alue. Otherwise,)-.25 E F1
(poptGetNextOpt\(\))2.5 E F0(continues on to the ne)2.5 E(xt ar)-.15 E
(gument.)-.18 E F1(poptGetNextOpt\(\))108 228 Q F0 .04
(returns -1 when the \214nal ar)2.54 F .04
(gument has been parsed, and other ne)-.18 F -.05(ga)-.15 G(ti).05 E
.341 -.15(ve v)-.25 H .041(alues when)-.1 F(errors occur)108 240 Q 2.5
(.T)-.55 G(his mak)-2.5 E(es it a good idea to k)-.1 E(eep the)-.1 E F2
(val)2.79 E F0(elements in the options table greater than 0.)3.01 E .483
(If all of the command-line options are handled through)108 264 R F2(ar)
3.313 E(g)-.37 E F0 .483(pointers, command-line parsing is reduced)2.983
F(to the follo)108 276 Q(wing line of code:)-.25 E(rc = poptGetNe)108
300 Q(xtOpt\(poptcon\);)-.15 E(Man)108 324 Q 2.628(ya)-.15 G .128
(pplications require more comple)-2.628 F 2.628(xc)-.15 G .128
(ommand-line parsing than this, ho)-2.628 F(we)-.25 E -.15(ve)-.25 G
.928 -.4(r, a).15 H .128(nd use the follo).4 F(w-)-.25 E(ing structure:)
108 336 Q(while \(\(rc = poptGetNe)108 360 Q(xtOpt\(poptcon\)\) > 0\) {)
-.15 E(switch \(rc\) {)120.5 372 Q(/* speci\214c ar)133 384 Q
(guments are handled here */)-.18 E(})120.5 396 Q(})108 408 Q .057
(When returned options are handled, the application needs to kno)108 432
R 2.557(wt)-.25 G .057(he v)-2.557 F .057(alue of an)-.25 F 2.557(ya)
-.15 G -.18(rg)-2.557 G .057(uments that were).18 F .554
(speci\214ed after the option. There are tw)108 444 R 3.054(ow)-.1 G
.554(ays to disco)-3.154 F -.15(ve)-.15 G 3.054(rt).15 G .554
(hem. One is to ask popt to \214ll in a v)-3.054 F(ariable)-.25 E .741
(with the v)108 456 R .74(alue of the option through the option table')
-.25 F(s)-.55 E F2(ar)3.57 E(g)-.37 E F0 .74
(elements. The other is to use)3.46 F F1(poptGetOp-)3.24 E(tAr)108 468 Q
(g\(\))-.1 E F0(:)A F1(#include <popt.h>)108 492 Q
(const char * poptGetOptAr)108 504 Q(g\(poptContext)-.1 E F2(con)2.7 E
F1(\);).24 E F0 1.751(This function returns the ar)108 528 R 1.751
(gument gi)-.18 F -.15(ve)-.25 G 4.251(nf).15 G 1.751
(or the \214nal option returned by)-4.251 F F1(poptGetNextOpt\(\))4.251
E F0 4.251(,o)C 4.252(ri)-4.251 G(t)-4.252 E(returns)108 540 Q F1(NULL)
2.5 E F0(if no ar)2.5 E(gument w)-.18 E(as speci\214ed.)-.1 E F1
(4. LEFT)87 568.8 Q -.5(OV)-.18 G(ER ARGUMENTS).5 E F0(Man)108 580.8 Q
3.348(ya)-.15 G .848(pplications tak)-3.348 F 3.348(ea)-.1 G 3.348(na)
-3.348 G .848(rbitrary number of command-line ar)-3.348 F .847
(guments, such as a list of \214le names.)-.18 F .453
(When popt encounters an ar)108 592.8 R .453(gument that does not be)
-.18 F .454(gin with a -, it assumes it is such an ar)-.15 F .454
(gument and)-.18 F(adds it to a list of lefto)108 604.8 Q -.15(ve)-.15 G
2.5(ra).15 G -.18(rg)-2.5 G(uments. Three functions allo).18 E 2.5(wa)
-.25 G(pplications to access such ar)-2.5 E(guments:)-.18 E F1
(const char * poptGetAr)108 621.6 Q(g\(poptContext)-.1 E F2(con)2.7 E F1
(\);).24 E F0(This function returns the ne)144 633.6 Q(xt lefto)-.15 E
-.15(ve)-.15 G 2.5(ra).15 G -.18(rg)-2.5 G
(ument and marks it as processed.).18 E F1(const char * poptP)108 655.2
Q(eekAr)-.2 E(g\(poptContext)-.1 E F2(con)2.7 E F1(\);).24 E F0 .713
(The ne)144 667.2 R .713(xt lefto)-.15 F -.15(ve)-.15 G 3.213(ra).15 G
-.18(rg)-3.213 G .713(ument is returned b).18 F .713(ut not mark)-.2 F
.712(ed as processed.)-.1 F .712(This allo)5.712 F .712(ws an applica-)
-.25 F(tion to look ahead into the ar)144 679.2 Q
(gument list, without modifying the list.)-.18 E F1
(const char ** poptGetAr)108 700.8 Q(gs\(poptContext)-.1 E F2(con)2.7 E
F1(\);).24 E F0 .235(All the lefto)144 712.8 R -.15(ve)-.15 G 2.735(ra)
.15 G -.18(rg)-2.735 G .235
(uments are returned in a manner identical to).18 F F2(ar)2.735 E(gv)
-.37 E F0 5.236(.T).32 G .236(he \214nal element in the)-5.236 F
(returned array points to)144 724.8 Q F1(NULL)2.5 E F0 2.5(,i)C
(ndicating the end of the ar)-2.5 E(guments.)-.18 E F1(5. A)87 753.6 Q
(UT)-.5 E(OMA)-.18 E(TIC HELP MESSA)-.95 E(GES)-.55 E F0(The)108 765.6 Q
F1(popt)4.515 E F0 2.014(library can automatically generate help messag\
es which describe the options a program)4.515 F 1.246
(accepts. There are tw)108 777.6 R 3.746(ot)-.1 G 1.247(ypes of help me\
ssages which can be generated. Usage messages are a short)-3.746 F
(June 30, 1998)269.723 817.889 Q(5)192.722 E 0 Cg EP
%%Page: 6 6
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 128.978(POPT\(3\) Linux)72 48 R(Programmer')2.5
E 2.5(sM)-.55 G 128.977(anual POPT\(3\))-2.5 F .255
(messages which lists v)108 84 R .255(alid options, b)-.25 F .255
(ut does not describe them. Help messages describe each option on)-.2 F
1.219(one \(or more\) lines, resulting in a longer)108 96 R 3.72(,b)-.4
G 1.22(ut more useful, message. Whene)-3.92 F -.15(ve)-.25 G 3.72(ra).15
G 1.22(utomatic help mes-)-3.72 F .621(sages are used, the)108 108 R/F1
10/Times-Bold@0 SF(descrip)3.121 E F0(and)3.121 E F1(ar)3.12 E(gDescrip)
-.1 E F0(\214elds)3.12 E F1 .62(struct poptOption)3.12 F F0 .62
(members should be \214lled in for)3.12 F(each option.)108 120 Q(The)108
144 Q F1(POPT_A)3.312 E(UT)-.5 E(OHELP)-.18 E F0 .812(macro mak)3.312 F
.812(es it easy to add)-.1 F F1(--usage)3.313 E F0(and)3.313 E F1
(--help)3.313 E F0 .813(messages to your program,)3.313 F .283(and is d\
escribed in part 1 of this man page. If more control is needed o)108 156
R -.15(ve)-.15 G 2.782(ry).15 G .282(our help messages, the fol-)-2.782
F(lo)108 168 Q(wing tw)-.25 E 2.5(of)-.1 G(unctions are a)-2.5 E -.25
(va)-.2 G(ilable:).25 E F1(#include <popt.h>)108 192 Q -.1(vo)108 204 S
(id poptPrintHelp\(poptContext).1 E/F2 10/Times-Italic@0 SF(con)2.7 E F1
2.5(,F).24 G(ILE *)-2.5 E F2(f)4.47 E F1 2.5(,i)1.96 G(nt)-2.5 E F2
<8d61>4.41 E(gs)-.1 E F1(\);).27 E -.1(vo)108 216 S
(id poptPrintUsage\(poptContext).1 E F2(con)2.7 E F1 2.5(,F).24 G(ILE *)
-2.5 E F2(f)4.47 E F1 2.5(,i)1.96 G(nt)-2.5 E F2<8d61>4.41 E(gs)-.1 E F1
(\);).27 E(poptPrintHelp\(\))108 240 Q F0 1.433(displays the standard h\
elp message to the stdio \214le descriptor f, while)3.933 F F1
(poptPrint-)3.934 E(Usage\(\))108 252 Q F0 .968(displays the shorter us\
age message. Both functions currently ignore the)3.469 F F1(\215ags)
3.468 E F0(ar)3.468 E .968(gument; it is)-.18 F(there to allo)108 264 Q
2.5(wf)-.25 G(uture changes.)-2.5 E/F3 10.95/Times-Bold@0 SF(ERR)72
292.8 Q(OR HANDLING)-.329 E F0 .557
(All of the popt functions that can return errors return inte)108 304.8
R 3.057(gers. When)-.15 F .558(an error occurs, a ne)3.058 F -.05(ga)
-.15 G(ti).05 E .858 -.15(ve e)-.25 H(rror).15 E
(code is returned. The follo)108 316.8 Q
(wing table summarizes the error codes that occur:)-.25 E F1(Err)120.5
340.8 Q 52.5(or Description)-.18 F(POPT_ERR)108 352.8 Q(OR_NO)-.3 E(ARG)
-.4 E F0(Ar)17.5 E(gument missing for an option.)-.18 E F1(POPT_ERR)108
364.8 Q(OR_B)-.3 E(ADOPT)-.3 E F0(Option')15 E 2.5(sa)-.55 G -.18(rg)
-2.5 G(ument couldn').18 E 2.5(tb)-.18 G 2.5(ep)-2.5 G(arsed.)-2.5 E F1
(POPT_ERR)108 376.8 Q(OR_OPTST)-.3 E(OODEEP)-.18 E F0
(Option aliasing nested too deeply)2.5 E(.)-.65 E F1(POPT_ERR)108 388.8
Q(OR_B)-.3 E(ADQ)-.3 E(UO)-.1 E(TE)-.4 E F0(Quotations do not match.)10
E F1(POPT_ERR)108 400.8 Q(OR_B)-.3 E(ADNUMBER)-.3 E F0(Option couldn')
7.5 E 2.5(tb)-.18 G 2.5(ec)-2.5 G(on)-2.5 E -.15(ve)-.4 G
(rted to number).15 E(.)-.55 E F1(POPT_ERR)108 412.8 Q(OR_O)-.3 E
(VERFLO)-.5 E(W)-.5 E F0 2.5(Ag)10 G -2.15 -.25(iv e)-2.5 H 2.5(nn).25 G
(umber w)-2.5 E(as too big or small.)-.1 E
(Here is a more detailed discussion of each error:)108 436.8 Q F1
(POPT_ERR)108 465.6 Q(OR_NO)-.3 E(ARG)-.4 E F0 .265
(An option that requires an ar)144 477.6 R .265(gument w)-.18 F .265
(as speci\214ed on the command line, b)-.1 F .265(ut no ar)-.2 F .265
(gument w)-.18 F(as)-.1 E(gi)144 489.6 Q -.15(ve)-.25 G
(n. This can be returned only by).15 E F1(poptGetNextOpt\(\))2.5 E F0(.)
A F1(POPT_ERR)108 518.4 Q(OR_B)-.3 E(ADOPT)-.3 E F0 .441(An option w)144
530.4 R .441(as speci\214ed in)-.1 F F2(ar)3.271 E(gv)-.37 E F0 -.2(bu)
3.261 G 2.941(ti).2 G 2.941(sn)-2.941 G .442
(ot in the option table. This error can be returned only)-2.941 F(from)
144 542.4 Q F1(poptGetNextOpt\(\))2.5 E F0(.)A F1(POPT_ERR)108 571.2 Q
(OR_OPTST)-.3 E(OODEEP)-.18 E F0 3.203(As)144 583.2 S .702
(et of option aliases is nested too deeply)-3.203 F 3.202(.C)-.65 G
(urrently)-3.202 E 3.202(,p)-.65 G .702(opt follo)-3.202 F .702
(ws options only 10 le)-.25 F -.15(ve)-.25 G .702(ls to).15 F(pre)144
595.2 Q -.15(ve)-.25 G(nt in\214nite recursion. Only).15 E F1
(poptGetNextOpt\(\))2.5 E F0(can return this error)2.5 E(.)-.55 E F1
(POPT_ERR)108 624 Q(OR_B)-.3 E(ADQ)-.3 E(UO)-.1 E(TE)-.4 E F0 6.421(Ap)
144 636 S 3.921(arsed string has a quotation mismatch \(such as a singl\
e quotation mark\).)-6.421 F F1(popt-)6.422 E -.1(Pa)144 648 S(rseAr).1
E(gvString\(\))-.1 E F0(,)A F1(poptReadCon\214gFile\(\))5.66 E F0 5.659
(,o)C(r)-5.659 E F1(poptReadDefaultCon\214g\(\))5.659 E F0 3.159
(can return this)5.659 F(error)144 660 Q(.)-.55 E F1(POPT_ERR)108 688.8
Q(OR_B)-.3 E(ADNUMBER)-.3 E F0 2.677(Ac)144 700.8 S(on)-2.677 E -.15(ve)
-.4 G .178(rsion from a string to a number \(int or long\) f).15 F .178
(ailed due to the string containing nonnu-)-.1 F 1.827
(meric characters. This occurs when)144 712.8 R F1(poptGetNextOpt\(\))
4.327 E F0 1.827(is processing an ar)4.327 F 1.826(gument of type)-.18 F
F1(POPT_ARG_INT)144 724.8 Q F0(,)A F1(POPT_ARG_LONG)3.098 E F0 3.099(,P)
C(OPT_ARG_FLO)-3.099 E -1.11(AT)-.35 G F1 3.099(,o)1.11 G(r)-3.099 E F0
(POPT_ARG_DOUBLE)3.099 E F1(.)A(POPT_ERR)108 753.6 Q(OR_O)-.3 E(VERFLO)
-.5 E(W)-.5 E F0 4.025(As)144 765.6 S 1.525(tring-to-number con)-4.025 F
-.15(ve)-.4 G 1.525(rsion f).15 F 1.524(ailed because the number w)-.1 F
1.524(as too lar)-.1 F 1.524(ge or too small. Lik)-.18 F(e)-.1 E F1
(POPT_ERR)144 777.6 Q(OR_B)-.3 E(ADNUMBER)-.3 E F0 5.58(,t)C 3.081
(his error can occur only when)-5.58 F F1(poptGetNextOpt\(\))5.581 E F0
(is)5.581 E 192.723(6J)72 817.889 S(une 30, 1998)-192.723 E 0 Cg EP
%%Page: 7 7
%%BeginPageSetup
BP
%%EndPageSetup
/F0 10/Times-Roman@0 SF 128.978(POPT\(3\) Linux)72 48 R(Programmer')2.5
E 2.5(sM)-.55 G 128.977(anual POPT\(3\))-2.5 F 13.153(processing an ar)
144 84 R 13.153(gument of type)-.18 F/F1 10/Times-Bold@0 SF
(POPT_ARG_INT)15.652 E F0(,)A F1(POPT_ARG_LONG)15.652 E F0(,)A
(POPT_ARG_FLO)144 96 Q -1.11(AT)-.35 G F1 2.5(,o)1.11 G(r)-2.5 E F0
(POPT_ARG_DOUBLE)2.5 E F1(.)A(POPT_ERR)108 124.8 Q(OR_ERRNO)-.3 E F0
3.397(As)144 136.8 S .898(ystem call returned with an error)-3.397 F
3.398(,a)-.4 G(nd)-3.398 E/F2 10/Times-Italic@0 SF(errno)3.588 E F0 .898
(still contains the error from the system call.)3.578 F(Both)144 148.8 Q
F1(poptReadCon\214gFile\(\))2.5 E F0(and)2.5 E F1
(poptReadDefaultCon\214g\(\))2.5 E F0(can return this error)2.5 E(.)-.55
E -1 -.8(Tw o)108 177.6 T(functions are a)3.3 E -.25(va)-.2 G
(ilable to mak).25 E 2.5(ei)-.1 G 2.5(te)-2.5 G
(asy for applications to pro)-2.5 E(vide good error messages.)-.15 E F1
(const char *const poptStr)108 194.4 Q(err)-.18 E(or\(const int)-.18 E
F2(err)2.69 E(or)-.45 E F1(\);).73 E F0 .416(This function tak)144 206.4
R .416(es a popt error code and returns a string describing the error)
-.1 F 2.915(,j)-.4 G .415(ust as with the)-2.915 F(standard)144 218.4 Q
F1(str)2.5 E(err)-.18 E(or\(\))-.18 E F0(function.)2.5 E F1
(const char * poptBadOption\(poptContext)108 240 Q F2(con)2.7 E F1 2.5
(,i).24 G(nt)-2.5 E F2<8d61>4.41 E(gs)-.1 E F1(\);).27 E F0 .121
(If an error occurred during)144 252 R F1(poptGetNextOpt\(\))2.621 E F0
2.621(,t)C .121(his function returns the option that caused the)-2.621 F
(error)144 264 Q 2.957(.I)-.55 G 2.957(ft)-2.957 G(he)-2.957 E F2<8d61>
4.867 E(gs)-.1 E F0(ar)3.227 E .457(gument is set to)-.18 F F1(POPT_B)
2.957 E(ADOPTION_NO)-.3 E(ALIAS)-.4 E F0 2.957(,t)C .456
(he outermost option)-2.957 F .18(is returned. Otherwise,)144 276 R F2
<8d61>4.59 E(gs)-.1 E F0 .18
(should be 0, and the option that is returned may ha)2.95 F .481 -.15