What do the elements of ".listMaps" mean ?

Question

I'm new to Python. Could someone help me ?

The following text was taken from the ArcGIS Pro help page.
What do the contents of the () and [] in the second line of the code mean ?

This sample demonstrates how to reference a layer's label classes using ArcGIS Pro.

p = arcpy.mp.ArcGISProject("CURRENT")
m = p.listMaps("Yosemite National Park")[0]
for lyr in m.listLayers():
if lyr.supports("SHOWLABELS"):
       lblClasses = lyr.listLabelClasses()

EdMorris · Answer

Hi Rema

Have a look at @MErikReedAugusta reply. It is a good answer to your question.

Have fun! - ed

MErikReedAugusta · Answer

There are several ways you could determine the index, but the first question is: "What purpose will that index solve?"

If you just want the index of every layer, as you pass it in the loop:

p = arcpy.mp.ArcGISProject("CURRENT")
m = p.listMaps("Yosemite National Park")[0]
layer_index = 0
for lyr in m.listLayers():
    print(layer_index)
    if lyr.supports("SHOWLABELS"):
       lblClasses = lyr.listLabelClasses()
    layer_index += 1

Line 3 is the counter we're going to use to track what index we're on as we loop.  Line 5 could easily be replaced with whatever code you needed the index for.

Once we're done with that layer in the loop, though, we need to make sure to keep our counter updated, which is what Line 8 does.  I updated it at the end of the loop because we're talking about an index, and in Python indexes are almost always 0-based, like the list that Dan was talking about up above.  You can update counters anywhere you like, but if you update them too early, you'll start getting 1-based indexes, and some things might break, unless they're expecting that.

------

But for most things, you probably don't actually need the index.  Take a look at the original code:

p = arcpy.mp.ArcGISProject("CURRENT")
m = p.listMaps("Yosemite National Park")[0]
for lyr in m.listLayers():
    if lyr.supports("SHOWLABELS"):
       lblClasses = lyr.listLabelClasses()

Lines 4 and 5 do a thing on the layer as it passes it in the loop, without needing to know what index it is.  When you do a for loop on that list of layers, each round of the loop is the layer, so you can probably do whatever you need to do with that variable, "lyr".

Rema · Answer

Thanks for your reply, EdM.
I got what the arguments means now. But, if the map which I found by ".listMaps()" had several layers, how can I know each layer's index?