පයිතන් හි බහු අදහස් දැක්වීමට ක්‍රමයක් තිබේද?

මම මෑතකදී පයිතන් හැදෑරීම ආරම්භ කළ නමුත් බහු රේඛා අදහස් ක්‍රියාත්මක කරන්නේ කෙසේදැයි මට සොයාගත නොහැකි විය. බොහෝ භාෂාවන්ට බ්ලොක් විවරණ සංකේත වැනි ඇත

/*

*/

මම මෙය පයිතන්හිදී උත්සාහ කළෙමි, නමුත් එය දෝෂයක් ඇති කරයි, එබැවින් මෙය නිවැරදි ක්‍රමය නොවේ. පයිතන්ට ඇත්ත වශයෙන්ම බහු විවරණ විශේෂාංගයක් තිබේද?

ඔබට ත්‍රිත්ව උපුටා ගත් නූල් භාවිතා කළ හැකිය. ඔවුන් ලේඛ ලේඛනයක් නොවන විට (පන්තියේ / ශ්‍රිතයක / මොඩියුලයක පළමු දෙය), ඒවා නොසලකා හරිනු ලැබේ.

'''
This is a multiline
comment.
'''

( '''වළක්වා ගැනීම සඳහා ප්‍රමුඛයා සුදුසු පරිදි ඇතුල් කිරීමට වග බලා ගන්න IndentationError.)

ගයිඩෝ වැන් රොසුම් (පයිතන්හි නිර්මාතෘ) මෙය ට්වීට් කළේ “ගැති ඉඟියක්” ලෙස ය.

කෙසේ වෙතත්, පයිතන්ගේ විලාසිතාවේ මාර්ගෝපදේශය වන පීඊපී 8, අඛණ්ඩව තනි රේඛා අදහස් දැක්වීමට කැමැත්තක් දක්වන අතර බොහෝ ව්‍යාපෘති වලදී ඔබ සොයා ගන්නේ මෙයයි. පෙළ සංස්කාරකවරුන්ට මෙය පහසුවෙන් කිරීමට කෙටිමඟක් ඇත.

පයිතන්ට බහු රේඛා / විවරණ වාක්‍ය ඛණ්ඩයක් ඇත, එනම් ඩොක්ස්ට්‍රිං ලෙස භාවිතා නොකරන්නේ නම්, බහුවිධ නූල් කිසිදු බයිට් කේතයක් ජනනය නොකරයි - පෙර #සූදානම් කළ අදහස් මෙන් . ඇත්ත වශයෙන්ම, එය හරියටම විවරණයක් මෙන් ක්‍රියා කරයි.

අනෙක් අතට, මෙම හැසිරීම සත්‍ය අදහස් දැක්වීමේ වාක්‍ය ඛණ්ඩයක් ලෙස නිල ලේඛනයේ ලේඛනගත කළ යුතු යැයි ඔබ කියන්නේ නම්, ඔව්, එය භාෂා පිරිවිතරයේ කොටසක් ලෙස සහතික නොවන බව පැවසීම නිවැරදිය.

ඕනෑම අවස්ථාවක, ඔබේ පෙළ සංස්කාරකවරයාට තෝරාගත් කලාපයක් පහසුවෙන් අදහස් දැක්වීමට හැකි විය යුතුය ( #එක් එක් පේළිය ඉදිරිපිට තනි තනිව තැබීමෙන් ). එසේ නොවේ නම්, එසේ කරන පෙළ සංස්කාරකයකට මාරු වන්න.

ඇතැම් පෙළ සංස්කරණ අංග නොමැතිව පයිතන් හි වැඩසටහන්කරණය වේදනාකාරී අත්දැකීමක් විය හැකිය. නිවැරදි සංස්කාරකය සොයා ගැනීම (සහ එය භාවිතා කරන්නේ කෙසේදැයි දැන ගැනීම) පයිතන් ක්‍රමලේඛන අත්දැකීම වටහා ගන්නා ආකාරයෙහි විශාල වෙනසක් කළ හැකිය.

තෝරාගත් ප්‍රදේශ වලට අදහස් දැක්වීමට පෙළ සංස්කාරකවරයාට හැකි වූවා පමණක් නොව, කේත කොටස් වමට සහ දකුණට පහසුවෙන් මාරු කළ හැකි අතර, ඔබ එබූ විට එය කර්සරය වත්මන් ඉන්ඩෙන්ටේෂන් මට්ටමින් ස්වයංක්‍රීයව තැබිය යුතුය Enter. කේත නැවීම ද ප්‍රයෝජනවත් වේ.

සම්බන්ධක ක්ෂය වීමෙන් ආරක්ෂා වීම සඳහා, ගයිඩෝ වැන් රොසුම්ගේ ට්වීට් එකේ අන්තර්ගතය මෙන්න :

@BSUCSClub පයිතන් ඉඟිය: ඔබට බහු රේඛා නූල් බහු රේඛා අදහස් ලෙස භාවිතා කළ හැකිය. ඩොක්ස්ට්‍රිං ලෙස භාවිතා නොකරන්නේ නම්, ඒවා කේතයක් ජනනය නොකරයි! :-)

පිළිගත් පිළිතුරෙන් ...

ඔබට ත්‍රිත්ව උපුටා ගත් නූල් භාවිතා කළ හැකිය. ඔවුන් ලේඛ ලේඛනයක් නොවන විට (පන්තියේ / ශ්‍රිතයක / මොඩියුලයක පළමු දෙය), ඒවා නොසලකා හරිනු ලැබේ.

මෙය සරලවම සත්‍ය නොවේ. අදහස් මෙන් නොව, ත්‍රිත්ව-උපුටා ගත් නූල් තවමත් විග්‍රහ කර ඇති අතර ඒවා ප්‍රභව කේතයේ කොතැනක දිස් වුවද ඒවා කෘතිමව වලංගු විය යුතුය.

ඔබ මෙම කේතය ක්‍රියාත්මක කිරීමට උත්සාහ කරන්නේ නම් ...

def parse_token(token):
    """
    This function parses a token.
    TODO: write a decent docstring :-)
    """

    if token == '\\and':
        do_something()

    elif token == '\\or':
        do_something_else()

    elif token == '\\xor':
        '''
        Note that we still need to provide support for the deprecated
        token \xor. Hopefully we can drop support in libfoo 2.0.
        '''
        do_a_different_thing()

    else:
        raise ValueError

ඔබටත් ලැබෙනු ඇත ...

ValueError: invalid \x escape

... පයිතන් 2.x හෝ ...

SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes in position 79-80: truncated \xXX escape

... පයිතන් 3.x හි.

විග්‍රහකයා විසින් නොසලකා හරින බහු-පේළි අදහස් දැක්වීමට ඇති එකම ක්‍රමය ...

elif token == '\\xor':
    # Note that we still need to provide support for the deprecated
    # token \xor. Hopefully we can drop support in libfoo 2.0.
    do_a_different_thing()

පයිතන් 2.7 හි බහු විවරණය:

"""
This is a
multilline comment
"""

ඔබ පංතියක් තුළ සිටී නම් එය නිසි ලෙස පටිගත කළ යුතුය.

උදාහරණයක් වශයෙන්:

class weather2():
   """
   def getStatus_code(self, url):
       world.url = url
       result = requests.get(url)
       return result.status_code
   """

AFAIK, පයිතන්ට අවහිර අදහස් නොමැත. තනි රේඛා අදහස් දැක්වීම සඳහා, ඔබට #චරිතය භාවිතා කළ හැකිය .

ඔබ Notepad ++ භාවිතා කරන්නේ නම් , බ්ලොක් අදහස් දැක්වීම සඳහා කෙටිමඟක් ඇත . GVim සහ Emacs වැනි අනෙක් ඒවාට සමාන ලක්ෂණ ඇති බව මට විශ්වාසයි .

මම හිතන්නේ බහු රේඛාවක් සැකසීම හැර, එසේ නොවේ. කෙසේ වෙතත්, බොහෝමයක් නොවේ නම්, සියලුම පයිතන් IDE වලට කේත පේළි කිහිපයක් 'අදහස් දැක්වීම' සඳහා කෙටිමං ඇත.

ඔබ අදහස් දැක්වීමක් කළහොත්

"""
long comment here
"""

පිටපතක් මධ්‍යයේ, පයිතන් / ලින්ටර් එය හඳුනා නොගනී. ඉහත අදහස සම්මත නිර්දේශවල කොටසක් නොවන බැවින්, නැවීම අවුල් වනු ඇත. භාවිතා කිරීම වඩා හොඳය

# Long comment
# here.

ඔබ Vim භාවිතා කරන්නේ නම් , එබීමෙන් දිගු අදහස් දැක්වීම් ස්වයංක්‍රීයව අදහස් දැක්වීමට ඔබට commentary.vim වැනි ප්ලගීන කළ හැකිය Vjgcc. එහිදී Vjකේත පේළි දෙකක් තෝරාගෙන gccඒවා අදහස් දක්වන්න.

ඉහත වැනි ප්ලගීන භාවිතා කිරීමට ඔබට අවශ්‍ය නැතිනම් ඔබට සෙවුම් භාවිතා කර ප්‍රතිස්ථාපනය කළ හැකිය

:.,.+1s/^/# /g

මෙය වත්මන් සහ ඊළඟ පේළියේ පළමු අක්‍ෂරය ප්‍රතිස්ථාපනය කරයි #.

බහු රේඛා විවරණයක් වැනි එවැනි අංගයක් නොමැත. #කේත පේළියක් අදහස් දැක්වීමට ඇති එකම ක්‍රමයයි. ඔබගෙන් බොහෝ දෙනෙක් ඔවුන්ගේ විසඳුම ලෙස අදහස් දැක්වීමකට පිළිතුරු දුන්හ.

එය ක්‍රියාත්මක වන බව පෙනේ, නමුත් අභ්‍යන්තරව '''පයිතන්හි ඇති රේඛා සාමාන්‍ය නූල් ලෙස කොටා ඇති අතර එය අදහස් දැක්වීම වැනි පරිවර්ථකයා නොසලකා හරිනු #ඇත.

නිල ලියකියවිලි මෙතැනින් බලන්න

අවාසනාවට අදහස් දැක්වීම සඳහා සෑම විටම භාවිතා කළ නොහැක ! එබැවින් එක් එක් පේළිය a සමඟ පෙර සැකසීමට සම්මතයට ඇලී සිටීම ආරක්ෂිත වේ #.

මෙන්න උදාහරණයක්:

test1 = [1, 2, 3, 4,]       # test1 contains 4 integers

test2 = [1, 2, '''3, 4,'''] # test2 contains 2 integers **and the string** '3, 4,'

හොඳයි, ඔබට මෙය උත්සාහ කළ හැකිය (උපුටා දැක්වීම ක්‍රියාත්මක කරන විට, පළමු ප්‍රශ්නයට ආදානය උපුටා දැක්විය යුතුය '):

"""
print("What's your name? ")
myName = input()
print("It's nice to meet you " + myName)
print("Number of characters is ")
print(len(myName))
age = input("What's your age? ")
print("You will be " + str(int(age)+1) + " next year.")

"""
a = input()
print(a)
print(a*5)

අතර ඇති ඕනෑම දෙයක් """ අදහස් දක්වනු ඇත.

ඔබ තනි පේළි අදහස් සොයන්නේ නම් එය එසේ ය #.

දෘශ්‍ය ස්ටුඩියෝ කේතය විශ්ව නිල බහු-රේඛා අදහස් ටොගල කරන්න.

macOS: කේත-වාරණය තෝරන්න, පසුව ⌘+/

වින්ඩෝස්: කේත-වාරණය තෝරන්න, පසුව Ctrl+/

පයිතන් හි බහු විවරණය:

මට නම් "" "සහ" "" දෙකම වැඩ කළා.

උදාහරණයක්:

a = 10
b = 20
c = a+b
'''
print ('hello')
'''
print ('Addition is: ', a+b)

උදාහරණයක්:

a = 10
b = 20
c = a+b
"""
print('hello')
"""
print('Addition is: ', a+b)

පයිතන්හි පේළිගත අදහස් ආරම්භ වන්නේ හැෂ් අක්ෂරයකින් ය.

hello = "Hello!" # This is an inline comment
print(hello)

හෙලෝ!

වචන මාලාවක් තුළ ඇති හැෂ් අක්ෂරයක් හෑෂ් අක්ෂරයක් පමණක් බව සලකන්න.

dial = "Dial #100 to make an emergency call."
print(dial)

හදිසි ඇමතුමක් ලබා ගැනීමට # 100 අමතන්න.

තනි හෝ බහු පේළි අදහස් සඳහා හැෂ් අක්ෂරයක් භාවිතා කළ හැකිය.

hello = "Hello"
world = "World"
# First print hello
# And print world
print(hello)
print(world)

හෙලෝ

ලෝක

ඩොක්ස්ට්‍රිං සඳහා සහය දැක්වීම සඳහා ත්‍රිත්ව ද්විත්ව උපුටා දැක්වීම් සමඟ පෙළ ඇතුළත් කරන්න.

def say_hello(name):
    """
    This is docstring comment and
    it's support multi line.
    :param name it's your name
    :type name str
    """
    return "Hello " + name + '!'


print(say_hello("John"))

හෙලෝ ජෝන්!

වාරණ අදහස් සඳහා ත්‍රිත්ව තනි උපුටා දැක්වීම් සමඟ පෙළ ඇතුළත් කරන්න.

'''
I don't care the parameters and
docstrings here.
'''

පයිතන් 2.7.13:

තනි:

"A sample single line comment "

මල්ටිලයින්:

"""
A sample
multiline comment
on PyCharm
"""

ඔව්, දෙකම භාවිතා කිරීම හොඳයි:

'''
Comments
'''

සහ

"""
Comments
"""

නමුත්, IDE එකක ධාවනය වන විට ඔබ සැවොම මතක තබා ගත යුතු එකම දෙය නම්, ඔබ සම්පූර්ණ ගොනුව බහු පේළි කේත ලෙස පිළිගැනීමට 'ධාවනය' කිරීමයි. 'RUN' පේළිය නිසියාකාරව ක්‍රියා නොකරන අතර දෝෂයක් පෙන්වයි.

භාවිතා කිරීමට එරෙහිව මම උපදෙස් දෙමි """බහු පේළි අදහස් දැක්වීමට !

අනපේක්ෂිත හැසිරීමක් ලෙස සැලකිය හැකි දේ ඉස්මතු කිරීමට සරල උදාහරණයක් මෙන්න:

print('{}\n{}'.format(
    'I am a string',
    """
    Some people consider me a
    multi-line comment, but
    """
    'clearly I am also a string'
    )
)

දැන් ප්‍රතිදානය දෙස බලන්න:

I am a string

    Some people consider me a
    multi-line comment, but
    clearly I am also a string

බහු රේඛා නූල විවරණයක් ලෙස නොසැලකූ නමුත් එය සමගාමී විය 'clearly I'm also a string' තනි නූලක් සෑදීමට විය.

ඔබට පේළි කිහිපයක් අදහස් දැක්වීමට අවශ්‍ය නම් PEP 8 මාර්ගෝපදේශ අනුව එසේ කරන්න :

print('{}\n{}'.format(
    'I am a string',
    # Some people consider me a
    # multi-line comment, but
    'clearly I am also a string'
    )
)

ප්‍රතිදානය:

I am a string
clearly I am also a string

පයිතන් හි කේත පේළි කිහිපයක් #අදහස් දැක්වීම සඳහා සෑම පේළියකම තනි පේළි විවරණයක් භාවිතා කිරීම :

# This is comment 1
# This is comment 2 
# This is comment 3

පයිතන්හි “නිසි” බහු-රේඛා අදහස් ලිවීම සඳහා """සින්ටැක්ස් සමඟ බහු රේඛා නූල් භාවිතා කිරීම පයිතන්ට ප්‍රලේඛන නූල් (හෝ ඩොක්ස්ට්‍රිං) අංගයක් ඇත. සෑම පයිතන් මොඩියුලයක්, ක්‍රියාකාරීත්වයක්, පන්තියක් සහ ක්‍රමයක් සමඟ ඉක්මන් සටහන් එකතු කිරීමට ක්‍රමලේඛකයන්ට එය පහසු ක්‍රමයක් ලබා දෙයි.

'''
This is
multiline
comment
'''

මේ වගේ පන්ති වස්තුවකින් ඔබට docstring වෙත පිවිසිය හැකි බව සඳහන් කරන්න

myobj.__doc__

ඔබට පහත සඳහන් දෑ භාවිතා කළ හැකිය. මෙය DockString ලෙස හැඳින්වේ.

def my_function(arg1):
    """
    Summary line.
    Extended description of function.
    Parameters:
    arg1 (int): Description of arg1
    Returns:
    int: Description of return value
    """
    return arg1

print my_function.__doc__

PyCharm IDE භාවිතා කිරීම.

ඔබට හැකි commentසහ uncommentභාවිතා කේත පේළි Ctrl + /. Ctrl + / වර්තමාන රේඛාව හෝ තනි පේළි අදහස් සහිත තෝරාගත් රේඛා කිහිපයක් අදහස් දැක්වීම හෝ නොගැලපීම ({# in Django templates, or # in Python scripts). Pressing Ctrl+Shift+/ජැන්ගෝ අච්චුවක තෝරාගත් මූලාශ්‍ර කේතයක් {% comment %} and {% endcomment %}ටැග් සමඟ බ්ලොක් වටා ඇත .

---

n = 5
while n > 0:
    n -= 1
    if n == 2:
        break
    print(n)

print("Loop ended.")

සියලුම පේළි තෝරා ඉන්පසු ඔබන්න Ctrl + /

# n = 5
# while n > 0:
#     n -= 1
#     if n == 2:
#         break
#     print(n)

# print("Loop ended.")

බහු විවරණයක් ඇත්ත වශයෙන්ම පයිතන්හි නොපවතී. පහත උදාහරණයෙන් නියම කර නොමැති නූලකින් සමන්විත වන අතර එය පයිතන් විසින් සින්ටැක්ටිකල් දෝෂ සඳහා වලංගු කරනු ලැබේ.

නොට්පෑඩ් ++ වැනි පෙළ සංස්කාරකවරුන් කිහිප දෙනෙක් අපට ලිඛිත කේතයක් හෝ වචන ප්‍රකාශ කිරීමට කෙටිමං සපයයි.

def foo():
    "This is a doc string."
    # A single line comment
    """
       This
       is a multiline
       comment/String
    """
    """
    print "This is a sample foo function"
    print "This function has no arguments"
    """
    return True

එසේම, Ctrl+ Kවාරණ අදහස් වලට කියන්නෙ ++ වල, කෙටි මාර්ග වේ. එය #තේරීම යටතේ සෑම පේළියකටම ඉදිරියෙන් එක් කරයි . Ctrl+ Shift+ Kඅවහිර කිරීම සඳහා වේ.

වෙනත් පිළිතුරු අතර, පහසුම ක්‍රමය වන්නේ පයිතන් අදහස් දැක්වීමේ සහාය භාවිතා කරන IDE විවරණ ශ්‍රිත භාවිතා කිරීමයි # .

මම භාවිතා කරන්නේ ඇනකොන්ඩා ස්පයිඩර් සහ එහි ඇත්තේ:

• Ctrl+ 1- අදහස් දැක්වීම / නොගැලපීම
• Ctrl+ 4- කේත වාරණයක් අදහස් දක්වන්න
• Ctrl+ 5- කේත වාරණයක් ඉවත් කරන්න

එය එක් / බහු පේළියක් / කේතයක් සමඟ අදහස් දැක්වීම / ඉවත් කිරීම සිදු කරයි #.

මට එය පහසුම බව පෙනේ.

උදාහරණයක් ලෙස, වාරණ සටහනක්:

# =============================================================================
#     Sample Commented code in spyder
#  Hello, World!
# =============================================================================

ඔබට අදහස් දැක්වීමට අවශ්‍ය රේඛා තෝරන්න, පසුව උත්තරීතර පෙළ සංස්කාරකයේ පයිතන් කේතය අදහස් දැක්වීමට හෝ ඉවත් කිරීමට Ctrl+ භාවිතා කරන්න .?

තනි පේළියක් සඳහා ඔබට Shift+ භාවිතා කළ හැකිය #.