Terminología al inicializar estructuras en C

Question

Esta será una pregunta fácil, pero buscar en Google no parece darme una respuesta. Tal como lo entiendo en C, tenemos dos formas de inicializar un objeto foo, cuando foo es una estructura. Mira el siguiente código para un ejemplo

typedef struct foo 
{ 
    int var1; 
    int var2; 
    char* var3; 
}foo; 

//initializes and allocates a foo 
foo* foo_init1(int v1,int v2,const char* v3) 
{ 
    if(..some checks..) 
     return 0; 
    foo* ret = malloc(sizeof(foo)); 

    ret->var1 = v1; 
    ret->var2 = v2; 
    ret-var3 = malloc(strlen(v3)+1); 
    strcpy(ret->var3,v3); 

    return ret; 
} 

// initializes foo by ... what? How do we call this method of initialization? 
char foo_init2(foo* ret,int v1,int v2, const char* v3) 
{ 
    //do some checks and return false 
    if(...some checks..) 
     return false//;assume you defined true and false in a header file as 1 and 0 respectively 
    ret->var1 = v1; 
    ret->var1 = v1; 
    ret->var2 = v2; 
    ret-var3 = malloc(strlen(v3)+1); 
    strcpy(ret->var3,v3); 

    return true; 
} 

Así que mi pregunta es esta. ¿Cómo nos referimos en C a estos diferentes métodos de inicialización? El primero devuelve un puntero inicializado a foo por lo que es fácil de usar si se desea un objeto foo en el montón así:

foo* f1 = foo_init1(10,20,"hello"); 

Pero la segunda requiere un foo .. qué? Mira el código a continuación.

foo f1; 
foo_init2(&f1,10,20,"hello"); 

Así que el segundo método hace que sea fácil para inicializar un objeto en la pila, pero ¿cómo se llaman? Esta es básicamente mi pregunta, cómo hacer referencia al segundo método de inicialización.

El primero asigna e inicializa un puntero a foo. El segundo inicializa un foo por ... ¿qué? ¿Referencia?

Como una pregunta de bonificación, ¿cómo trabajan ustedes al codificar en C? ¿Determina el uso del objeto que está haciendo y con eso determina si debería tener una función de inicialización de tipo 1, o 2 o incluso ambos?

Answer 1

Dado que ninguna de las personas en los comentarios tomó la oferta para convertir sus comentarios en una respuesta que estoy obligado a responder a mi propia pregunta.

Bueno, básicamente, una respuesta posible sería que, como afirma AI, no existe una convención de nomenclatura específica. Por supuesto método de nomenclatura se utiliza, debe ser:

• Consistente través de todo el proyecto/s para mayor claridad
• reconocible por otros programadores como una función que hace lo que está haciendo en realidad .

Para lograr eso, hubo algunas excelentes recomendaciones en los comentarios.Para cuando un objeto foo es:

• pasó para inicialización dentro de la función: foo_init
• Asignado dentro de la función y un puntero devueltos: foo_alloc, foo_make, foo_new

Todo lo anterior está claro, supongo, pero lo que describe con mayor precisión es lo que está sucediendo en las funciones sería foo_init y foo_alloc.

Personalmente, no me gusta la solución _alloc porque no me gusta cómo se ve en mi código, así que decidí agregar el verbo _create en lugar de alloc después de la función para indicar lo que está haciendo.

Pero bueno, la respuesta se reduce a Supongo que es una preferencia personal. Todo debería estar bien y ser aceptable siempre que la funcionalidad de la función quede clara al leer su nombre.

Answer 2

No estoy seguro de si hay algún bien nomenclatura definida por los dos métodos,
En el primer método la función asigna dinámicamente una estructura y asigna valores a los miembros,
mientras que en segundos la estructura se asigna antes de la función y la función simplemente asigna valores a los miembros.

¿Determina el uso del objeto que está haciendo y determina si debe tener una función de inicialización de tipo 1, o 2 o incluso ambos?

Selección de primer o segundo método depende de una diferencia importante:
se prefiere el primer método cuando se necesita para pasar a la estructura devuelta a través de ámbitos, la memoria en el montón tiene que ser liberado de forma explícita hasta el cual los datos prevalece mientras en el segundo método, los datos en la pila se eliminan una vez que el alcance del objeto pasado termina.