Разделители блоков кода

[Levsha100]

Здравствуйте!
Собственно сабж: как Вы разделяете код?
Приведу пример:

function a();
begin
...
//----------
...
end;
//***************************************
function b();
begin
...
//----------
...
end;

У меня примерно так

[Манжосов Денис :)]

procedure WhatIsIt();
begin

  ShowMessage('What's hapened');

end;

procedure WhoIsIt();
begin

  ShowMessage('Hello');

end;

procedure YesSir();
var
  x: byte;
begin

  x := x + 1; // Inc(x, 1)
  x := x + 2; // Inc(x, 2)
 
end;

У меня чисто пустыми строками разделено всё

[wall66]

PHP код:

<?
########################################
##  блок 1  ############################
########################################
some code ();

########################################
##  блок 2  ############################
########################################
some more code ();
?>

[Sazary]

int a()
{
...
//------
...
}
//========

int b()
{
...
//------
...
}

Чем сильнее отличаются по смыслу блоки, тем длиннее линии.
Могу также двойной сделать.

[Alex Cones]

Я обычно сотворяю нечто такое:

{*******************************************************}
{**************   Загрузка параметров   ****************}
{*******************************************************}

А шо? красиво и убористо.

P.S. Денис, overrited забыл

[JTG]

Полосочками на ширину страницы

//---------------------------------------- STR ----------------------------------------
  else if input_lo = '!str' then
    begin
      Data.Add(prefix + F(0,0,'_____')+'!md5 - return md5-hash');
      Data.Add(prefix + F(0,0,'_____')+'!ebase64 / !dbase64 - base64 encode / decode');
      Data.Add(prefix + F(0,0,'_____')+'!str2hex / !hex2str  - StringToHex / HexToString');
      Data.Add(prefix + F(0,0,'_____')+'!eurl / !durl - encode / decode URL');
      Data.Add(prefix + F(0,0,'_____')+'!engrus / !ruseng - switch layout');
    end
//------------------------------------ LAST TOPICS ------------------------------------
  else if input_lo = '!last' then
    begin
      forceSay := true;
      Data.Clear;
      Data.Add('Одну минутку...');
      if isPrivate then for i:=0 to data.Count-1 do bot.say(nick, data.Strings[i])
      else for i:=0 to data.Count-1 do bot.Say(ChannelName, data.Strings[i]);

      Data.Clear;
      CoInitialize(nil);
      rss.ClearXML;
      rss.LoadFromHTTP('http://programmersforum.ru/external.php?type=RSS2');
      for i:=0 to rss.Items.Count-1 do
      begin
        Data.Add(RSS.Items[i].title+' '+ StringReplace(RSS.Items[i].Link,'&goto=newpost','',[rfReplaceAll,rfIgnoreCase]));
      end;
      CoUninitialize;
    end

[alexinspir]

блоки в пределах метода никак не разделяю, ибо бессмысленно - если код трудно читаем, то он нуждается в рефакторинге, а не разделении на блоки.

вот пример моего кода:

package rmi;

import dbc.DBConnector;
import gui.Activity;
import java.rmi.NotBoundException;
import java.rmi.AlreadyBoundException;
import java.rmi.Remote;
import java.rmi.RemoteException;
import java.rmi.registry.LocateRegistry;
import java.rmi.registry.Registry;
import java.rmi.server.UnicastRemoteObject;
import java.util.logging.Logger;

/**
 * Служит для создания RMI реестра и представления сервиса.
 * Назначение методов ясно из их названия. Использование возможно только после
 * инициализации подключения к базе данных
 * @author Alexander Inspir
 */
public class RMIServer implements ServiceIF{
    
    protected static final Logger _log = Logger.getLogger(RMIServer.class.getName());

    /**
     * Флаг для проверки штатного режима сервера.
     */
    protected volatile boolean binding = false;

    /**
     * RMI Реестр
     */
    protected Registry registry;
    
    /**
     * Экспортируемый объект
     */
    protected RMIServer service;

    /**
     * Имя представляемого сервиса
     */
    protected String rmiName;

    /**
     * Прослушиваемый порт
     */
    protected String rmiPort;

    /**
     * Заглушка
     */
    protected Remote stub;

    /**
     * Конструктор по умолчанию. Служит для создания экспортируемого объекта.
     */
    private RMIServer(){
    }

    /**
     * Основной конструктор. Служит для создания экземпляра сервера.
     * @param rmiName Имя сервиса
     * @param rmiPort Прослушиваемый порт
     */
    public RMIServer(String rmiName, String rmiPort){
        this.rmiName = rmiName;
        this.rmiPort = rmiPort;

    }


    /**
     * Создает RMI реестр и экспортирует сервис.
     * @return true если связывание прошло успешно, false если произошел сбой.
     */
    public boolean bind(){
        try {
            registry = LocateRegistry.createRegistry((new Integer(this.rmiPort)).intValue());
            service = new RMIServer();
            stub = UnicastRemoteObject.exportObject(service, 0);
            registry.bind(this.rmiName, stub);
            binding = true;
        } catch (RemoteException ex) {
            binding = false;
            _log.severe("Bound failed: "+ex.getMessage());
        }catch (AlreadyBoundException ex) {
            binding = false;
            _log.severe("Bound failed: "+ex.getMessage());
        }
        return binding;
    }

    /**
     * Отключает экспортируемый сервис.
     */
    public void unbind(){
        try {
            registry.unbind(rmiName);
            UnicastRemoteObject.unexportObject(service,true);
        } catch (RemoteException ex) {
             System.out.println(ex.getMessage());
            _log.severe("unbind failed: "+ex.getMessage());
        } catch (NotBoundException ex) {
             System.out.println(ex.getMessage());
            _log.severe("unbind failed: "+ex.getMessage());
        }
        try {
            service.finalize();
        } catch (Throwable ex) {
            _log.severe(ex.getMessage());
        }
    }

    /**
     * Возвращает все записи из базы, в виде Object.
     * Если возвращаемое значение является null - роняет сервер.
     * @return вектор в виде  Object либо null если произошел сбой.
     * @throws RemoteException
     */
    public Object selectAll() throws RemoteException {
        Object result = DBConnector.selectAll();
        if(result==null){
            Activity.terminateServer();
        }
        return result;
    }

    /**
     * Возвращает объект, содержащий вектор с результатами поиска по phrase.
     * @param phrase - искомая фраза.
     * @return результат поиска.
     * @throws RemoteException
     */
    public Object search(String phrase) throws RemoteException {
        Object result = DBConnector.search(phrase);
        if(result==null){
            Activity.terminateServer();
        }
        return result;
    }

    /**
     * Вставляет в базу данных текст.
     * @param text - вставляемый текст.
     * @throws RemoteException
     */
    public void insert(String text) throws RemoteException {
        if(!DBConnector.insert(text)){
            Activity.terminateServer();
        }
    }

    /**
     * Возвразает определенную запись из базы.
     * Использовать не рекомендуется.
     * @param id - идентификатор записи
     * @return - (Object)TextBox объект с записью
     * @throws RemoteException
     */
    public Object selectSpecific(int id) throws RemoteException {
        Object result = DBConnector.selectSpecific(id);
        return result;
    }


}

[Izhic]

У меня вот так :
////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////

{********************************** *********************}
{************** Загрузка параметров ****************}
{********************************** *********************}

Хорошо, что такой Вариант в >Delphi 7 работает(вероятно, раз вы так делаете)
т.к. у меня , это было бы так:

{
{********************************** *********************}
{************** Загрузка параметров ****************}
{********************************** *********************}

fwefwefwe //msg:Error
}

Жутко нервирует
Соответственно вообще отдаю предпочтение "//" нежели "{}"
Может есть Вариант исправления этой проблемы...
Заплатка какая нибудь

[SunKnight]

У alexinspir самый правильный, так как он юзает java соглашение о кодировании. Респект alexinspir

[ds.Dante]

В C++ использую 2-3 пустые строки и примерно то что выше.
В C# использую #region для объединения нескольких близких функций.

Сообщение от Izhic

////////////////////////////////////////////////////////////////////////////////////
/////////////////////////////////////////////////////////
////////////////////////////////////////////////////////////////////////////////////

Кстати, это мысль. :)