← Back to branch summary

~ubuntu-branches/ubuntu/vivid/kde-l10n-pt/vivid-proposed

« back to all changes in this revision

Viewing changes to docs/kdewebdev/kommander/specials.docbook

  • Committer: Package Import Robot
  • Author(s): Jonathan Riddell
  • Date: 2015-01-21 12:33:46 UTC
  • mfrom: (1.2.6)
  • Revision ID: package-import@ubuntu.com-20150121123346-14ecgc4xjvggod91
Tags: 4:14.12.2-0ubuntu1
* New upstream release, first version from KDE Applications
* Revert install to /usr/share/locale/
* Add debian/overlapping files to remove files that are in plasma5

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/kdewebdev/kommander/specials.docbook
1
 
<?xml version="1.0"  encoding="UTF-8" ?>
2
 
 
3
 
<sect1 id="specials">
4
 
<sect1info>
5
 
<title
6
 
>Especiais e Variáveis Globais Incorporadas</title>
7
 
<authorgroup>
8
 
<author
9
 
><firstname
10
 
></firstname
11
 
> <surname
12
 
></surname
13
 
> <affiliation
14
 
><address
15
 
> <email
16
 
></email>
17
 
</address
18
 
></affiliation>
19
 
</author>
20
 
 
21
 
<othercredit role="translator"
22
 
><firstname
23
 
>José</firstname
24
 
><surname
25
 
>Pires</surname
26
 
><affiliation
27
 
><address
28
 
><email
29
 
>zepires@gmail.com</email
30
 
></address
31
 
></affiliation
32
 
><contrib
33
 
>Tradução</contrib
34
 
></othercredit
35
 
> 
36
 
 
37
 
</authorgroup>
38
 
</sect1info>
39
 
 
40
 
<title
41
 
>Especiais e Variáveis Globais Incorporadas</title>
42
 
 
43
 
<para
44
 
>Os especiais são funções que são processadas pelo &kommander;. Você deverá saber que, até o &kommander; ter um processador completo, todos os especiais do &kommander; serão executados primeiro e só então o programa será executado. Na maioria dos casos isto não será um problema, mas em alguns deles será. </para>
45
 
 
46
 
<variablelist>
47
 
<varlistentry>
48
 
<term
49
 
><function
50
 
>@dcop(<parameter
51
 
>idApl</parameter
52
 
>, <parameter
53
 
>objecto</parameter
54
 
>, <parameter
55
 
>função</parameter
56
 
>, <parameter
57
 
>argumentos</parameter
58
 
>)</function
59
 
></term>
60
 
<listitem>
61
 
<para
62
 
>Faz uma chamada de &DCOP;. @dcop(<quote
63
 
>kmail</quote
64
 
>, <quote
65
 
>KMailIface</quote
66
 
>, <quote
67
 
>checkMail()</quote
68
 
>, <quote
69
 
></quote
70
 
>) </para>
71
 
</listitem>
72
 
</varlistentry>
73
 
 
74
 
<varlistentry>
75
 
<term
76
 
><function
77
 
>@dcopid</function
78
 
></term>
79
 
<listitem>
80
 
<para
81
 
>O ID de &DCOP; do processo. (kmdr-executor-@pid) </para>
82
 
</listitem>
83
 
</varlistentry>
84
 
 
85
 
<varlistentry>
86
 
<term
87
 
><function
88
 
>@dialog(<parameter
89
 
>janela</parameter
90
 
>[,<parameter
91
 
>parâmetros</parameter
92
 
>])</function
93
 
></term>
94
 
<listitem>
95
 
<para
96
 
>Lança a janela do Kommander indicada. A janela é vista na pasta da janela e na pasta actual - por esta ordem. Isto antecede a chamada ao executor e muda a pasta por omissão para a pasta onde o ficheiro do Kommander se encontra. Os parâmetros podem ser passados da forma normal do Unix ou você poderá passar parâmetros com nomes no formato <quote
97
 
>variavel=valor</quote
98
 
>. Você poderá então encontrar os parâmetros passados na lista de variáveis globais. O @global(variavel) iria devolver <quote
99
 
>valor</quote
100
 
>. </para>
101
 
</listitem>
102
 
</varlistentry>
103
 
 
104
 
<varlistentry>
105
 
<term
106
 
><function
107
 
>@env(<parameter
108
 
>variavelAmbiente</parameter
109
 
>)</function
110
 
></term>
111
 
<listitem>
112
 
<para
113
 
>Expande-se para a variável de ambiente. O @env(PWD) expande-se para o $PWD. Lembre-se que o <quote
114
 
>$</quote
115
 
> faz parte da linha de comandos e não deverá ser usado. </para>
116
 
</listitem>
117
 
</varlistentry>
118
 
 
119
 
<varlistentry>
120
 
<term
121
 
><function
122
 
>@exec(<parameter
123
 
>comando</parameter
124
 
>)</function
125
 
></term>
126
 
<listitem>
127
 
<para
128
 
>devolve o resultado de executar o comando indicado. @exec(ls -l). </para>
129
 
</listitem>
130
 
</varlistentry>
131
 
 
132
 
<varlistentry>
133
 
<term
134
 
><function
135
 
>@execBegin ... @execEnd</function
136
 
></term>
137
 
<listitem>
138
 
<para
139
 
>o mesmo que o <function
140
 
>@exec</function
141
 
>, mas suporta o 'shebang' e 'scripts' de várias linhas. Isto serve para várias linguagens de programação, declarando-as ou utilizando um 'shebang'. </para>
142
 
<itemizedlist>
143
 
<listitem
144
 
><para
145
 
><function
146
 
>@execBegin(php)</function
147
 
></para
148
 
></listitem>
149
 
<listitem
150
 
><para
151
 
><function
152
 
>@execBegin</function
153
 
>#!/usr/bin/php</para
154
 
></listitem>
155
 
</itemizedlist>
156
 
<para
157
 
>O primeiro usa o nome do executável do <acronym
158
 
>PHP</acronym
159
 
>. O &kommander; procura na PATH pelo <application
160
 
>php</application
161
 
> e, se não for encontrado, verifica se está registado no &kommander; numa localização fora da sua PATH. Se não estiver, diz ao utilizador que não pôde ser encontrado. O segundo exemplo usa o clássico <quote
162
 
>shebang</quote
163
 
>, o qual poderá ter alguns benefícios, assim como alguns problemas. Se você tiver uma versão beta do <acronym
164
 
>PHP5</acronym
165
 
>, por exemplo, no <filename
166
 
>/usr/local/bin</filename
167
 
>, a mesma não seria encontrada porque iria obter primeiro a versão em <filename
168
 
>/usr/bin</filename
169
 
>. Se, por outro lado, você distribuir a janela para alguém que tenha o <acronym
170
 
>PHP</acronym
171
 
> no <filename
172
 
>/usr/local/bin</filename
173
 
> apenas, ela não seria encontrada com o 'shebang' usado. Por isso, usar 'shebangs' deverá necessitar de cuidado e a utilização do executável é recomendada se estiver a partilhar ficheiros.</para>
174
 
</listitem>
175
 
</varlistentry>
176
 
 
177
 
<varlistentry>
178
 
<term
179
 
><function
180
 
>@global(<parameter
181
 
>variável</parameter
182
 
>)</function
183
 
></term>
184
 
<listitem>
185
 
<para
186
 
>expande para o valor da variável global indicada. </para>
187
 
</listitem>
188
 
</varlistentry>
189
 
 
190
 
<varlistentry>
191
 
<term
192
 
><function
193
 
>@null</function
194
 
></term>
195
 
<listitem>
196
 
<para
197
 
>Devolve um valor nulo. Agora que o Kommander verifica pelo 'widgetText' vazio durante a execução, isto irá evitar erros no caso de um estado indefinido de um elemento.</para>
198
 
</listitem>
199
 
</varlistentry>
200
 
 
201
 
<varlistentry>
202
 
<term
203
 
><function
204
 
>@parentPid</function
205
 
></term>
206
 
<listitem>
207
 
<para
208
 
>O &PID; do processo-pai. </para>
209
 
</listitem>
210
 
</varlistentry>
211
 
 
212
 
<varlistentry>
213
 
<term
214
 
><function
215
 
>@pid</function
216
 
></term>
217
 
<listitem>
218
 
<para
219
 
>O &PID; do processo. </para>
220
 
</listitem>
221
 
</varlistentry>
222
 
 
223
 
<varlistentry>
224
 
<term
225
 
><function
226
 
>@readSetting(<parameter
227
 
>chave</parameter
228
 
>, <parameter
229
 
>valorPorOmissao</parameter
230
 
>)</function
231
 
></term>
232
 
<listitem>
233
 
<para
234
 
>lê um valor do <filename
235
 
>kommanderrc</filename
236
 
> </para>
237
 
</listitem>
238
 
</varlistentry>
239
 
 
240
 
<varlistentry>
241
 
<term
242
 
><function
243
 
>@selectedWidgetText</function
244
 
></term>
245
 
<listitem>
246
 
<para
247
 
>O conteúdo seleccionado de um elemento gráfico que possa mostrar mais do que um valor, como por exemplo as listas </para>
248
 
</listitem>
249
 
</varlistentry>
250
 
 
251
 
<varlistentry>
252
 
<term
253
 
><function
254
 
>@setGlobal(<parameter
255
 
>variável</parameter
256
 
>, <parameter
257
 
>valor</parameter
258
 
>)</function
259
 
></term>
260
 
<listitem>
261
 
<para
262
 
>Configura a variável global para o valor indicado. </para>
263
 
</listitem>
264
 
</varlistentry>
265
 
 
266
 
<varlistentry>
267
 
<term
268
 
><function
269
 
>@widgetText</function
270
 
></term>
271
 
<listitem>
272
 
<para
273
 
>o conteúdo de um elemento </para>
274
 
</listitem>
275
 
</varlistentry>
276
 
 
277
 
<varlistentry>
278
 
<term
279
 
><function
280
 
>@writeSetting(<parameter
281
 
>chave</parameter
282
 
>, <parameter
283
 
>valor</parameter
284
 
>)</function
285
 
></term>
286
 
<listitem>
287
 
<para
288
 
>grava o valor no <filename
289
 
>kommanderrc</filename
290
 
> </para>
291
 
</listitem>
292
 
</varlistentry>
293
 
</variablelist>
294
 
 
295
 
<sect2 id="arrays">
296
 
<title
297
 
>Grupo de Funções de Listas</title>
298
 
 
299
 
<variablelist>
300
 
<varlistentry>
301
 
<term
302
 
><function
303
 
>@Array.values(<parameter
304
 
>lista</parameter
305
 
>)</function
306
 
></term>
307
 
<listitem>
308
 
<para
309
 
>Devolve uma lista separada por EOL's de todos os valores da lista. Pode ser usada para percorrer uma lista.</para>
310
 
</listitem>
311
 
</varlistentry>
312
 
 
313
 
<varlistentry>
314
 
<term
315
 
><function
316
 
>@Array.keys(<parameter
317
 
>lista</parameter
318
 
>)</function
319
 
></term>
320
 
<listitem>
321
 
<para
322
 
>Devolve uma lista separada por EOL's de todas as chaves da lista.</para>
323
 
</listitem>
324
 
</varlistentry>
325
 
 
326
 
<varlistentry>
327
 
<term
328
 
><function
329
 
>@Array.setValue(<parameter
330
 
>lista</parameter
331
 
>, <parameter
332
 
>chave</parameter
333
 
>, <parameter
334
 
>valor</parameter
335
 
>)</function
336
 
></term>
337
 
<listitem>
338
 
<para
339
 
>Define um chave e um valor para um elemento da lista. Se não existir nenhuma lista, esta é criada.</para>
340
 
</listitem>
341
 
</varlistentry>
342
 
 
343
 
<varlistentry>
344
 
<term
345
 
><function
346
 
>@Array.clear(<parameter
347
 
>lista</parameter
348
 
>)</function
349
 
></term>
350
 
<listitem>
351
 
<para
352
 
>Remove todos os elementos da lista.</para>
353
 
</listitem>
354
 
</varlistentry>
355
 
 
356
 
<varlistentry>
357
 
<term
358
 
><function
359
 
>@Array.count(<parameter
360
 
>lista</parameter
361
 
>)</function
362
 
></term>
363
 
<listitem>
364
 
<para
365
 
>Devolve o número de elementos na lista.</para>
366
 
</listitem>
367
 
</varlistentry>
368
 
 
369
 
<varlistentry>
370
 
<term
371
 
><function
372
 
>@Array.value(<parameter
373
 
>lista</parameter
374
 
>,<parameter
375
 
>chave</parameter
376
 
>)</function
377
 
></term>
378
 
<listitem>
379
 
<para
380
 
>Devolve o valor associado à chave indicado.</para>
381
 
</listitem>
382
 
</varlistentry>
383
 
 
384
 
<varlistentry>
385
 
<term
386
 
><function
387
 
>@Array.remove(<parameter
388
 
>lista</parameter
389
 
>,<parameter
390
 
>chave</parameter
391
 
>)</function
392
 
></term>
393
 
<listitem>
394
 
<para
395
 
>Remove o elemento com a chave indicada da lista.</para>
396
 
</listitem>
397
 
</varlistentry>
398
 
 
399
 
<varlistentry>
400
 
<term
401
 
><function
402
 
>@Array.fromString(<parameter
403
 
>lista</parameter
404
 
>,<parameter
405
 
>texto</parameter
406
 
>)</function
407
 
></term>
408
 
<listitem>
409
 
<para
410
 
>Adiciona todos os elementos do texto na lista. O texto deverá ter o formato <emphasis
411
 
>chave\tvalor\n</emphasis
412
 
>.</para>
413
 
</listitem>
414
 
</varlistentry>
415
 
 
416
 
<varlistentry>
417
 
<term
418
 
><function
419
 
>@Array.toString(<parameter
420
 
>lista</parameter
421
 
>,<parameter
422
 
>texto</parameter
423
 
>)</function
424
 
></term>
425
 
<listitem>
426
 
<para
427
 
>Devolve todos os elementos na lista num formato <emphasis
428
 
>chave\tvalor\n</emphasis
429
 
>.</para>
430
 
</listitem>
431
 
</varlistentry>
432
 
 
433
 
</variablelist>
434
 
</sect2>
435
 
 
436
 
<sect2 id="files">
437
 
<title
438
 
>Grupo de Funções de Ficheiros</title>
439
 
<variablelist>
440
 
 
441
 
<varlistentry>
442
 
<term
443
 
><function
444
 
>@File.read(<parameter
445
 
>ficheiro</parameter
446
 
>)</function
447
 
></term>
448
 
<listitem>
449
 
<para
450
 
>Devolve o conteúdo do ficheiro indicado.</para>
451
 
</listitem>
452
 
</varlistentry>
453
 
 
454
 
<varlistentry>
455
 
<term
456
 
><function
457
 
>@File.write(<parameter
458
 
>ficheiro</parameter
459
 
><parameter
460
 
>texto</parameter
461
 
>)</function
462
 
></term>
463
 
<listitem>
464
 
<para
465
 
>Escreve o texto indicado num ficheiro.</para>
466
 
</listitem>
467
 
</varlistentry>
468
 
 
469
 
<varlistentry>
470
 
<term
471
 
><function
472
 
>@File.append(<parameter
473
 
>ficheiro</parameter
474
 
><parameter
475
 
>texto</parameter
476
 
>)</function
477
 
></term>
478
 
<listitem>
479
 
<para
480
 
>Adiciona o texto indicado ao fim de um ficheiro.</para>
481
 
</listitem>
482
 
</varlistentry>
483
 
 
484
 
</variablelist>
485
 
</sect2>
486
 
 
487
 
<sect2 id="strings">
488
 
<title
489
 
>Grupo de Funções de Cadeias de Caracteres</title>
490
 
<variablelist>
491
 
 
492
 
<varlistentry>
493
 
<term
494
 
><function
495
 
>@String.length(<parameter
496
 
>texto</parameter
497
 
>)</function
498
 
></term>
499
 
<listitem>
500
 
<para
501
 
>Devolve o número de caracteres no texto.</para>
502
 
</listitem>
503
 
</varlistentry>
504
 
 
505
 
<varlistentry>
506
 
<term
507
 
><function
508
 
>@String.contains(<parameter
509
 
>texto</parameter
510
 
>,<parameter
511
 
>sub-texto</parameter
512
 
>)</function
513
 
></term>
514
 
<listitem>
515
 
<para
516
 
>Verifica se o texto contém o sub-texto indicado.</para>
517
 
</listitem>
518
 
</varlistentry>
519
 
 
520
 
<varlistentry>
521
 
<term
522
 
><function
523
 
>@String.find(<parameter
524
 
>texto</parameter
525
 
>)</function
526
 
></term>
527
 
<listitem>
528
 
<para
529
 
>Devlve a posição de um sub-texto no texto ou -1 se não for encontrado.</para>
530
 
<note
531
 
><para
532
 
>Este terá um parâmetro opcional de posição inicial para procurar as próximas instâncias na versão Alpha 6.</para
533
 
></note>
534
 
</listitem>
535
 
</varlistentry>
536
 
 
537
 
<varlistentry>
538
 
<term
539
 
><function
540
 
>@String.left(<parameter
541
 
>texto</parameter
542
 
>, <parameter
543
 
>num</parameter
544
 
>)</function
545
 
></term>
546
 
<listitem>
547
 
<para
548
 
>Devolve os primeiros 'num' caracteres do texto.</para>
549
 
</listitem>
550
 
</varlistentry>
551
 
 
552
 
<varlistentry>
553
 
<term
554
 
><function
555
 
>@String.right(<parameter
556
 
>texto</parameter
557
 
>, <parameter
558
 
>num</parameter
559
 
>)</function
560
 
></term>
561
 
<listitem>
562
 
<para
563
 
>Devolve os últimos 'num' caracteres do texto.</para>
564
 
</listitem>
565
 
</varlistentry>
566
 
 
567
 
<varlistentry>
568
 
<term
569
 
><function
570
 
>@String.mid(<parameter
571
 
>texto</parameter
572
 
>, <parameter
573
 
>inicio</parameter
574
 
>, <parameter
575
 
>fim</parameter
576
 
>)</function
577
 
></term>
578
 
<listitem>
579
 
<para
580
 
>Devolve uma sub-sequência do texto, delimitada pelas posições indicadas.</para>
581
 
</listitem>
582
 
</varlistentry>
583
 
 
584
 
<varlistentry>
585
 
<term
586
 
><function
587
 
>@String.remove(<parameter
588
 
>texto</parameter
589
 
>, <parameter
590
 
>sub-texto</parameter
591
 
>)</function
592
 
></term>
593
 
<listitem>
594
 
<para
595
 
>Remove todas as ocorrências de um dado sub-texto.</para>
596
 
</listitem>
597
 
</varlistentry>
598
 
 
599
 
<varlistentry>
600
 
<term
601
 
><function
602
 
>@String.replace(<parameter
603
 
>texto</parameter
604
 
>, <parameter
605
 
>original</parameter
606
 
>, <parameter
607
 
>substituicao</parameter
608
 
>)</function
609
 
></term>
610
 
<listitem>
611
 
<para
612
 
>Substitui todas as ocorrências de um dado sub-texto por outro de substituição.</para>
613
 
</listitem>
614
 
</varlistentry>
615
 
 
616
 
<varlistentry>
617
 
<term
618
 
><function
619
 
>@String.upper(<parameter
620
 
>texto</parameter
621
 
>)</function
622
 
></term>
623
 
<listitem>
624
 
<para
625
 
>Converte o texto para maiúsculas.</para>
626
 
</listitem>
627
 
</varlistentry>
628
 
 
629
 
<varlistentry>
630
 
<term
631
 
><function
632
 
>@String.lower(<parameter
633
 
>texto</parameter
634
 
>)</function
635
 
></term>
636
 
<listitem>
637
 
<para
638
 
>Converte o texto para minúsculas.</para>
639
 
</listitem>
640
 
</varlistentry>
641
 
 
642
 
<varlistentry>
643
 
<term
644
 
><function
645
 
>@String.compare(<parameter
646
 
>texto1</parameter
647
 
>, <parameter
648
 
>texto2</parameter
649
 
>)</function
650
 
></term>
651
 
<listitem>
652
 
<para
653
 
>Compara dois textos. Devolve 0 se forem iguais, -1 se o primeiro texto for menor ou 1 se o primeiro texto for maior</para>
654
 
</listitem>
655
 
</varlistentry>
656
 
 
657
 
<varlistentry>
658
 
<term
659
 
><function
660
 
>@String.isEmpty(<parameter
661
 
>texto</parameter
662
 
>)</function
663
 
></term>
664
 
<listitem>
665
 
<para
666
 
>Verifica se o texto está em branco.</para>
667
 
</listitem>
668
 
</varlistentry>
669
 
 
670
 
<varlistentry>
671
 
<term
672
 
><function
673
 
>@String.isNumber(<parameter
674
 
>texto</parameter
675
 
>)</function
676
 
></term>
677
 
<listitem>
678
 
<para
679
 
>Verifica se o texto é um número válido.</para>
680
 
</listitem>
681
 
</varlistentry>
682
 
 
683
 
</variablelist>
684
 
</sect2>
685
 
 
686
 
<sect2 id="builtins">
687
 
<title
688
 
>Globais Incorporados</title>
689
 
<para
690
 
>Os globais incorporados são acedidos como se fossem variáveis globais normais com o <function
691
 
>@global</function
692
 
>.</para>
693
 
<variablelist>
694
 
<varlistentry>
695
 
<term
696
 
><function
697
 
>@global(_KDDIR)</function
698
 
></term>
699
 
<listitem>
700
 
<para
701
 
>A directoria onde o diálogo actual se encontra.</para>
702
 
</listitem>
703
 
</varlistentry>
704
 
<varlistentry>
705
 
<term
706
 
><function
707
 
>@global(_NAME)</function
708
 
></term>
709
 
<listitem
710
 
><para
711
 
>O nome do diálogo</para
712
 
></listitem>
713
 
</varlistentry>
714
 
</variablelist>
715
 
</sect2>
716
 
 
717
 
</sect1>