github.com/hustcat/docker@v1.3.3-0.20160314103604-901c67a8eeab/docs/admin/formatting.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "Format command and log output"
     4  description = "CLI and log output formatting reference"
     5  keywords = ["format, formatting, output, templates, log"]
     6  [menu.main]
     7  parent = "engine_admin"
     8  weight=-90
     9  +++
    10  <![end-metadata]-->
    11  
    12  # Formatting reference
    13  
    14  Docker uses [Go templates](https://golang.org/pkg/text/template/) to allow users manipulate the output format
    15  of certain commands and log drivers. Each command a driver provides a detailed
    16  list of elements they support in their templates:
    17  
    18  - [Docker Images formatting](https://docs.docker.com/engine/reference/commandline/images/#formatting)
    19  - [Docker Inspect formatting](https://docs.docker.com/engine/reference/commandline/inspect/#examples)
    20  - [Docker Log Tag formatting](https://docs.docker.com/engine/admin/logging/log_tags/)
    21  - [Docker Network Inspect formatting](https://docs.docker.com/engine/reference/commandline/network_inspect/)
    22  - [Docker PS formatting](https://docs.docker.com/engine/reference/commandline/ps/#formatting)
    23  - [Docker Volume Inspect formatting](https://docs.docker.com/engine/reference/commandline/volume_inspect/)
    24  - [Docker Version formatting](https://docs.docker.com/engine/reference/commandline/version/#examples)
    25  
    26  ## Template functions
    27  
    28  Docker provides a set of basic functions to manipulate template elements.
    29  This is the complete list of the available functions with examples:
    30  
    31  ### Join
    32  
    33  Join concatenates a list of strings to create a single string.
    34  It puts a separator between each element in the list.
    35  
    36  	$ docker ps --format '{{join .Names " or "}}'
    37  
    38  ### Json
    39  
    40  Json encodes an element as a json string.
    41  
    42  	$ docker inspect --format '{{json .Mounts}}' container
    43  
    44  ### Lower
    45  
    46  Lower turns a string into its lower case representation.
    47  
    48  	$ docker inspect --format "{{lower .Name}}" container
    49  
    50  ### Split
    51  
    52  Split slices a string into a list of strings separated by a separator.
    53  
    54  	# docker inspect --format '{{split (join .Names "/") "/"}}' container
    55  
    56  ### Title
    57  
    58  Title capitalizes a string.
    59  
    60  	$ docker inspect --format "{{title .Name}}" container
    61  
    62  ### Upper
    63  
    64  Upper turms a string into its upper case representation.
    65  
    66  	$ docker inspect --format "{{upper .Name}}" container