GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  GCLOUD_TOPIC_ESCAPING (1)

NAME

gcloud topic escaping - list/dictionary-type argument escaping supplementary help

CONTENTS

DESCRIPTION

List/dictionary-type argument escaping supplementary help.

gcloud supports list-type and dictionary-type flags that take one argument which is a list of one or more comma-separated items:

--list-flag=value1,value2,value3

--dict-flag=key1=value1,key2=value2

In the case of a dict-type flag, each item is a key-value pair separated by '=’. If more than one ’=’ is present, the first is used.

In order to include commas in your arguments, specify an alternate delimiter using the following syntax:

^DELIM^flag value, with comma

where DELIM is a sequence of one or more characters that may not appear in any value in the list.

EXAMPLES

In these examples, a list-type or dictionary-type flag is given, along with a shell comment explaining how it is parsed. The parsed flags are shown here using Python-style list or dict formats (in other languages, what Python calls "dicts" are often called "associative arrays," "maps," or "hashes").

Basic example:

--list-flag=^:^a,b:c,d # => [’a,b’, ’c,d’]

Multi-character delimiters are allowed:

--list-flag=^--^a-,b--c # => [’a-,b’, ’c’]

Just one ’^’ has no special meaning:

--list-flag=^a,b,c # => [’^a’, ’b’, ’c’]

This is an alternative way of starting with ’^’:

--list-flag=^,^^a,b,c # => [’^a’, ’b’, ’c’]

A ’^’ anywhere but the start has no special meaning:

--list-flag=a^:^,b,c # => [’a^:^’, ’b’, ’c’]

Dictionary-type arguments work exactly the same as list-type arguments:

--dict-flag=^:^a=b,c:d=f,g # => {’a: ’b,c’, ’d’: ’f,g’}
Search for    or go to Top of page |  Section 1 |  Main Index


GCLOUD_TOPIC_ESCAPING (1) -->

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.